Skip to content

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.

  1. 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.

  2. 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.

  3. 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.

Connect 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.