helpdesk-automation

通过 Rube MCP 自动化 HelpDesk

通过 Rube MCP 使用 Composio 的 HelpDesk 工具包，自动化 HelpDesk 工单操作。

工具包文档：composio.dev/toolkits/helpdesk

前提条件

• 必须连接 Rube MCP（可用 RUBE_SEARCH_TOOLS）
• 通过工具包为 helpdesk 的 RUBE_MANAGE_CONNECTIONS 建立有效的 HelpDesk 连接
• 始终先调用 RUBE_SEARCH_TOOLS，以获取最新的工具架构

设置

获取 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
• 已归档和已移至回收站的工单位于不同的分区中

2. 管理工单视图

适用场景：用户希望查看已保存的 Agent 视图，以便整理工单

工具调用顺序：

1. HELPDESK_LIST_VIEWS — 列出所有 Agent 视图［必需］

关键参数：（无必需参数）

注意事项：

• 视图是 Agent 在 HelpDesk UI 中配置的预定义已保存筛选条件
• 视图定义包含筛选条件，可用于了解工单的整理方式
• 无法通过 API 创建或修改视图；视图需在 HelpDesk UI 中管理

3. 使用预设回复

适用场景：用户希望列出可用于工单的预设（模板）回复

工具调用顺序：

1. HELPDESK_LIST_CANNED_RESPONSES — 获取所有预定义回复模板［必需］

关键参数：（无必需参数）

注意事项：

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

4. 查看自定义字段

适用场景：用户希望查看账户的自定义字段定义

工具调用顺序：

1. HELPDESK_LIST_CUSTOM_FIELDS — 列出所有自定义字段定义［必需］

关键参数：（无必需参数）

注意事项：

• 自定义字段可为默认工单架构添加组织专属数据
• 字段定义包含字段类型、名称和验证规则
• 自定义字段在 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 界面中完成
• 每个 silo 查询彼此独立；无法跨 silo 搜索

只读操作：

• 当前 Composio 工具包提供列表和读取操作
• 创建、更新和回复工单可能需要其他工具
• 查看 RUBE_SEARCH_TOOLS，了解是否有新工具可用

速率限制：

• HelpDesk API 对每个账户设有速率限制
• 收到 429 响应时实施退避
• 使用合理的页面大小以避免超时

响应解析：

• 响应数据可能嵌套在 data 或 data.data 下
• 使用备用模式进行防御性解析
• 工单 ID 是字符串

快速参考

任务	工具标识	关键参数
列出工单	HELPDESK_LIST_TICKETS	silo、sortBy、order、pageSize
列出视图	HELPDESK_LIST_VIEWS	（无）
列出预设回复	HELPDESK_LIST_CANNED_RESPONSES	（无）
列出自定义字段	HELPDESK_LIST_CUSTOM_FIELDS	（无）

---

由 Composio 提供支持