SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场connect

connect

智能体与模型

查看项目

更新于 10-15 09:16

技能介绍

Connect 是一个面向 Codex 的技能（Skill），其目标是把 Codex 从“只描述能做什么”变成“直接在 shell 中实际执行”。用户需要让 Codex 发送邮件、创建 issue、发布消息或更新数据库时，可以使用该技能，而不是只得到草稿或操作建议。

主要能力

Connect 通过 Composio CLI 让 Codex 连接任意应用并执行真实操作。官方列出 1000+ 集成，覆盖：

  • 邮件：Gmail、Outlook、SendGrid
  • 聊天：Slack、Discord、Teams、Telegram
  • 开发：GitHub、GitLab、Jira、Linear
  • 文档：Notion、Google Docs、Confluence
  • 数据：Sheets、Airtable、PostgreSQL
  • CRM：HubSpot、Salesforce、Pipedrive
  • 存储：Drive、Dropbox、S3
  • 社交：Twitter、LinkedIn、Reddit

使用方式

  1. 安装 Composio CLI：

curl -fsSL https://composio.dev/install | bash

  1. 登录：

composio login composio whoami

该命令会打开浏览器进行认证，并允许选择默认组织和项目。在自动化流程中可使用 -y 跳过提示。

  1. 绑定所需工具包：

composio link github composio link gmail composio link slack

每个命令完成一次 OAuth 后，连接会保持。

核心工作流

  • 已知工具 slug：使用 composio execute
  • 不知道 slug：使用 composio search
  • 需要了解输入结构：使用 composio execute --get-schema 或 --dry-run
  • 工具包未连接：使用 composio link <toolkit> 后重试
  • 多步骤流程：使用 composio run 编排工作流，或使用 composio proxy 进行原始 API 调用

典型示例

发现工具：

composio search "create a github issue" composio search "send an email" --toolkits gmail

调用前检查输入：

composio tools info GITHUB_CREATE_ISSUE composio execute GITHUB_CREATE_ISSUE --get-schema composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

发送邮件：

composio execute GMAIL_SEND_EMAIL -d '{ "recipient_email": "sarah@acme.com", "subject": "Shipped!", "body": "v2.0 is live, let me know if issues" }'

创建 GitHub issue：

composio execute GITHUB_CREATE_ISSUE -d '{ "owner": "my-org", "repo": "repo", "title": "Mobile timeout bug", "labels": ["bug"] }'

发布 Slack 消息：

composio execute SLACK_SEND_MESSAGE -d '{ "channel": "engineering", "text": "Deploy complete - v2.4.0 live" }'

并行执行：

composio execute --parallel
GMAIL_FETCH_EMAILS -d '{"max_results": 2}'
GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

用 composio run 串联动作：

composio run ' const issues = await search("github issues labeled bug this week"); const summary = issues.map(i => - ${i.title}).join("\n"); await execute("SLACK_SEND_MESSAGE", { channel: "bugs", text: This week’s bugs:\n${summary} }); '

从文件加载可复用工作流：

composio run --file ./workflow.ts -- --repo composiohq/composio

原始 API 访问（proxy）

当没有专用工具时，可直接访问已认证的 API：

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile
--toolkit gmail

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts
--toolkit gmail -X POST -H 'content-type: application/json'
-d '{"message":{"raw":"..."}}'

工作原理

  1. 用户请求 Codex 执行某操作
  2. Codex 通过 composio search 或已有知识选择 slug
  3. CLI 检查连接，如缺失则提示 composio link
  4. 动作针对真实 API 执行，并以 JSON 返回 stdout

配置

全局标志：

  • --log-level <all|trace|debug|info|warning|error|fatal|none>
  • --help 查看各命令文档

环境变量：

  • COMPOSIO_API_KEY：认证凭据，用于非交互场景
  • COMPOSIO_BASE_URL：自定义 API 端点
  • COMPOSIO_SESSION_DIR：覆盖产物存储目录
  • COMPOSIO_DISABLE_TELEMETRY=true：退出遥测

可选类型安全 SDK

当需要从应用而非 shell 调用工具时，可生成有类型的客户端代码：

composio generate ts # TypeScript 类型 composio generate py # Python 类型

相关标志：-o <dir>、--toolkits <list>、--compact、--transpiled、--type-tools。

故障排查

  • 未登录：运行 composio login
  • 需要连接 <toolkit>：运行 composio link <toolkit>
  • 未知 slug：使用 composio search "<what you want>" 或 composio tools list <toolkit>
  • 输入错误：先 composio execute <SLUG> --get-schema，再 --dry-run
  • 动作失败：检查目标应用中的权限

完整参考：docs.composio.dev/docs/cli

适用场景与限制

Connect 适用于需要 Codex 跨应用执行真实操作的场景，例如自动发送邮件、创建开发任务、发布团队消息、写入文档或更新数据库。其限制和前提包括：需要安装 Composio CLI、完成登录并按需 link 对应工具包；具体可用动作取决于已连接工具包及目标应用权限；使用前建议用 --get-schema 或 --dry-run 确认输入。资料未提供收费、价格或效果保证等信息。