SuperAPI AI 工具集

freshservice-automation

办公与效率

查看项目

更新于 10-15 20:26

技能介绍

用途:通过 Composio 的 Freshservice 工具包,经 Rube MCP 自动化 Freshservice IT 服务管理操作,如工单查询、创建、批量更新、外发邮件建单和服务目录请求。

主要能力:

  1. 列出与搜索工单:FRESHSERVICE_LIST_TICKETS 支持 filter、updated_since、order_by、order_type、page、per_page、include 等参数;FRESHSERVICE_GET_TICKET 获取单个工单详情。
  2. 创建工单:FRESHSERVICE_CREATE_TICKET,subject、description、status、priority 必填,需提供 email 或 requester_id。
  3. 批量更新:FRESHSERVICE_BULK_UPDATE_TICKETS,传入 ids 与 update_fields,所有工单应用相同字段更新。
  4. 外发邮件建单:FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL,支持 cc_emails、email_config_id、name。
  5. 服务请求:FRESHSERVICE_CREATE_SERVICE_REQUEST,需 item_display_id,可选 email、quantity、custom_fields、parent_ticket_id。

使用方式:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,确认 RUBE_SEARCH_TOOLS 可用;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit freshservice,若连接非 ACTIVE 则按返回的授权链接完成认证。每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

状态码:2=Open、3=Pending、4=Resolved、5=Closed;优先级:1=Low、2=Medium、3=High、4=Urgent。

限制:默认仅返回最近 30 天工单,需用 updated_since 获取更早数据;page 从 1 开始,per_page 最大 100、默认 30;include 会额外消耗 API 额度;存在账户级速率限制,遇 429 需退避;响应数据可能嵌套在 data 或 data.data 下,需防御性解析;批量更新为顺序执行,大批量可能耗时,且无法为不同工单设置不同字段。

工具包文档:composio.dev/toolkits/freshservice。