Convex Agents Debugging

Debug Convex Agents by exposing raw LLM requests and responses to inspect alignment issues. Capturing these inputs and outputs provides the visibility needed to quickly understand and correct why the generated agent outputs are incorrect.

Missing context occurs when the agent does not receive the correct data at a specific step. Inspect the context the agent sees at each step to diagnose missing or incorrect data and verify proper message ordering across threads.

Auditing tool calls requires tracking tool invocations and results to verify correct orchestration. You can trace the flow of messages and tool calls across threads and the database to ensure proper agent execution.

Inspect the database state of Convex Agents by examining relevant agent tables and messages. Exposing this internal state during development allows you to trace data flow and audit context across threads.

Yes, you can log raw LLM requests and responses by running the debugging scenario with your local Convex Agent setup. Enabling raw logging allows you to observe the flow of messages and context during development.