Composio 通过网关为 BR 智能体提供外部应用集成能力，使其能够操作用户已连接的 1000 多个应用（如 Gmail、Slack、GitHub、Google Calendar、Notion 等）。所有操作均通过 Composio Gateway（composio-gateway.fly.dev）进行，网关负责认证和 API 密钥管理。
架构与认证
智能体（运行于 Fly 6PN 网络）通过 HTTP 请求访问 Composio Gateway，网关自动完成认证（基于 IPv6 解析用户 ID），然后调用 Composio SDK 与 Composio Cloud 交互，最终访问目标 API。用户无需持有 COMPOSIO_API_KEY，也无需直接调用 Composio SDK。在 Starchild 平台，网关地址默认为 http://composio-gateway.flycast，其他部署可能通过 COMPOSIO_GATEWAY_URL 和 COMPOSIO_GATEWAY_AUTH 环境变量提供。注意：切勿通过 sc-proxy 代理网关请求，否则会改写调用者身份导致失败。
主要 API 能力
- 搜索工具：使用 POST /internal/search 查找适合任务的工具 slug，返回紧凑的工具信息（slug、描述、参数名）。
- 获取工具架构：使用 POST /internal/tool_schema 获取指定工具的完整参数定义（类型、描述、枚举、默认值）。
- 执行工具：使用 POST /internal/execute 执行工具，参数键名为 arguments（非 params）。失败响应会包含工具架构以便自我修正。
- 列出连接：使用 GET /internal/connections?toolkit=xxx 查看当前连接列表及 OAuth 完成状态。
- 发起连接：使用 POST /api/connect 获取 connect_url 供用户完成 OAuth 授权。
- 断开连接：使用 DELETE /api/connections/{connection_id} 断开指定连接。
使用方式
用户可通过 Web 会话中的 frontend_action 工具（action_type="composio_connect"）触发连接，或在非 Web 渠道通过 API 获取 connect_url。对于已知工具，可直接执行以减少调用次数；对于未知工具，建议先搜索再获取架构后执行。
Browserbase 混合工作流
Composio 的 Browserbase 工具仅管理会话生命周期（创建、列出、删除会话），实际页面操作需通过 Playwright 的 connect_over_cdp 连接会话 WebSocket URL 进行。步骤包括：创建会话、构建 CDP URL、使用 Playwright 控制浏览器、最后删除会话以停止计费。Browserbase 在服务端处理反检测（指纹伪装、验证码解决、Cloudflare 绕过）。
适用场景
适用于需要让智能体代表用户在外部应用中执行操作（如发送邮件、读取邮件、创建日历事件、创建 GitHub issue、发布社交媒体内容等）的场景，也适用于需要浏览器自动化的任务。
限制
- 必须通过正确的网关地址和认证头访问，不可使用代理。
- Browserbase 按分钟计费，使用后务必删除会话。
- Instagram 发布可能存在工具 slug 映射问题，文档提供了可用的替代 slug。
- 部分工具（如 Browserbase）可能存在命名不匹配问题，文档提供了故障排查方法。
- 具体收费、价格、平台兼容性等细节暂未提供。