Freshservice Automation 通过 Rube MCP 和 Composio 的 Freshservice 工具包，实现对 Freshservice IT 服务管理操作的自动化。
用途
该技能用于自动化 Freshservice 中的常见 ITSM 任务，包括工单的创建、更新、批量操作、服务请求提交以及外发邮件通知等。
主要能力
- 列出和搜索工单：支持过滤、分页、按更新时间筛选、排序等。
- 创建工单：可指定主题、描述、状态、优先级、请求者邮箱或 ID、类型、来源、影响和紧急程度。
- 批量更新工单：对多个工单同时更新相同字段。
- 通过外发邮件创建工单：在创建工单的同时发送邮件通知，支持抄送和指定发件邮箱配置。
- 创建服务请求：提交服务目录项请求，支持数量、自定义字段和父工单。
使用方式
- 前提条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；通过 RUBE_MANAGE_CONNECTIONS 激活 Freshservice 连接（工具包 freshservice）；始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
- 设置：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥；确认 RUBE_SEARCH_TOOLS 响应；调用 RUBE_MANAGE_CONNECTIONS 并指定工具包 freshservice；若连接未激活，按返回的认证链接完成 Freshservice 认证；确认连接状态为 ACTIVE 后再运行工作流。
- 核心工作流：
- 列出和搜索工单：使用 FRESHSERVICE_LIST_TICKETS（必需）和 FRESHSERVICE_GET_TICKET（可选）。关键参数包括 filter、updated_since、order_by、order_type、page、per_page、include 等。注意默认仅返回过去 30 天的工单，需用 updated_since 获取更早工单；每个 include 值消耗额外 API 配额；page 从 1 开始；per_page 最大 100，默认 30；工单 ID 可以是内部 ID 或显示 ID。
- 创建工单：使用 FRESHSERVICE_CREATE_TICKET。关键参数包括 subject、description、status、priority、email 或 requester_id、type、source、impact、urgency。注意 subject、description、status、priority 均为必填；必须提供 email 或 requester_id；状态和优先级使用数字代码；描述支持 HTML；若邮箱不匹配现有联系人则创建新联系人。
- 批量更新工单：先使用 FRESHSERVICE_LIST_TICKETS 查找工单，再使用 FRESHSERVICE_BULK_UPDATE_TICKETS。关键参数包括 ids 和 update_fields。允许的键有 subject、description、status、priority、responder_id、group_id、type、tags、custom_fields。注意批量更新内部为顺序执行，大批量可能耗时；所有指定工单接收相同字段更新；单个失败不影响其他；无法在一次调用中为不同工单更新不同字段；自定义字段需使用内部字段名。
- 通过外发邮件创建工单：使用 FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL。关键参数包括 email、subject、description、status、priority、cc_emails、email_config_id、name。注意此操作通过 /api/v2/tickets 端点创建标准工单并发送邮件；若邮箱不匹配现有联系人则用提供的名称创建新联系人；email_config_id 决定通知的发件地址。
- 创建服务请求：使用 FRESHSERVICE_CREATE_SERVICE_REQUEST。关键参数包括 item_display_id、email、quantity、custom_fields、parent_ticket_id。注意 item_display_id 可在 Admin > Service Catalog > 项目 URL 中找到（如 /service_catalog/items/1）；自定义字段键必须匹配服务项目表单字段名；数量默认为 1；服务请求遵循目录项定义的审批流程。
适用场景
适用于需要自动化 Freshservice 工单管理、批量操作、服务请求提交和邮件通知的 IT 服务管理场景。
限制
- 状态和优先级使用数字代码，而非字符串。
- 来源渠道使用数字代码（1-6），影响和紧急程度使用数字代码（1-3 或 1-4）。
- 默认仅返回过去 30 天的工单，需用 updated_since 获取更早工单，日期格式为 ISO 8601。
- Freshservice API 有每账户速率限制，每个 include 选项消耗额外 API 配额，遇到 429 响应需实现退避。
- 响应数据可能嵌套在 data 或 data.data 下，需防御性解析；工单 ID 为数字整数。
快速参考
- 列出工单：FRESHSERVICE_LIST_TICKETS，关键参数 filter、updated_since、page、per_page。
- 获取工单：FRESHSERVICE_GET_TICKET，关键参数 ticket_id、include。
- 创建工单：FRESHSERVICE_CREATE_TICKET，关键参数 subject、description、status、priority、email。
- 批量更新：FRESHSERVICE_BULK_UPDATE_TICKETS，关键参数 ids、update_fields。
- 外发邮件工单：FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL，关键参数 email、subject、description。
- 服务请求：FRESHSERVICE_CREATE_SERVICE_REQUEST，关键参数 item_display_id、email、quantity。