AgentOps Observability for AI Agents
You cannot operate an agent you cannot explain.
That is the simplest version of AgentOps.
The model output is not enough. A production agent run includes prompts, model routes, tools, retrieved context, approvals, retries, costs, failures, and human edits. If you only log the final answer, you are flying blind.
What you need to see#
A useful agent trace should show:
- The trigger.
- The user or workspace.
- The selected workflow.
- The Skill versions.
- The model route.
- Every tool call.
- Every resource read.
- Approval decisions.
- Guardrail results.
- Cost by step.
- Latency by step.
- Human corrections.
- Final output.
That is the story of the run.
Tool calls are the center#
Most bad agent behavior shows up around tool use:
- It skipped the obvious tool.
- It used the wrong customer account.
- It retried too many times.
- It called an expensive model for a simple extraction.
- It found evidence but did not cite it.
- It asked for write access too early.
Trace tool behavior first. The rest gets much easier.
Cost needs workflow context#
Agent cost is not one number.
Track cost by:
- Model.
- Step.
- Tool.
- Workflow.
- Customer.
- Retry.
- Failed run.
The expensive part might not be the model. It might be browser automation, vector search, long context, retries, or a bad route that sends every task to the strongest model.
Human corrections are gold#
Every edit teaches you what the workflow is missing.
Split corrections into categories:
- Wrong fact.
- Missing source.
- Wrong tone.
- Unsafe action.
- Bad routing.
- Too vague.
- Too long.
- Bad next step.
This turns human review from a bottleneck into feedback.
What to alert on#
Do not alert on every weird answer.
Alert on operational risk:
- Tool failure spike.
- Approval bypass attempt.
- Cost spike per run.
- Unsafe action blocked.
- Missing citation rate.
- Human rejection rate rising.
- Latency past user expectation.
- New prompt injection pattern.
AgentOps is not a dashboard decoration. It is how you keep trust from quietly eroding.
Build it in Codelit#
Try this:
Design AgentOps observability for a production AI agent. Include traces, tool calls, model routes, cost by step, latency, approvals, eval results, audit logs, human corrections, and alerting.
If the agent is part of the business, its trace is part of the product.
Try these templates
Continue learning
Go deeper on AI agents and LLM systems
As an Amazon Associate I earn from qualifying purchases. Codelit may receive a commission at no extra cost to you.
AI Engineering
Chip Huyen · 2025
Book-length treatment of evals, prompts and deployment tradeoffs for foundation-model apps.
Agentic Design Patterns
Antonio Gulli · 2025
21 agent patterns with runnable code, so you can name the shape before you build it.
AI Agents in Action, Second Edition
Micheal Lanham · 2026
Working code for agent memory, tools, MCP and A2A, in the July 2026 second edition.
4.8 (29)Kindle editionChaos Engineering
Casey Rosenthal, Nora Jones · 2020
Netflix, Slack, Google and LinkedIn describe the experiments they ran and what actually broke.
4.4 (197)