SuperAPI AI 工具集

freshservice-automation

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

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

使用前提:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);已通过 RUBE_MANAGE_CONNECTIONS 以 freshservice 工具包建立连接并处于 ACTIVE;运行工作流前始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

接入步骤:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit freshservice;若连接非 ACTIVE,按返回的授权链接完成认证,确认 ACTIVE 后再执行工作流。

主要能力与参数:列表/搜索工单使用 FRESHSERVICE_LIST_TICKETS(filter、updated_since、order_by、order_type、page、per_page、include)配合 FRESHSERVICE_GET_TICKET;创建工单使用 FRESHSERVICE_CREATE_TICKET,subject、description、status、priority 为必填,且需提供 email 或 requester_id;批量更新使用 FRESHSERVICE_BULK_UPDATE_TICKETS,需 ids 与 update_fields,所有工单应用相同更新;对外邮件建单使用 FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL,需 email、subject 等;服务请求使用 FRESHSERVICE_CREATE_SERVICE_REQUEST,需 item_display_id。状态码 2 开、3 待处理、4 已解决、5 已关闭;优先级 1 低、2 中、3 高、4 紧急。

限制:默认仅返回近 30 天工单,需用 updated_since(ISO 8601)查询更早数据;page 从 1 开始,per_page 最大 100、默认 30;include 会额外消耗 API 配额;存在账户级速率限制,遇到 429 应退避重试;响应数据可能嵌套在 data 或 data.data 下;状态、优先级、来源、影响、紧急度均为数字编码;批量更新为内部串行执行,无法按工单单条差异化字段;自定义字段须用内部字段名。仅在任务明确匹配上述范围时使用,输出不能替代环境验证、测试或专家评审;若缺少必需输入、权限、安全边界或成功标准应停止并询问。