--- title: "API 网关与工具路由参考：composio - API 网关与工具路由 | 思行致远" canonical: "https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-composio/" dateModified: "2026-06-30" datePublished: "2026-06-30" --- 打开 AI·外脑目录 AI·外脑 [返回专栏首页](https://siyuanailab.com/knowledge/) × 站内搜索 ⌕ 主要栏目 - [AI 核心概念](https://siyuanailab.com/knowledge/ai-core/) - [工作流](https://siyuanailab.com/knowledge/workflows/) - [工具配置与选型](https://siyuanailab.com/knowledge/toolkits/) - [信源与标准](https://siyuanailab.com/knowledge/sources/) - [场景案例 待开发](https://siyuanailab.com/knowledge/scenarios/) - [职业与能力](https://siyuanailab.com/knowledge/career/) 专题 - [从这里开始](https://siyuanailab.com/knowledge/start/) - [获取与安装](https://siyuanailab.com/knowledge/install/) - [建设日志](https://siyuanailab.com/knowledge/ops/) [工作流子目录](https://siyuanailab.com/knowledge/workflows/) 基础设施层 - [浏览器自动化 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/browser-automation/) - [MCP 工具 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/) - [文件系统与本地执行 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) - [API 网关与工具路由 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/) - [WF-016 API 网关与工具路由参考：ai](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-ai/) - [WF-017 API 网关与工具路由参考：composio](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-composio/) - [WF-018 API 网关与工具路由参考：gateway](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-gateway/) - [WF-019 API 网关与工具路由参考：litellm](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-litellm/) - [WF-020 API 网关与工具路由参考：petalflow](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-petalflow/) Skill 生产线 - [目标明确 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/goal-definition/) - [Skill 设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/skill-design/) - [代码实现 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/implementation/) - [测试评估 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/testing-evaluation/) Skill 参考库 - [写作与内容 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/writing-content/) - [研究与知识 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/research-knowledge/) - [沟通与协作 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/communication-collaboration/) - [产品与项目 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/product-project/) - [数据与分析 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/) - [创意与设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/creative-design/) - [商业与营销 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/business-marketing/) Agent Building 只收录有多步工作流、工作标准、Loop、Harness、工具链或通信机制的真 Agent；不收纯 persona、profile、curated list 或只有 system prompt 的仓库。 - [多 Agent 框架 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/multi-agent-frameworks/) - [工作流编排 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/workflow-orchestration/) - [Sub-agent 模式 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/sub-agent-patterns/) - [Harness 与评估 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/harness-evaluation/) 基础设施层 · API 网关与工具路由 · 工具解读 · WF-017 # API 网关与工具路由参考：composio 思行致远 · 2026/6/30 · 置信度：高 API网关工具路由function calling权限边界 一个把第三方 SaaS 动作、认证和不同 Agent 框架适配封装起来的工具连接层。 # Composio > 一个把第三方 SaaS 动作、认证和不同 Agent 框架适配封装起来的工具连接层。 ## 这个能力解决什么问题 Agent 落地时经常不是缺模型，而是缺“能安全操作外部系统”的工具层：Gmail、Slack、GitHub、Notion、HubSpot 等服务各有 OAuth、权限、参数和 API 限流。Composio 解决的是让开发者用统一 SDK 为 Agent 获取工具、处理用户认证，并把工具适配到 OpenAI Agents、LangChain、LangGraph、LlamaIndex、Vercel AI SDK、Gemini、Mastra 等不同框架。 ## 核心逻辑 输入是用户身份 `userId`、要启用的 toolkit 名称，以及当前 Agent 框架 provider。Composio 根据 toolkit 拉取对应工具定义和执行入口，把它们转换成目标框架能理解的 tool schema；Agent 在运行中选择工具后，Composio 负责把调用转到对应 SaaS/API，并把结果返回给 Agent。输出不是一份报告，而是一组已经适配框架的工具对象和实际工具调用结果。 ## 技术结构 - **Core SDK**：`@composio/core` 和 Python `composio` 负责工具发现、认证上下文、toolkit 管理和 API 交互。 - **Provider packages**：OpenAI、Anthropic、LangChain、LangGraph、LlamaIndex、Gemini、Vercel、Mastra 等适配包，把同一工具目录输出成不同框架格式。 - **OpenAPI 生成链路**：README 提到从 Composio 后端拉取 OpenAPI spec，用于更新本地 API 文档和 SDK 类型。 - **Rube MCP**：Rube 是基于 Composio 的 MCP server，把 500+ app integrations 暴露给 Cursor、Claude Desktop、VS Code、Claude Code 等客户端。 - **数据流**：`userId + toolkits` → `composio.tools.get(...)` → 框架工具列表 → Agent 调用工具 → SaaS/API 结果回到 Agent。 ## 为什么值得参考 它把“工具路由”和“用户授权”绑在一起。同一个 Slack 或 GitHub 动作必须知道是谁授权、能操作哪个 workspace、出错时如何重新认证。Composio 的多 provider 包也给了一个清晰样板：工具定义和框架适配要拆开。 ## 为什么不建议直接套用 Composio 的价值依赖它的平台工具库和认证服务，直接使用会把关键外部动作托管给第三方平台；企业客户可能会关心数据经过哪里、OAuth token 如何保存、审计日志是否可导出。它覆盖工具多，但默认工具语义未必符合你的业务边界，写操作尤其需要审批与白名单。 ## 如何改造成自己的版本 借鉴它的分层：先做 `toolkit` 概念，把一组业务动作、认证方式、风险等级放在一起；再做 provider adapter，把同一个内部工具转换成 OpenAI、MCP 或 Vercel AI SDK 格式；最后把 `userId` 作为工具调用必传上下文，禁止使用无归属的全局 token。内部版本可以从 2 个高频 SaaS 开始，先开放读操作或草稿生成。 ## 适用场景 - Agent 需要连接大量第三方 SaaS。 - 多个 Agent 框架共用同一套工具能力。 - 工具调用必须按用户授权执行，而不是系统全局授权。 ## 不适用场景 - 客户不允许第三方托管 OAuth 或工具执行。 - 只需少量内部 API，平台化接入成本高于收益。 - 写操作缺少审批、撤销和审计要求。 ## 参考信息 - 原项目：[composio](https://github.com/ComposioHQ/composio) - 作者：ComposioHQ - 相关概念：[[工具调用]]、[[OAuth 授权]]、[[MCP]] - 相关卡片：保守留空 ## 参考对象信息 **名称：**composio **作者：**ComposioHQ **链接：**[https://github.com/ComposioHQ/composio](https://github.com/ComposioHQ/composio) ## 适用场景与行动 **场景：**基础设施层 / API 网关与工具路由 **适合谁：**关注 AI 工作流、Skill 生产和 Agent Building 的读者 **下一步：**先阅读边界说明，再判断它是否适合改造成自己的API 网关与工具路由流程。 当前内容按公开来源和已审核草稿整理，只作为工作流理解与方法论参考。 涉及客户数据、外部平台、会议记录和业务系统的场景，必须保留人工确认与授权边界。 [上一张：API 网关与工具路由参考：ai](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-ai/) [下一张：API 网关与工具路由参考：gateway](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/infrastructure-api-tool-routing-gateway/) [返回当前分类](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/) [返回工作流专栏](https://siyuanailab.com/knowledge/workflows/)