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