AuraOne / Docs / Agent Studio Open / Help
Troubleshooting
Connection failures and malformed manifests. Sidecar issues, OTLP errors, and replay nondeterminism.
At a glance
Agent Studio Open guide
- Entry
- Troubleshooting
- Reading
- 10 min
- Sections
- 1
- Applies to
- Applies to the current Agent Studio Open source release. Check the product page and repository for the latest version, supported platforms, and installation details.
01
Fast checks
Most failures come from a server process that exits early or a missing environment variable. The rest come from malformed JSON-RPC responses, blocked remote headers, or provider-key configuration.
- Connection failed: retry with server logs visible and verify cwd/env.
- Tool call failed: copy the raw JSON-RPC request and validate schema fields.
- Model API failed: open Settings, Models and run provider smoke check.
- Replay nondeterminism: lock mocked tool outputs and provider model version.
- OTLP malformed: confirm JSON vs proto endpoint and content type.
- SQLite write failed: check disk space and trace-store location permissions.
- Python sidecar unhealthy: rebuild the venv from Settings, Advanced.