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)
# Description Customers evaluating Composio see references to **LLM tokens** and assume Composio is handing them an agent/LLM that *replaces* their own — i.e. that they'd be swapping their agent for ours. It isn't: Composio discovers, authenticates, and executes tools; it never proxies the customer's model or runs an agent on their behalf. The one place Composio itself calls a model is **inside the sandbox** (the optional `invoke_llm` helper + AI-assisted conveniences like error correction). The sandbox is opt-in per session (`sandbox: { enable: true }`), so this LLM usage is entirely optional and can be disabled. This PR adds a short callout to the **Remote sandbox** docs page (`docs/content/docs/sandbox/remote.mdx`) that says exactly that — placed right where `invoke_llm` and the sandbox are introduced, with anchor links to the `invoke_llm` helper, error correction, and session configuration. It kills the "are they replacing my agent?" misconception at its source. The copy is deliberately accurate to today's state: it does **not** claim we bill LLM tokens (sandbox billing is still upcoming and the public pricing page only lists Tool Calls). It frames the point conceptually — *your agent stays yours; the only Composio-side LLM usage is optional and sandbox-scoped.* **Follow-up surfaces (not in this PR — see below):** this same clarification could be mirrored on the dashboard usage/billing UI and the marketing pricing page when an "LLM tokens" line item actually surfaces there. Those live outside this repo. # How did I test this PR - Docs-only change (single `.mdx` file); no code or dependency surface. - Verified all anchor targets referenced in the new callout exist on the same page / site: - `#built-in-helpers` → `### Built-in helpers` (the `invoke_llm` row) - `#error-correction` → `### Error correction` - `/docs/configuring-sessions` (existing page; documents `sandbox: { enable: true }`) - Matches the existing `<Callout title="...">` component usage already on the page (the "Renamed from workbench" callout), so it renders consistently in Fumadocs. - Confirmed against source that `invoke_llm` (docs `Built-in helpers` table) is the Composio-side LLM entry point and that the sandbox is opt-in via the `sandbox`/`workbench` session key. # Security - **Scope:** documentation-only change — one `.mdx` file, no dependencies, lockfiles, or executable code added/changed. - **Socket / Grype:** not applicable to this diff (no package manifests or code paths introduced); no new fixable CRITICAL/HIGH/MEDIUM findings possible from a Markdown copy addition. Triggered by: palash@composio.dev | Source: slack Session: https://zen.corp.composio.io/dashboard/#/chat/zen-f6a81a5a6764 --------- Co-authored-by: Zen Agent <zen@composio.dev> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>