Composio 是一层托管的集成服务，让 AI 代理拿到第三方软件的已授权访问权限，并提供可把这些工具调用写成代码的沙盒。它站在你的代理和代理需要操作的应用之间——Gmail、Slack、GitHub、Notion 及约一千五百个其他服务——接手 OAuth、令牌刷新、按用户存凭据、工具 schema 与执行。
背后的公司是 Sampark Inc.，独立报道记录其在 2025 年 7 月完成由 Lightspeed 领投的 2500 万美元 A 轮融资，外部融资总额约 2900 万美元。
目录规模要先说清楚，因为流通着几个数字。工具包目录页给出的精确值是 1467 个 toolkit，营销首页取整为 1,500+，文档入口页为 1,400+。同一篇 2025 年 7 月的报道说的是超过 3,000 个可连接应用，如今任何厂商页面都不再重复。只有目录列表能直接清点，以它为准。
它刻意不做的事同样定义了它。Composio 不代理你的模型，也不替你运行代理；它唯一能调用模型的地方是沙盒内部，而且只在你自己的代码要求时。模型、提示词、编排循环与推理账单都仍归你。
会话把一切绑在一起：它把一位终端用户与一组可达的工具包、其已授权账号，以及跨调用存活的执行状态关联起来。你用自己数据库里的用户标识创建会话，于是每次工具执行都落在该用户的连接上，而非共享服务账号。
会话不会自行过期，多轮对话型助手应保存会话标识继续复用，而不是每条消息都新开一个。沙盒文件系统、中间变量与连接状态都挂在会话上，丢掉会话就等于丢掉代理的工作记忆。
会话不把上百个工具 schema 灌进模型上下文，而是给代理一小组固定的元工具，在运行时完成搜索、授权与执行。代理按意图检索，拿回匹配的少数几个，补上缺失的账号连接，再执行——不必每次请求都携带整份目录。
默认所有工具包都可被发现；要收窄范围需显式给出启用的 toolkit slug 列表，或给出禁用列表以保留广泛访问但排除特定服务。
托管工具包的 OAuth 应用由 Composio 持有，用户通过生成的链接完成连接，该账号会保留到后续会话而无需重新授权。需要自有品牌、scope 或同意页时可自带 OAuth 应用。改用直接执行则意味着要自己锁定工具包版本，而这件事会话是自动承担的。
沙盒是持久的 Python 环境，代理在其中编写并运行代码，可访问全部 Composio 工具。pandas、numpy、matplotlib、Pillow、PyTorch 与 reportlab 已预装，其余按需安装。内置辅助函数覆盖执行 Composio 工具、调用大模型、上传生成文件、代理原始 API 请求、联网搜索与从 PDF 或图片抽取文本。
默认沙盒规格刻意偏小，为 1 vCPU 与 1 GB 内存；创建会话时可选 medium、large 与 xlarge 档，最高到 8 vCPU 与 8 GB。
工具包可订阅所连应用中的事件并推送给代理，把请求—响应式的工具层变成能被事件唤醒的东西。触发器投递带签名，你需要验证签名而不是直接信任负载。
从零到一次可用的工具调用只需五行：实例化客户端、为某用户创建会话、读取工具、把列表交给代理框架。代理循环本身不变，工具直接以已授权状态到位。
两种集成模式面向不同形态的产品。原生工具走与框架匹配的 provider 包，在你的进程里拿到带类型的对象。MCP 不需要任何包：会话暴露一个端点 URL 与请求头，任何兼容 MCP 的客户端——Claude Desktop、Cursor、某个代理运行时——都能直接指过去。前者适合你正在构建的应用，后者适合你想扩展的既有客户端。
还有第三条比会话更早、至今仍受支持的路径：直接执行由你的代码指名工具而非让代理去发现，适合运行时发现纯属开销的确定性脚本与定时任务。
单次工具调用足以处理直白的活。沙盒的价值出现在批量操作、数据转换与多步逻辑上——拉五十条 issue、用一次模型调用分类、再把工单写回去，是一次往返而非穿过模型上下文一百次。大体量响应落进可浏览的文件系统，而不是提示词。
有两点会影响用法。代理留在沙盒里的东西都是临时的：挂载文件一天后消失，变量与运行时状态在约十二小时无活动后可能被清除。而文件传输方法位于实验性命名空间下，Composio 提示该接口可能变化。
限流按组织整体在固定的一分钟窗口内计算，所有已认证端点共用一份预算。响应带有剩余额度的头部，超限返回 429 并给出 Retry-After，照它等待比盲目重试划算。把工具定义缓存在客户端，可以避免静态数据消耗请求预算。
Composio 适合已明确代理该做什么、却被集成工作卡住的团队。如果产品必须代表客户在其 Gmail、Slack 或 CRM 里执行动作，按用户的 OAuth 问题确实很难，交出去是合理的。
有两种情况不太合适。如果代理只碰两三个你已持有凭据的 API，托管层带来一个依赖、一笔账单和一道限流天花板，换来的却是你基本做完的活。而如果你想要的是托管的代理，这里没有。
Composio 执行你配置的工具包与连接，并把"代理可以碰什么"当作你的责任，而不是它提供的护栏。这是运行模型而非免责声明：给一个可被提示注入的代理过宽的授权是真实的暴露面，平台会忠实执行代理的任何决定。
文档直白地写明，在生产中用 default 作为用户标识会暴露其他用户的数据。上线前的评审值得专门检查这一点。
所见的商业软件评测平台都没有公开可复现的样本量，因此本文不引用任何汇总评分。权威科技媒体的独立报道属融资类，而非产品实测。
没有需要安装的桌面或移动应用；Composio 要么作为库进入你的运行时，要么作为客户端所连的 MCP 端点。浏览器后台负责项目设置、已连接账号与日志，属于管理面而非产品本体。
provider 包覆盖的框架分两类。一类是模型厂商自家的接入层，含 Anthropic、OpenAI 与 Google。另一类是第三方编排框架，含 Vercel AI SDK、LangChain、CrewAI、LlamaIndex、Mastra、AutoGen 与 Pi。Python 与 TypeScript 均有覆盖，但并非每个 provider 都同时提供两种语言；自行编写 provider 也有文档。
直接走 HTTP 时，当前 REST 版本为 v3.1；上一版 v3 仍受支持并保持锁定的工具版本默认值，既有集成不必迁移。命令行工具与可安装的代理插件覆盖终端场景。
| 接入方式 | 需要什么 | 最适合 |
|---|---|---|
| provider 包（Python / TypeScript） | 匹配框架的包、API 密钥 | 自建自托管的代理 |
| MCP 端点 | 兼容 MCP 的客户端 | 扩展 Claude Desktop、Cursor 等 |
| REST API v3.1 | HTTP 客户端、API 密钥 | 没有官方 SDK 的语言 |
| 命令行工具 | 终端安装 | 本地探索与代码生成 |
公开的自助档位有两个，另加一档需要询价的企业方案；计费模式是每月包含额度加超出后按次计量，而不是固定捆绑包。
| 套餐 | 月费 | 工具调用 | 触发事件 | 支持 |
|---|---|---|---|---|
| Free | $0 | 10 万 | 5 万 | 门户 |
| Pro | $29 | 10 万 + $29 用量额度 | 5 万 | 门户、邮件，$1K 以上加 Slack |
| Enterprise | 定制报价 | 承诺用量 | 承诺用量 | 专属支持 |
| 超出额度后计量 | — | 每次 $0.0003 | 每次 $0.003 | — |
Free 还含 3 个团队成员、用自有 OAuth 应用时不限连接账号数，并设硬性上限：达到上限即暂停用量且不计费，直到次月或升级；Pro 则继续运行并按超量计费，可自行设置支出上限。Composio 替你运行的每月 100 万 LLM 词元超出后按每百万 $3.75 计费。
有一处额度值得仔细读：挂在 Composio 托管共享应用上的 2 万次，是从 10 万次免费工具调用里划出的子额度，而不是额外赠送；换成自有 OAuth 应用即可释放全部额度。工具搜索这类元工具从不计费，因此只有你自己的工具运行才计入。
这套结构适用于 2026 年 8 月 15 日起注册的账户；此前的客户可沿用原方案至 2026 年 12 月 31 日，且旧档位仍另有页面公示。但高级工具调用从 2026 年 9 月 10 日起对所有人计费，含此前注册者。
高级工具是首先要建模的支出项：它们跑在付费的第三方供应商上，Composio 按供应商价格加 5% 平台费透传，不再加价。一次浏览器自动化任务或一段生成视频的花费，比 $0.0003 的工具调用高出数个数量级，因此研究型或媒体型代理的账单取决于这个组合，而非调用次数。附加项叠加在基础费率之上——沙盒执行、会话外直接执行、代理执行——每项各加不到一美分，多数在免费额度后限 Pro 及以上。
档位真正拉开差距的是治理能力。更高的 API 速率上限、KMS 代理与自定义日志留存仅限企业版；IP 白名单、BAA 与零数据留存是 Pro 起的附加项；日志留存 Free 为 7 天、Pro 为 30 天。硬性的数据驻留或密钥托管要求会把你推进询价流程，而某些竞争性集成层把自托管部署作为标准档位公开提供。
高级工具是打乱粗略预算的成本类别：搜索 API、代码沙盒、网页抓取、托管模型推理、文档 OCR 与计算密集型转换——研究型代理整天做的大多是这些。它们还另有更低的上限，与组织级 API 额度分开计算：Hobby 每小时 1,000 次高级调用，Pro 为 10,000 次。通用 API 上限在 Hobby 为每分钟 2,000 次请求、Pro 为 10,000 次，按组织计算，因此偏搜索的代理会先撞上高级工具的上限。
两个官方页面在沙盒计费上说法不一。定价页把沙盒执行列为付费附加项，免费 10,000 次后每次工具调用额外收 $0.0001；而沙盒文档仍写着沙盒目前不计费，并称计划按档位与运行时长计量。在两处说法一致之前，请把重度代码执行的成本视为未定。
公示数字之上还压着一份合理使用政策：过度或滥用性的自动化使用可能导致停用，与所购档位无关。许可条款同时排除转售、对平台内容的衍生使用，以及用自动化提取工具抓取平台。
负载存储是默认开启、需要主动关闭：除非项目显式关掉，每次工具执行的请求参数与响应数据都会被记录。关掉只对新调用生效，已存储的负载会保留到自然过期，而关闭期间未存储的负载事后无法恢复。
执行与触发器日志最长保留一年后自动删除。工具调用经手的文件被暂存在预签名链接之后，默认有效期 1 小时，可按项目延长到 24 小时；暂存对象一天后被删除。
Composio 通过其信任中心公布 SOC 2 Type II 审计证明。凭据、授权配置与 API 密钥用 AES-256-GCM 静态加密，已连接账号的令牌在 API 响应中默认脱敏，管理员可强制多因素登录。权利方面，你保留所提交内容的所有权，同时授予 Composio 一项全球范围、可再许可、可转让的许可，用于与平台及其业务相关的用途。条款还要求客户参与联合市场活动，包括使用其名称与标志。
Google 用户数据被排除在广告、转售以及训练或改进机器学习模型之外。经 YouTube 集成获取的数据有 30 天硬上限，到期后会刷新或永久删除。政策列出访问、更正、删除、撤回同意与取得数据副本这几项权利，但每一项都要写信到公开的支持邮箱，而不是在后台点一个开关。
不会。它负责工具发现、授权与执行，模型与编排循环仍留在你自己的运行时里。唯一例外是可选的沙盒辅助函数，只在你提交的代码要求时才调用模型。
目录页列出可清点的 1467 个 toolkit。其他官方页面取整为 1,400+ 或 1,500+，2025 年的一篇新闻报道则称超过 3,000，因此以目录列表为准。
每月 10 万次工具调用、5 万次触发事件与 3 个团队成员，门户支持，用自有 OAuth 应用时连接账号不限量。它是硬性封顶的：到达上限会暂停用量而不是向你计费。
搜索 API、代码执行沙盒、网页抓取、模型推理、文档 OCR 与计算密集型转换。它们按第三方供应商价格加 5% 平台费计费，而非统一的按次价格，因此研究型代理的账单取决于这个组合。
可以，通过项目级的日志存储设置。它只对新调用生效：已存储的负载会保留到一年窗口期满，关闭期间跳过的负载事后无法恢复。
当前的方案对比表里没有；企业档公示了可自持密钥的 KMS 代理，但服务本身仍是纯云端。
会话不会过期，应当跨对话轮次复用。沙盒内容则不同：挂载文件 24 小时后被删除，其他运行时状态在约 12 小时无活动后可能被清除。
接口返回 429 Too Many Requests，并带上给出窗口重置秒数的 Retry-After 头。限流按组织在一分钟窗口内跨所有已认证端点计算，因此工具执行与账号管理共用一份预算。
