技能介绍

当你需要把 Zoho Mail 接入自动化流程，直接拼调用往往面临三类问题：工具能力与参数 schema 不确定、连接状态不透明、批量操作容易触发限流或产生重复数据。这个技能通过 Rube MCP 统一封装 Zoho Mail 的访问方式，让你用一致的流程完成发现、连接、执行与批量处理。

配置 Rube MCP：在客户端中添加 https://rube.app/mcp 作为 MCP server；Rube 本身不需要 API key，添加 endpoint 后即可使用
验证可用性：配置完成后，先确认 RUBE_SEARCH_TOOLS 有响应
建立连接：调用 RUBE_MANAGE_CONNECTIONS（参数 toolkit 为 zoho_mail）；如果连接不是 ACTIVE，按返回的授权链接完成设置
加载 schema：通过 RUBE_GET_TOOL_SCHEMAS 获取完整输入结构，避免提交不合规参数
搜索工具：始终先调用 RUBE_SEARCH_TOOLS，获取当前 Zoho Mail 可用的工具 slug、执行计划、边角情况和输入 schema；不要硬编码工具名
执行操作：用 RUBE_MULTI_EXECUTE_TOOL 执行已发现的工具 slug；复杂流程遵循「先 fetch 再 update」的顺序，并通过工具响应在步骤间传递数据
批量处理：使用 RUBE_REMOTE_WORKBENCH 配合 run_composio_tool()，在循环中配合 ThreadPoolExecutor 做并行批量操作

工具 schema 可能变化：即使之前用过某个 slug，也必须重新搜索确认，避免调用已废弃或参数已变更的工具
连接状态会过期：OAuth token 过期后需要重新通过 RUBE_MANAGE_CONNECTIONS 授权；执行工具前先检查连接是否仍为 ACTIVE
注意限流：遇到 rate limit 错误时降低请求频率并加入退避；批量任务尤其要控制并发度
列表接口可能分页：优先检查返回中的 next_cursor 或 page_token，循环拉取直到数据取尽
创建前先搜索：新建邮件、标签或其他资源前先按条件查询，降低重复创建的概率
工具能力边界以当前返回为准：Composio toolkit 覆盖的范围会演进，遇到不可用的操作，先查 composio.dev/toolkits/zoho_mail 的官方文档，再考虑是否走替代路径