Skip to main content

Common checks

Recording is unavailable

Install the CLI and sign in with sovara login; the SDK records to that server. On a headless host, set base_url and configure api_key or SOVARA_API_KEY; see the API reference. An unreachable server may let your agent continue without recording. Check the trace ID before logging:
Explicit calls such as log() raise RecordingError when the server fails. Catch it where the agent must keep running. See Errors.

Missing custom steps

Call sovara.auto_instrument() before creating provider clients and tools. Framework tools need their integration, for example sovara_openai_agents.instrument() with the supported openai-agents>=0.13.6,<0.14 version installed by the integration. Add @trace only to operations that are not already recorded:

Inspect what was recorded

Use step references shown by probe.

Traces and turns

Keep agent work inside trace() and await tasks and streams before leaving it. Use with_context() when passing work to another thread. Declare conversation turns with turn(); they are not created automatically. Do not nest turns in the same trace or use a different client inside it. See the usage guide.