Help Center / Understand and Improve Agents

Troubleshooting

Read an Agent Trace

Use traces, the step-by-step run logs, to find tool calls, failures, and ways to improve an agent.

3 min read
On This PageOpen the Trace
  1. Open the Trace
  2. Improve the Agent

Open the Trace

From an agent conversation or execution, open the trace view. A trace is the step-by-step run log; its timeline shows the request, reasoning milestones, tool calls, and final output.

Scan for missing inputs, failed tool calls, or places where the agent guessed instead of asking a clarifying question.

Improve the Agent

Update the agent instructions when the trace reveals a repeatable gap. Prefer one clear rule over a long rewrite.

Run the same task again so you can compare the before and after behavior.

Was this helpful?

Your feedback helps us rank and improve Help Center articles.