composio-connect

Composio Connect

概述

适用于 1,000 多款应用的通用操作执行器。这是一项备用技能——仅当没有其他技能涵盖所请求的服务时才使用。

何时使用此技能

┌─────────────────────────────────────────────────────────────────┐
│ DECISION: Should I use Composio?                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ 1. Does another skill already handle this service?              │
│    ├── Gmail/Drive/Calendar → google-workspace (USE THAT)       │
│    ├── Slack → slack-automation (USE THAT)                      │
│    ├── CRM (Attio) → attio-crm (USE THAT)                       │
│    ├── GitHub issues → Use gh CLI via Bash (USE THAT)           │
│    └── YouTube downloads → youtube-tools (USE THAT)             │
│                                                                 │
│ 2. Is the service NOT covered by other skills?                  │
│    ├── Notion, Asana, Trello, Monday → USE COMPOSIO             │
│    ├── HubSpot, Salesforce, Pipedrive → USE COMPOSIO            │
│    ├── Jira, Linear, Confluence → USE COMPOSIO                  │
│    ├── Airtable, Coda, ClickUp → USE COMPOSIO                   │
│    ├── Stripe, Shopify, QuickBooks → USE COMPOSIO               │
│    ├── Zendesk, Intercom, Freshdesk → USE COMPOSIO              │
│    ├── Microsoft 365, Teams, Outlook → USE COMPOSIO             │
│    ├── Dropbox, Box, OneDrive → USE COMPOSIO                    │
│    ├── Figma, Canva, Miro → USE COMPOSIO                        │
│    ├── Zoom, Webex, Google Meet → USE COMPOSIO                  │
│    └── 900+ other apps → USE COMPOSIO                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

环境设置

# 1. Get free API key from https://platform.composio.dev
# 2. Add to .env file
COMPOSIO_API_KEY=your_api_key_here

# 3. Install SDK
pip install composio-core

快速决策树

What do you want to do?
│
├── Execute a single action
│   └── python scripts/execute_action.py "Send email via Gmail to [email protected]"
│
├── List available apps
│   └── python scripts/execute_action.py --list-apps
│
├── List actions for an app
│   └── python scripts/execute_action.py --list-actions notion
│
├── Check connection status
│   └── python scripts/execute_action.py --check-connection notion
│
└── Connect to a new app
    └── python scripts/execute_action.py --connect notion

常见用法

执行操作（自然语言）

# Let Composio figure out the right tool
python scripts/execute_action.py "Create a Notion page titled 'Meeting Notes' in my workspace"
python scripts/execute_action.py "Add a task to Asana: Review Q4 budget"
python scripts/execute_action.py "Create a Linear issue for bug in checkout flow"
python scripts/execute_action.py "Send a HubSpot email to [email protected]"

列出可用应用

python scripts/execute_action.py --list-apps
python scripts/execute_action.py --list-apps --category crm
python scripts/execute_action.py --list-apps --category productivity

连接应用（首次使用）

# This will provide an OAuth link to authorize
python scripts/execute_action.py --connect notion
python scripts/execute_action.py --connect hubspot
python scripts/execute_action.py --connect jira

执行特定操作

python scripts/execute_action.py --app notion --action create_page --params '{"title": "My Page", "content": "Hello world"}'

按类别划分的支持应用

生产力与文档

应用	常见操作
Notion	创建页面、添加数据库条目、搜索
Asana	创建任务、更新项目、分配任务
Trello	创建卡片、移动卡片、添加评论
Monday	创建项目、更新列、发送通知
ClickUp	创建任务、更新状态、添加评论
Coda	创建文档、更新表格、运行自动化
Airtable	创建记录、更新字段、查询数据库

CRM 与销售

应用	常见操作
HubSpot	创建联系人、更新交易、发送邮件
Salesforce	创建潜在客户、更新销售机会、记录通话
Pipedrive	创建交易、更新人员、添加活动
Zoho CRM	创建记录、更新模块、发送邮件
Close	创建潜在客户、记录通话、发送邮件

