AIP
Debug an Agent
Test saved configurations, conversation continuity, and tool results.
Start debugging
Save the Agent and open debugging from its detail page, or open the debug page and choose an Agent in the current Profile.
- Create a debug session.
- Send a message that tests its main responsibility.
- Inspect replies and raw events.
- Ask a follow-up to check context retention.
Debugging actually executes configured tools. For tools that write business data, use test objects you are authorized to modify.
Check results
| Check | Example |
|---|---|
| Complete input | Ask for a missing order number instead of inventing one |
| Source use | Retrieve from the right knowledge base and acknowledge missing information |
| Tool calls | Send correct parameters and report authentication errors clearly |
| Output format | Follow the system prompt's format |
| Conversation continuity | Keep follow-ups within the current session |
Stop and reconnect
Use Stop to interrupt execution. Disconnecting the event stream or closing the page does not stop the run.
After disconnection, reconnect from the last read event position. Debug session state is held in the current page; record session identifiers and errors before leaving if needed for investigation.
Common issues
If changes are missing, confirm you saved and selected the correct Agent. If calls are rejected, check its enabled state. For tool authentication failures, check secrets and bindings. For missing sources, verify indexing and selection in the Agent configuration.