---

name: helpdesk-automation description: "通过 Rube MCP (Composio) 自动化 HelpDesk 任务：列出工单、管理视图、使用预设回复和配置自定义字段。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 HelpDesk 自动化

通过 Composio 的 HelpDesk 工具包经由 Rube MCP 自动化 HelpDesk 工单操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 helpdesk 建立活跃的 HelpDesk 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 helpdesk 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 HelpDesk 认证
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 列出和浏览工单

使用时机：用户想要检索、浏览或分页查看支持工单

工具序列：

1. HELPDESK_LIST_TICKETS - 列出工单（支持排序和分页）[必需]

关键参数：

• silo：工单文件夹 - 'tickets'、'archive'、'trash' 或 'spam'（默认：'tickets'）
• sortBy：排序字段 - 'createdAt'、'updatedAt' 或 'lastMessageAt'（默认：'createdAt'）
• order：排序方向 - 'asc' 或 'desc'（默认：'desc'）
• pageSize：每页结果数，1-100（默认：20）
• next.value：向前分页的时间戳游标
• next.ID：向前分页的 ID 游标
• prev.value：向后分页的时间戳游标
• prev.ID：向后分页的 ID 游标

注意事项：

• 分页使用基于游标的方式，需要时间戳 + ID 对
• 向前分页需要上一次响应中的 next.value 和 next.ID
• 向后分页需要 prev.value 和 prev.ID
• silo 决定从哪个文件夹列出；默认是活跃工单
• pageSize 最大为 100；默认为 20
• 已归档和已删除的工单在单独的 silo 中

2. 管理工单视图

使用时机：用户想要查看用于组织工单的已保存客服视图

工具序列：

1. HELPDESK_LIST_VIEWS - 列出所有客服视图 [必需]

关键参数：（无需参数）

注意事项：

• 视图是客服在 HelpDesk UI 中配置的预定义保存筛选器
• 视图定义包含可用于理解工单组织方式的筛选条件
• 视图无法通过 API 创建或修改；它们在 HelpDesk UI 中管理

3. 使用预设回复

使用时机：用户想要列出可用于工单的预设（模板）回复

工具序列：

1. HELPDESK_LIST_CANNED_RESPONSES - 检索所有预定义回复模板 [必需]

关键参数：（无需参数）

注意事项：

• 预设回复是用于常见回复的预定义模板
• 它们可能包含需要填写的占位符变量
• 预设回复通过 HelpDesk UI 管理
• 回复内容可能包含 HTML 格式

4. 检查自定义字段

使用时机：用户想要查看账户的自定义字段定义

工具序列：

1. HELPDESK_LIST_CUSTOM_FIELDS - 列出所有自定义字段定义 [必需]

关键参数：（无需参数）

注意事项：

• 自定义字段使用组织特定数据扩展默认工单 schema
• 字段定义包含字段类型、名称和验证规则
• 自定义字段在 HelpDesk 管理面板中配置
• 字段值在字段被填充时显示在工单上

常见模式

工单浏览模式

1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy
2. Process the returned page of tickets
3. Extract next.value and next.ID from the response
4. Call HELPDESK_LIST_TICKETS with those cursor values for next page
5. Continue until no more cursor values are returned

工单文件夹导航

Active tickets:  silo='tickets'
Archived:        silo='archive'
Trashed:         silo='trash'
Spam:            silo='spam'

基于游标的分页

Forward pagination:
  - Use next.value (timestamp) and next.ID from response
  - Pass as next.value and next.ID parameters in next call

Backward pagination:
  - Use prev.value (timestamp) and prev.ID from response
  - Pass as prev.value and prev.ID parameters in next call

已知注意事项

游标分页：

• 游标导航需要时间戳和 ID 两者
• 游标值是 ISO 8601 日期时间格式的时间戳
• 在同一请求中混合使用向前和向后游标是未定义行为

Silo 筛选：

• 工单物理上分隔在不同的 silo（文件夹）中
• 在 silo 之间移动工单在 HelpDesk UI 中完成
• 每个 silo 查询是独立的