开发与 DevOps

应用	常见操作
Jira	创建问题、更新状态、添加评论
Linear	创建问题、分配任务、更新优先级
Confluence	创建页面、更新空间、添加评论
GitLab	创建问题、合并请求、流水线
Bitbucket	创建 PR、添加评论、更新问题

客户支持

应用	常见操作
Zendesk	创建工单、更新状态、添加备注
Intercom	发送消息、创建对话、为用户添加标签
Freshdesk	创建工单、回复、更新优先级
Help Scout	创建对话、发送回复、添加标签

金融与电子商务

应用	常见操作
Stripe	创建发票、查询付款、退款
Shopify	创建订单、更新产品、查询库存
QuickBooks	创建发票、记录付款、添加支出
Xero	创建发票、对账、添加联系人
Square	创建付款、更新目录、发送收据

通信

应用	常见操作
Microsoft Teams	发送消息、创建频道、安排会议
Zoom	创建会议、发送邀请、获取录制内容
Discord	发送消息、创建频道、管理角色
Twilio	发送 SMS、拨打电话、发送 WhatsApp 消息

设计与创意

应用	常见操作
Figma	获取文件、导出素材、添加评论
Canva	创建设计、导出、分享
Miro	创建画板、添加便笺、导出

存储与文件

应用	常见操作
Dropbox	上传文件、分享链接、创建文件夹
Box	上传、分享、管理权限
OneDrive	上传、分享、同步

首次身份验证流程

首次连接新应用时：

1. 运行连接命令：

   python scripts/execute_action.py --connect notion
   

2. 你将收到一个 OAuth URL：

   Please authorize Composio to access Notion:
   https://app.composio.dev/authorize/notion?token=xxx
   

3. 点击链接并在浏览器中授权

4. 返回终端确认：

   Authorization complete? (y/n): y
   

5. 连接现已保存——后续请求将自动生效

费用

• **Composio API：**提供免费套餐（请访问 platform.composio.dev 查看使用限制）
• 大多数操作不按次收费
• 高级应用可能需要付费的 Composio 套餐

安全说明

凭据处理

• 将 COMPOSIO_API_KEY 存储在 .env 中（切勿提交）
• OAuth 令牌由 Composio 安全存储
• 可随时通过 platform.composio.dev 撤销访问权限

权限

• 每个应用仅请求必要的 OAuth 权限范围
• 授权前请检查权限
• 可以单独移除各项连接

数据隐私

• Composio 会处理请求，但不会存储你的数据
• 操作会直接通过已连接的服务执行
• 如需了解详情，请查阅 Composio 的隐私政策

故障排除

问题：“应用未连接”

解决方案： 运行 --connect <app> 并完成 OAuth 流程

问题：“API 密钥无效”

解决方案： 检查 .env 中的 COMPOSIO_API_KEY，如有需要则重新生成

问题：“操作失败”

原因： 缺少权限或参数无效 解决方案： 使用 --list-actions <app> 检查正确的操作格式

问题：“请求过于频繁”

解决方案： 等待后重试，或升级 Composio 方案

与其他技能集成

后备模式

当用户请求的内容不在你的技能中时：

1. 检查 Composio 是否支持该应用
2. 使用 Composio 执行操作
3. 将结果返回给用户

链接操作

# Research → Create Notion summary
# 1. Use parallel-research for research
# 2. Use composio to create Notion page with results

# Scrape → Update CRM
# 1. Use apify-scrapers to get company data
# 2. Use composio to update HubSpot contact

资源

• Composio 平台： https://platform.composio.dev
• API 文档： https://docs.composio.dev
• 支持的应用列表： https://app.composio.dev/apps
• references/apps-catalog.md - 1,000 多个受支持应用的完整列表
• references/actions-guide.md - 按类别整理的常见操作