用途:让智能体在 Gmail、Slack、GitHub、Google Calendar、Notion 等 1000+ 外部应用中执行操作(发邮件、建日程、开 issue、发帖等)。所有操作经 Composio Gateway(composio-gateway.flycast)中转,网关持有 COMPOSIO_API_KEY 并处理认证,认证依据 Fly 6PN 的 IPv6 自动解析为 user_id,无需环境变量。
主要能力:1) 搜索工具:POST $GATEWAY/internal/search,返回精简的工具 slug、说明与参数名。2) 获取完整参数定义:POST $GATEWAY/internal/tool_schema。3) 执行工具:POST $GATEWAY/internal/execute,键名为 arguments;失败响应会附带 schema 便于自行纠正。4) 查询连接:GET $GATEWAY/internal/connections,含 oauth_completed_active 字段。5) 发起连接:POST $GATEWAY/api/connect 返回 connect_url;Web 会话可用 frontend_action(action_type="composio_connect", toolkit="gmail")。6) 断开:DELETE $GATEWAY/api/connections/{connection_id}。
用法要点:网关通过 Fly 内网 flycast 用纯 HTTP 访问,禁止走代理(不要用 proxied_get/proxied_post,不要设 HTTP_PROXY/HTTPS_PROXY 或 curl -x),否则会改写调用者身份导致执行失败。常用工具可直接执行,未知工具按“搜索→必要时查 schema→执行”流程。常见工具包括 GMAIL_SEND_EMAIL、GMAIL_FETCH_EMAILS、GOOGLECALENDAR_EVENTS_LIST、TWITTER_CREATION_OF_A_POST 等。
Instagram 发帖需两步:先用 INSTAGRAM_CREATE_MEDIA_CONTAINER(必填 ig_user_id),再以返回的 creation_id 调用 INSTAGRAM_CREATE_POST(必填 ig_user_id、creation_id);若搜索返回的旧 slug 执行报 not found,改用上述两个。
浏览器类:Composio 的 Browserbase 工具仅管理会话生命周期(创建/列表/删除等),实际页面操作需用 Playwright connect_over_cdp 连接会话 WebSocket。按分钟计费,用毕务必删除会话;如连接名与工具 slug 不一致报错,属于命名差异,可先查 /health、/internal/connections 再重试。
限制:资料未提供具体应用清单完整范围、收费价格、连接数量上限及 OAuth 支持范围等细节,暂未提供。