AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
给 AI Agent 接入 1000+ 外部工具,并处理认证与执行。
Composio 是一个 TypeScript/Python 双语言 SDK 仓库,为 AI Agent 提供 1000+ 预认证工具包、按用户隔离的会话、认证、触发器与沙箱工作台。它通过 provider 适配器把工具转成 OpenAI Agents、Claude Agent SDK、Vercel AI SDK、LangChain 等框架的原生工具格式,让 Agent 能调用外部服务执行任务。
推荐指数
工具集成层做得完整,适合需要让 Agent 真正操作外部应用的团队,但依赖其云服务与 API Key。
近 7 天
+129
新增 Star
总 Star 排名
#213
雷达追踪的 3,931 个 AI 仓库中
创建于
2024
2024年2月23日
核心亮点
1工具数量多
README 称提供 1000+ 预认证工具包,覆盖常见应用。
2按用户会话
每个 session 绑定一个用户,可跨轮次复用 session_id。
3框架适配广
提供 OpenAI、Anthropic、LangChain、LlamaIndex 等多家 provider。
4元工具省上下文
默认用元工具在运行时发现、认证并执行工具,不必加载全部定义。
5支持 MCP
会话可暴露托管 MCP 端点,供 Claude、Cursor 等客户端接入。
适用场景
个人助理类 Agent
例如:让 Agent 读取当天邮件并生成摘要。
多用户 SaaS 产品
例如:为每个终端用户创建独立会话,隔离各自的连接账号。
已有 Agent 框架扩展工具
例如:在 LangChain 或 Vercel AI SDK 项目中接入 Composio provider 获得外部工具。
命令行调试工具调用
例如:用 composio search 找工具、composio execute 直接执行验证。
它是怎么工作的
第 1 步
创建会话
用 API Key 初始化 Composio,并为指定用户创建 session。
第 2 步
获取工具
从 session 取出工具列表,交给 Agent 框架使用。
第 3 步
运行时发现与认证
元工具在需要时搜索工具、引导账号连接与认证。
第 4 步
执行动作
Agent 调用工具,由 Composio 转发到对应外部应用。
第 5 步
复用会话
保存 session_id,后续轮次用 composio.use() 继续使用。
快速上手
- 1
获取 API Key
在 Composio 控制台设置页创建 COMPOSIO_API_KEY。
- 2
安装 SDK
按语言安装核心包与对应 provider 包。
npm install @composio/core @composio/openai-agents @openai/agents - 3
创建会话并接入 Agent
初始化 Composio,创建用户会话,把 tools 传给 Agent 运行。
- 4
可选:安装 CLI
用安装脚本把 composio 命令加入 PATH,然后登录。
curl -fsSL https://composio.dev/install | sh
适合谁
- 需要让 Agent 调用大量外部应用的开发者
- 使用 OpenAI Agents、LangChain 等框架的 TypeScript/Python 团队
- 需要按终端用户隔离账号与权限的产品
不太适合
- 只想做纯本地、无外部依赖实验的开发者
- 不需要外部工具调用的简单 LLM 应用
成熟度
- 活跃度最近推送在 2026-11 月,star 超 3.1 万,迭代活跃。
- 文档README 有快速开始、provider 表格和文档站链接,信息较完整。
- 社区近 5000 fork、146 个开放 issue,并有 Discord 社区入口。
- 上手难度几行代码即可接入,但需先注册并配置 API Key。
同类项目怎么选
- LangChain Tools偏通用 Agent 框架与工具抽象,Composio 更聚焦预认证工具集成与用户会话管理。
- MCP 生态Composio 自身可暴露 MCP 端点,但额外提供工具库、认证和沙箱。
使用前注意
- · 依赖 Composio 云服务与 API Key,非纯本地运行。
- · 工具调用涉及第三方账号授权,需关注凭据与权限管理。
- · README 提到 @composio/core 打包源码与文档,安装体积较大,可用 slim 包。
- · 部分 provider(如 Pi)标注为实验性,稳定性需自行验证。
