Composio 2026 完整指南:AI Agent 的 1000+ 工具基礎設施
兩年前我們介紹 Composio 時,它還只是「AI Agent 的工具整合平台」。如今 Composio 已經成為 GitHub 上**近 3 萬星(29,801★)**的 Agent 工具基礎設施——不只串接工具,而是把「工具發現、認證、執行、沙盒」整套基礎設施打包給 Agent。
如果你正在思考:「我的 Agent 要怎麼安全地操作 Gmail、GitHub、Slack 等 1000 個工具?」——這篇文章就是為你寫的。
🚀 Composio 現在是什麼?
官方定位一句話:「Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.」
拆解成白話:
| 能力 | 說明 |
|---|---|
| 1000+ 預認證工具包 | Gmail、Slack、Notion、GitHub、Salesforce、Stripe……都預先接好 OAuth,不用自己寫認證 |
| 每用戶 Session 隔離 | 每個使用者一個 session,權限/資料互不干擾(多租戶架構) |
| 工具搜尋 | composio search 在 1000+ 工具裡搜尋,不必把數百個工具定義塞進 context |
| Context 管理 | 只載入需要的工具定義,節省 token |
| 沙盒執行 | 工具在沙盒中執行,隔離風險 |
| MCP Gateway | 一個受管理的 MCP endpoint,接所有工具與 Agent |
有趣細節:Composio 官網甚至為「造訪的 AI agent」準備了專屬導引文字——他們很清楚未來的使用者可能是另一個 Agent。
🧱 核心架構:Provider 適配器
Composio 最強的地方在 Provider 體系——把工具轉換成你所用 Agent 框架的原生工具格式:
| 框架 | TypeScript | Python |
|---|---|---|
| OpenAI Agents | ✅ | ✅ |
| Anthropic / Claude Agent SDK | ✅ | ✅ |
| LangChain / LangGraph | ✅ | ✅ |
| LlamaIndex | ✅ | ✅ |
| CrewAI | — | ✅ |
| AutoGen | — | ✅ |
| Vercel AI SDK | ✅ | — |
| Google GenAI / ADK | ✅ | ✅ |
| Mastra / Cloudflare Workers | ✅ | — |
不想用 Provider?直接走 MCP——每個 session 都會暴露一個受管理的 MCP endpoint,Claude、Cursor 或任何 MCP client 都可以直接連。
⚡ 30 秒上手:TypeScript 範例
import { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";
const composio = new Composio({ provider: new OpenAIAgentsProvider() });
// 每個 session 綁定一位使用者
const session = await composio.create("user_123");
const tools = await session.tools();
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful assistant. Use Composio tools to take action.",
tools,
});
const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);
Python 版本同樣簡潔:
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner
composio = Composio(provider=OpenAIAgentsProvider())
session = composio.create(user_id="user_123")
tools = session.tools()
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful assistant. Use Composio tools to take action.",
tools=tools,
)
result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)
重點:預設 session 會拿到「meta tools」——在執行時期動態發現、認證、執行 app 工具,不用把幾百個工具定義全部塞進 context。儲存 session.session_id 之後用 composio.use() 跨回合重用即可。
💻 CLI:讓 Claude Code / Codex / Hermes 直接擁有工具
2026 年 Composio 的殺手級應用是 CLI——一鍵把 1000+ 工具掛到你的 coding agent 上:
curl -fsSL https://composio.dev/install | sh
composio login
之後就能在 shell 裡:
composio search— 搜尋工具composio execute— 執行工具composio link— 連接帳號(OAuth)composio run— 用 TypeScript 腳本化工作流
官網明確列出支援的 coding agents:Claude Code、Codex、OpenClaw、Cursor、Hermes——幾乎涵蓋目前主流 Agent 框架。
🏢 企業場景:從 Sales 到 Finance
Composio 的價值主張已經從「開發者工具」擴展到部門級工作流:
| 部門 | 串接工具 | 一個 prompt 完成的事 |
|---|---|---|
| Sales | Salesforce、HubSpot、Gmail、LinkedIn | 補齊 lead 資料 → 寫 follow-up → 約會議 |
| Marketing | HubSpot、Mailchimp、GA、LinkedIn | 發活動 → 發社群 → 監控 SEO → 養名單 |
| 客服 | Zendesk、Intercom、Slack | 分派工單 → 草擬回覆 → 轉工程 |
| Engineering | GitHub、Linear、Sentry、PagerDuty | 分流 issue → 審查 → 部署 → 回顧 |
| Finance | Stripe、NetSuite、Xero | 分類費用 → 對帳 → 審批 PO |
企業版另有 SSO、治理與審計控制——這正是企業敢把 Agent 放到 org-wide 的關鍵。
⚖️ 與 MCP 的關係(2026 生態關鍵)
如果你讀過我們的 MCP 完整指南,會發現 Composio 與 MCP 是互補關係:
- MCP 是標準協定——定義 Agent 怎麼「說」工具語言
- Composio 是工具基礎設施——提供 1000+ 工具、認證、沙盒,並透過 MCP 暴露
換句話說,Composio 把 MCP 當成輸出端:你的 Agent 走 MCP 連到 Composio 的 gateway,就能拿到 1000+ 工具,不用自己逐一接。
🎯 結論:該不該用 Composio?
適合你,如果:
- 你的 Agent 需要操作多個 SaaS 工具,不想為每個工具寫 OAuth
- 你要做多租戶產品(每個使用者獨立 session)
- 你已經在用 Claude Code / Codex / Cursor,想一鍵加工具
- 你要接 MCP 但不想維護一堆 server
先想想,如果:
- 只需要 1-2 個工具 → 直接寫個 MCP server 更輕量
- 對成本敏感 → 確認用量與定價(免費層與付費層差異)
- 資安要求極高 → 評估企業版的治理/審計是否符合規範
Composio 從 2024 年的「工具整合平台」進化成 2026 年的「Agent 工具基礎設施」,這正是 AI Agent 從 demo 走向生產的縮影——intent into action,讓 Agent 真正開始做事。
來源:Composio 官方網站|GitHub ComposioHQ/composio(29,801★)|數據截至 2026-08-19
