@devries-cameron20 / composio Mirror · read-only / commits / afb9c0c93
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 07:00 UTC

docs: improve how-composio-works page from review feedback

- Fix inconsistent meta tool naming (use COMPOSIO_ prefix everywhere) - Add Tool discovery section covering Vector+BM25 search and learned plans - Add Remote workbench section explaining automatic large response handling Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmitha Mallesh committed Feb 23, 2026 at 12:08 UTC afb9c0c937e1223e366ba8c5de0df4df7d6ca6bf
1 file changed +20 -1
docs/content/docs/how-composio-works.mdx
+20 -1
@@ -85,12 +85,18 @@ graph TD
85 classDef annotation stroke-dasharray: 5 5
86 ```
87
88 -`SEARCH_TOOLS` discovers the right toolkit tools for the task. `MULTI_EXECUTE_TOOL` runs them against the external API with the user's credentials. If the user isn't authenticated yet, `MANAGE_CONNECTIONS` handles that in between.
88 +`COMPOSIO_SEARCH_TOOLS` discovers the right toolkit tools for the task. `COMPOSIO_MULTI_EXECUTE_TOOL` runs them against the external API with the user's credentials. If the user isn't authenticated yet, `COMPOSIO_MANAGE_CONNECTIONS` handles that in between.
89
90 For large responses or bulk operations (labeling hundreds of emails, processing CSVs), the agent uses `COMPOSIO_REMOTE_WORKBENCH` to run Python with helper functions like `invoke_llm` and `run_composio_tool`.
91
92 <Card icon={<BookOpen />} title="Tools and toolkits" href="/docs/tools-and-toolkits" description="Meta tools, context management, and execution" />
93
94 +## Tool discovery
95 +
96 +When the agent calls `COMPOSIO_SEARCH_TOOLS`, Composio runs a Vector + BM25 hybrid search across all available toolkits to find the right tools for a given use-case query. The search returns matching tool schemas, connection statuses, and related tools in a single call.
97 +
98 +Composio also surfaces **learned plans** from past executions. These are step-by-step workflows that have worked before for similar tasks, guiding the LLM to better perform an operation without starting from scratch.
99 +
100 ## Authentication
101
102 When a tool requires authentication and the user hasn't connected yet, the agent uses `COMPOSIO_MANAGE_CONNECTIONS` to generate a **Connect Link**, a hosted page where the user authorizes access.
@@ -122,6 +128,19 @@ When the agent calls `COMPOSIO_MULTI_EXECUTE_TOOL`, Composio resolves the sessio
128
129 Your agent doesn't touch API credentials or handle token refresh. Composio resolves credentials from the session and connected account, makes the authenticated call, and returns the result.
130
131 +## Remote workbench
132 +
133 +Large responses from `COMPOSIO_MULTI_EXECUTE_TOOL` are automatically synced to a secure remote workbench. Instead of stuffing thousands of lines into the context window, the agent can work with the data inside the workbench:
134 +
135 +- **Reading** files and tool responses
136 +- **Searching** across large outputs
137 +- **Writing and executing** Python code to transform, filter, or aggregate data
138 +- **Calling Composio tools** via the `run_composio_tool` helper for bulk orchestration
139 +
140 +This keeps the agent's context window lean while still letting it handle operations like labeling hundreds of emails, processing CSV exports, or summarizing long API responses.
141 +
142 +<Card icon={<BookOpen />} title="Workbench" href="/docs/workbench" description="Persistent Python sandbox for large-context operations" />
143 +
144 ## Direct tool execution
145
146 If you know exactly which tools you need, you can skip the meta tool pattern and execute tools directly: