name: zoho_mail-automation description: “通过 Rube MCP (Composio) 自动化 Zoho Mail 任务:发送电子邮件、管理文件夹、标签和邮箱。始终首先搜索工具以获取当前模式。” requires: mcp: [rube]
通过 Rube MCP 自动化 Zoho Mail
通过 Composio 的 Zoho Mail 工具包,经由 Rube MCP 自动化 Zoho Mail 操作。
工具包文档: composio.dev/toolkits/zoho_mail
先决条件
- Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)
- 通过
RUBE_MANAGE_CONNECTIONS与工具包zoho_mail建立活跃的 Zoho Mail 连接 - 始终首先调用
RUBE_SEARCH_TOOLS以获取当前工具模式
设置
获取 Rube MCP: 在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥 — 只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证 Rube MCP 是否可用 - 使用工具包
zoho_mail调用RUBE_MANAGE_CONNECTIONS - 如果连接不活跃,请按照返回的认证链接完成设置
- 在运行任何工作流之前,确认连接状态显示为活跃
工具发现
在执行工作流之前,始终发现可用工具:
RUBE_SEARCH_TOOLS: queries=[{"use_case": "电子邮件发送、文件夹、标签和邮箱管理", "known_fields": ""}]
这将返回:
- Zoho Mail 的可用工具 slug
- 推荐执行计划步骤
- 已知陷阱和边缘情况
- 每个工具的输入模式
核心工作流
1. 发现可用的 Zoho Mail 工具
RUBE_SEARCH_TOOLS:
queries:
- use_case: "列出所有可用的 Zoho Mail 工具和功能"
在继续之前,查看返回的工具、它们的描述和输入模式。
2. 执行 Zoho Mail 操作
发现工具后,通过以下方式执行:
RUBE_MULTI_EXECUTE_TOOL:
tools:
- tool_slug: "<发现的工具slug>"
arguments: {<符合模式的参数>}
memory: {}
sync_response_to_workbench: false
3. 多步骤工作流
对于涉及多个 Zoho Mail 操作的复杂工作流:
- 搜索所有相关工具:使用特定用例调用
RUBE_SEARCH_TOOLS - 首先执行先决步骤(例如,先获取再更新)
- 使用工具响应在步骤之间传递数据
- 使用
RUBE_REMOTE_WORKBENCH进行批量操作或数据处理
常见模式
操作前搜索
在创建新资源之前,始终搜索现有资源以避免重复。
分页
许多列表操作支持分页。检查响应中的 next_cursor 或 page_token,并继续获取直到耗尽。
错误处理
- 在继续之前检查工具响应是否有错误
- 如果工具失败,请验证连接是否仍活跃
- 如果连接过期,通过
RUBE_MANAGE_CONNECTIONS重新认证
批量操作
对于批量操作,使用 RUBE_REMOTE_WORKBENCH 并在循环中使用 ThreadPoolExecutor 并行执行 run_composio_tool()。
已知陷阱
- 始终首先搜索工具:工具模式和可用操作可能发生变化。切勿在没有首先通过
RUBE_SEARCH_TOOLS发现工具的情况下硬编码工具 slug。 - 检查连接状态:确保在执行任何工具之前 Zoho Mail 连接是活跃的。过期的 OAuth 令牌需要重新认证。
- 尊重速率限制:如果收到速率限制错误,请减少请求频率并实施退避策略。
- 验证模式:始终传递严格符合模式的参数。当返回
schemaRef而不是input_schema时,使用RUBE_GET_TOOL_SCHEMAS加载完整的输入模式。
快速参考
| 操作 | 方法 |
|---|---|
| 查找工具 | 使用 Zoho Mail 特定用例调用 RUBE_SEARCH_TOOLS |
| 连接 | 使用工具包 zoho_mail 调用 RUBE_MANAGE_CONNECTIONS |
| 执行 | 使用发现的工具 slug 调用 RUBE_MULTI_EXECUTE_TOOL |
| 批量操作 | 使用 run_composio_tool() 调用 RUBE_REMOTE_WORKBENCH |
| 完整模式 | 对于有 schemaRef 的工具,使用 RUBE_GET_TOOL_SCHEMAS |