Langfuse
Give the Sazabi agent the Langfuse CLI (langfuse) in its sandbox to inspect LLM-observability data including traces, prompts, datasets, and scores.
About
This CLI connection makes the Langfuse CLI (langfuse) available in the Sazabi agent's sandbox. The agent can use it to inspect LLM-observability data: traces, prompts, datasets, and scores. The tool is baked into the sandbox image; connecting it authenticates the already-installed CLI.
Prerequisites
- A Sazabi project.
- A Langfuse public key (
LANGFUSE_PUBLIC_KEY) and secret key (LANGFUSE_SECRET_KEY), available from your Langfuse project settings. - Optionally, the URL of a self-hosted Langfuse instance (
LANGFUSE_HOST). Omit this when using Langfuse Cloud.
Set up in the dashboard
Configure the sandbox in the dashboard under Settings > Sandbox CLIs.
Find Langfuse in the catalog
In Settings > Sandbox CLIs, find Langfuse under Browse sandbox CLIs and choose to connect it.
Provide credentials
Enter the required values: LANGFUSE_PUBLIC_KEY — your Langfuse project public key; LANGFUSE_SECRET_KEY — your Langfuse project secret key. Optionally, provide LANGFUSE_HOST if you are running a self-hosted Langfuse 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 Langfuse CLI connection with the Sazabi CLI (installed and authenticated — see CLI reference).
sazabi sandbox-clis set --type langfuse --env LANGFUSE_PUBLIC_KEY=<your-public-key> --env LANGFUSE_SECRET_KEY=<your-secret-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 langfuse 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 Langfuse CLI connection is enabled for the project under Settings > Sandbox CLIs.
Authentication or connection fails — Recheck the credential/connection values under Settings > Sandbox CLIs.