ComposioHQ GitHub avatar

composio

TypeScript
AI 工具接入平台ComposioHQ最近推送 2026年11月18日
AI 开发工具MIT31.1k4,958146 issues7 天 +129

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 能调用外部服务执行任务。

推荐指数

4.0

工具集成层做得完整,适合需要让 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. 第 1 步

    创建会话

    用 API Key 初始化 Composio,并为指定用户创建 session。

  2. 第 2 步

    获取工具

    从 session 取出工具列表,交给 Agent 框架使用。

  3. 第 3 步

    运行时发现与认证

    元工具在需要时搜索工具、引导账号连接与认证。

  4. 第 4 步

    执行动作

    Agent 调用工具,由 Composio 转发到对应外部应用。

  5. 第 5 步

    复用会话

    保存 session_id,后续轮次用 composio.use() 继续使用。

快速上手

  1. 1

    获取 API Key

    在 Composio 控制台设置页创建 COMPOSIO_API_KEY。

  2. 2

    安装 SDK

    按语言安装核心包与对应 provider 包。

    npm install @composio/core @composio/openai-agents @openai/agents
  3. 3

    创建会话并接入 Agent

    初始化 Composio,创建用户会话,把 tools 传给 Agent 运行。

  4. 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)标注为实验性,稳定性需自行验证。

主题标签

aipythonagentsaiagentsfunction-callingdeveloper-toolsgpt-4llmllmopstypescriptjavascriptjsai-agentsmcpremote-mcp-serversseagentic-ai