SuperAPI AI 工具集

servicem8

办公与效率

查看项目

更新于 10-16 09:32

技能介绍

用途:ServiceM8 是针对电工、水管工、暖通空调技师等贸易企业的现场服务管理软件,帮助集中管理工单、排程、开票和客户沟通,本质上是面向中小型服务企业的移动优先 CRM 与运营工具。官方文档:https://developer.servicem8.com/

主要能力(涵盖的实体):客户端、站点、工单、员工、材料、报价、发票、清单模板、表单、短信、邮件。

使用方式(基于 Membrane CLI):

  1. 安装:npm install -g @membranehq/cli@latest
  2. 登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,完成登录后用 membrane login complete <code>。加 --json 获得机器可读输出。
  3. 建立连接:membrane connection ensure "https://servicem8.com" --json;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY。
  4. 搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。
  5. 运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,可用 --input '{"key": "value"}' 传参。
  6. 代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。

适用场景:需要在 agent 中读取或操作 ServiceM8 的客户、工单、报价、发票、员工、物料等业务数据时。

限制与说明:Membrane 自动处理认证与凭证刷新,无需向用户索取 API Key;应优先使用预置动作而非自行编写 API 调用。具体可用动作、参数结构及 ServiceM8 API 的字段细节,本资料未逐一提供,需运行时通过 action list 与官方文档确认。