Convex Agents Debugging

What problem does it solve?

Debug Convex agents by logging LLM interactions, context, and database state to understand behavior and fix issues quickly.

Core Features & Use Cases

• Log Raw LLM Requests and Responses to inspect inputs and outputs for each agent interaction.
• Log Context Messages to see exactly what context the LLM receives and in what order.
• Inspect Database Tables to query messages, threads, and tool calls for diagnosis.
• Fetch Context Manually to simulate and verify what the agent would contextually see.
• Trace Tool Calls to monitor external utilities invoked by the agent.
• Analyze Message Structure to assess ordering, roles, and content metadata.
• Debug tooling patterns to reproduce and diagnose errors in playgrounds or production-like setups.

Quick Start

Run the debugging setup in your Convex-enabled project and hook into the agent components to start logging requests, context, and database state for analysis.