Documentation / Guides

Troubleshoot agent behavior

Diagnose a real call and fix the agent with the AI Assistant.

Last updated:

When an agent misbehaves on a call, you do not have to guess. The AI Assistant reads a real call and tells you what went wrong.

Use the AI Assistant#

Open the agent's configuration and click AI ASSISTANT (top-right of the System prompt). You get two modes:

  • Identify issue: pick a recent call (or let it use the most recent). The assistant reads the call's transcript and a per-turn timeline (what the caller said, when the agent decided to reply, tool calls, timing) and states a plain-language diagnosis: is it a prompt problem, a configuration problem, or a tuning problem?
  • Update prompt: describe the change you want and the assistant proposes edits.

Each suggestion has a checkbox. Applying it drops the fix into your draft: a prompt suggestion is appended to the system prompt, a setting change flips the right control. Nothing is saved automatically: review, Save, then Deploy.

Other signals#

  • Calls tab: read the transcript of any call to see exactly what was said.
  • Behavior & timing: the knobs the assistant tunes (interruptions, turn detection, silence, durations) are all editable by hand too. See the Behavior & timing guide.

The console

These pages are read only. The test call, the API keys and the live API reference are in the console, where your account is signed in.

Open the console