Debugging an agent

Hitachi iQ Studio User Guide
Version
1.0.x
Audience
anonymous
Part Number
MK-26HIQS001-00
ft:lastEdition
2026-03-31

Debugging an agent helps you find and fix issues with its responses or tool use so it works as expected.

Make sure you have Administrator or Agent Builder permission.
  1. From the main menu, select AI Agents, and then select the agent you want to debug.


  2. Click Chat to open the chat interface.
  3. Select the Debug Mode toggle to turn on.


  4. Verify that debug mode is enabled by checking the Debug mode indicator at the top of the chat pane.
  5. Enter a question or prompt in the chat input field.
  6. Click Send.
  7. Review the model’s response. The system displays the final answer and all underlying debug information.
  8. Scroll down in the chat pane to the Agent thoughts section. With debug mode enabled, this section expands to show the complete LLM payload.


  9. Select the expand arrow next to the payload section to view the full details.
    • System prompt
    • User prompt
    • Tool outputs
    • Context passed to the model
    • Raw model output before post‑processing
  10. Review each block to understand how the model interpreted and processed the query.