Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs(sandbox): clarify Composio doesn't run/replace your agent (LLM tokens are sandbox-only & optional) (#3933)

composio-zen[bot]8dcc9b991410
diff --git a/docs/content/docs/sandbox/remote.mdx b/docs/content/docs/sandbox/remote.mdx
index a3223e9bd..98e7971ee 100644
--- a/docs/content/docs/sandbox/remote.mdx
+++ b/docs/content/docs/sandbox/remote.mdx
@@ -10,6 +10,10 @@ The **sandbox** is a persistent Python environment where your agent writes and e
This feature used to be called the **workbench**. The preferred session config key is now `sandbox`, but `workbench` still works as a fully supported alias, in both SDKs and on the wire. It isn't deprecated, so existing code keeps running unchanged. The `COMPOSIO_REMOTE_WORKBENCH` and `COMPOSIO_REMOTE_BASH_TOOL` meta tools keep their names.
</Callout>
+<Callout title="Composio doesn't run or replace your agent">
+Your agent and its model stay entirely yours — Composio never proxies your LLM or runs an agent on your behalf. It discovers, authenticates, and executes tools. The one place Composio itself can call a model is *inside the sandbox*, and only when your code opts in — most directly through the [`invoke_llm`](#built-in-helpers) helper. That optional, sandbox-only usage is the sole source of any Composio-side **LLM tokens**. The sandbox is opt-in per [session](/docs/configuring-sessions) via `sandbox: { enable: true }` — don't enable it (or simply never call `invoke_llm`) and Composio uses no LLM tokens at all.
+</Callout>
+
## Where it fits
Use the sandbox when a task is too complex for individual tool calls. Your agent starts with [`SEARCH_TOOLS` to find the right tools, then uses `MULTI_EXECUTE`](/docs/how-composio-works#meta-tools) for straightforward calls. When the task involves bulk operations, data transformations, or multi-step logic, the agent reaches for `COMPOSIO_REMOTE_WORKBENCH` instead.