Respan
Give the Sazabi agent the Respan CLI (respan) in its sandbox to manage LLM observability including traces, prompts, evaluators, experiments, datasets, and coding-agent tracing.
About
This CLI connection makes the Respan CLI (respan) available in the Sazabi agent's sandbox. The agent can use it for LLM observability — traces, prompts, evaluators, experiments, datasets, and coding-agent tracing. The tool is baked into the sandbox image; connecting it authenticates (or configures the connection for) the already-installed CLI.
Prerequisites
- A Sazabi project.
- A Respan API key (
RESPAN_API_KEY). Optionally, a custom Respan base URL (RESPAN_BASE_URL) if you are using a self-hosted or regional Respan instance.
Set up in the dashboard
Configure the sandbox in the dashboard under Settings > Sandbox CLIs.
Find Respan in the catalog
In Settings > Sandbox CLIs, find Respan under Browse sandbox CLIs and choose to connect it.
Provide credentials
Enter the required value: RESPAN_API_KEY (your Respan API key). Optionally, enter RESPAN_BASE_URL if you are pointing the CLI at a non-default Respan instance. Save to store them securely; Sazabi injects them into the sandbox when the agent runs.
Set up with the CLI
You can also configure the Respan CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).
sazabi sandbox-clis set --type respan --env RESPAN_API_KEY=<your-respan-key>To validate the credentials without saving, run the same command with test in place of set (the test command also requires the --env flags).
Verify
Ask the agent, in a thread, to run the respan CLI (a read-only or status command) and confirm it returns real output. If the command is not found, the CLI connection may not be enabled; if it runs unauthenticated or cannot connect, recheck the credentials.
Troubleshooting
Command not found — Confirm the Respan CLI connection is enabled for the project under Settings > Sandbox CLIs.
Authentication or connection fails — Recheck the credential/connection values under Settings > Sandbox CLIs.