客户关系协作助手

要解决的问题

想让模型帮忙处理 Capsule CRM 里的客户资料，通常会撞上两个麻烦：一是模型本身没有 Capsule 的接口，能调哪些操作、参数怎么填全靠猜；二是 CRM 操作天然是多步流程（先查客户是否已存在，再决定更新还是新建），任何一步都可能因为 OAuth token 过期、触发限流、分页没拉完而失败。这个技能要填平的，正是"发现工具"和"真正跑通一条 CRM 流程"之间的那段空白。

核心能力

技能通过 Rube MCP 接入 Composio 的 Capsule CRM 工具集，整个工作方式围绕几个固定动作展开：

• 工具发现：执行任何操作前先调 RUBE_SEARCH_TOOLS，拿到当前可用的 tool slug、输入 schema、推荐的执行步骤和已知坑点。不硬编码任何 slug，因为可用操作会变化。
• 连接管理：用 RUBE_MANAGE_CONNECTIONS 绑定 capsule_crm 工具集，按返回的授权链接完成配置，并确认状态为 ACTIVE 后才继续。
• 执行与编排：用 RUBE_MULTI_EXECUTE_TOOL 跑已发现的工具；复杂流程按先查后写的顺序串起来，上一步的返回值作为下一步的输入。
• 批量处理：在 RUBE_REMOTE_WORKBENCH 里用 run_composio_tool() 配合 ThreadPoolExecutor 做并行批量操作。

标准执行顺序

1. 确认 RUBE_SEARCH_TOOLS 有响应，说明 Rube MCP 已接入。
2. 建立并验证 Capsule CRM 连接处于 ACTIVE。
3. 按用例搜索相关工具，阅读描述与 schema。
4. 先跑前置步骤（例如拉取记录），再执行写入操作。
5. 需要完整参数定义时，用 RUBE_GET_TOOL_SCHEMAS 加载 schemaRef 对应的内容。

适用边界与注意点

• Rube MCP 必须已配置为 MCP server（https://rube.app/mcp），该端点无需额外 API key。
• 先搜再写：创建任何资源前先搜索是否已存在，避免产生重复数据。
• 分页：列表类接口返回 next_cursor 或 page_token 时要持续拉取，直到数据耗尽。
• 错误处理：每次执行后检查返回里的 error 字段；连接过期就重新走 RUBE_MANAGE_CONNECTIONS 授权。
• 限流：遇到 rate limit 就降低请求频率并加退避。
• schema 校验：只传符合 schema 的参数，遇到 schemaRef 必须先取全量 schema 再调用。

工具集文档：composio.dev/toolkits/capsule_crm