Add supervision without changing your runtime
Instrument Python, Node.js, and HTTP agents with reported activity, outcome review, and explicit control points.
The worker finished. Which step produced the bad result?
Your agent already has a runtime and tools. Add the operational record that helps the people supporting it understand failures, review outputs, and control integrated actions.
Instrument one path
Report a heartbeat and a run lifecycle. Add spans around the calls you need to debug rather than shipping raw prompts or secrets.
Test the failure path
Trigger a controlled failure in your own test environment. Confirm that the reported step history gives a reviewer enough context to investigate.
Introduce controls deliberately
Add checkpoints and one guarded action. Verify the waiting, rejected, approved, and runner-acknowledged states before expanding the integration.
Keep your runtime and framework
Toolcaise does not run your agent or replace your framework. The agent stays where it is, in a container, a worker queue, a scheduled job or a developer’s laptop, and reports what it does over outbound HTTPS. There is nothing to host, no inbound port to open and no model-provider key to hand over.
Pick the path that fits the code
- Python or Node.js SDK: runs, spans, model calls through an instrumented client, outcomes, checkpoints and approvals.
- OpenTelemetry: point the exporter your framework already has at Toolcaise with three environment variables. It observes only.
- HTTP contract: for any runtime that can make an HTTPS request, described in the OpenAPI document the API is tested against.
- Toolcaise Connect: wrap a command to meter every model call on the machine and enforce cost, token, call and runtime limits, or put its gateway in front of an MCP server.
Debugging a bad result
The worker finished and the output is wrong. With spans around retrieval, model calls and tools, you can see which step produced the bad input, what each model call consumed and whether a retry quietly changed the result. That is usually enough to find the cause without reproducing the run.
Controls that fail safe
Reporting is fire-and-forget: if Toolcaise is down, your agent keeps running and reports catch up later. Controls work the other way. A guarded action or checkpoint that cannot confirm a decision raises instead of proceeding, so an outage never turns into an unapproved action.
Test the failure paths before production
Trigger a controlled failure in a test environment: kill the process mid-run, return an empty result, hit a cost limit on purpose, deny an approval. Confirm each one shows up the way the person on call will need to see it. The pilot checklist walks through these one at a time.
How to measure the pilot
Measure the completeness of reported runs, time to locate a failed step, and coverage of consequential actions by guards. Cost data is only as complete as your reporting.
Explore the relevant capability →Frequently asked questions
Does Toolcaise replace LangSmith-style tracing?
Toolcaise focuses on supervision: runs, incidents for missing work, outcome review, approvals and enforced limits. It accepts OpenTelemetry traces, so it can sit alongside tracing and evaluation tools you already use rather than replacing them.
Will adding the SDK slow down my agent?
Reports are queued in memory and sent from a background thread, so your code does not wait on the network. Only controls (checkpoints and approvals) wait, because they have to.
Can I enforce a cost limit from code?
The SDKs report usage but cannot stop a model call on their own. For an enforced limit, run the agent under Toolcaise Connect, which meters each call through a local gateway and ends the run when a limit is reached.
Related guides
How to spot an AI agent stuck in a loop, stop it with limits or a kill switch, end its whole process tree, and design runs so a stop is safe.
Read the guide How to control which MCP tools an agent can useHow to restrict the MCP tools an AI agent can call: least privilege, allowlists, call budgets, approval of exact calls, clean refusals and logging.
Read the guide OpenTelemetry for AI agents: what to trace and howHow to trace AI agents with OpenTelemetry: which spans to record, GenAI semantic conventions, what to keep out of traces, and exporting over OTLP/HTTP.
Read the guideConnect your first agent
Create a free workspace, connect the agent you already run, and watch its next run arrive. Free covers 3 agents, with no card required.