helpdesk-automation

通过 Rube MCP 自动化 HelpDesk

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

前提条件

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

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。请确认客户端当前的 MCP 身份验证流程和账户权限；仅添加端点并不能建立经过身份验证的 HelpDesk 连接。

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 界面中配置的预定义已保存筛选条件
• 视图定义包含筛选条件，可用于了解工单的整理方式
• 无法通过 API 创建或修改视图；需在 HelpDesk 界面中管理

3. 使用预设回复

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

工具调用顺序：

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

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

注意事项：

• 预设回复是用于常见回复的预定义模板
• 其中可能包含需要填写的占位变量
• 预设回复通过 HelpDesk 界面管理
• 回复内容可能包含 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 UI 中完成
• 每个 silo 查询都是独立的；不存在跨 silo 搜索

只读操作：

• 当前 Composio 工具包提供列表/读取操作
• 工单创建、更新和回复操作可能需要额外的工具
• 查看 RUBE_SEARCH_TOOLS 以了解任何新可用的工具

速率限制：

• HelpDesk API 有按账户的速率限制
• 对 429 响应实施退避
• 保持合理的分页大小以避免超时

响应解析：

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

快速参考

任务	工具 Slug	关键参数
列出工单	HELPDESK_LIST_TICKETS	silo, sortBy, order, pageSize
列出视图	HELPDESK_LIST_VIEWS	(无)
列出预设回复	HELPDESK_LIST_CANNED_RESPONSES	(无)
列出自定义字段	HELPDESK_LIST_CUSTOM_FIELDS	(无)

何时使用

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅当任务与上述范围明确匹配时才使用此技能。
• 不要将输出视为特定环境验证、测试或专家评审的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。