用途:该技能用于与 SuccessWare21 数据交互,管理数据、记录并自动化工作流。SuccessWare21 本身是面向 HVAC、管道和电气服务承包商的综合业务管理软件,覆盖从调度派工到会计与报表的运营流程,使用者包括承包商、服务经理和会计人员。
主要数据对象:Customer(客户)、Customer Equipment(客户设备)、Location(地点)、Work Order(工单)、Work Order Task(工单任务)、Employee(员工)、Opportunity(商机)。
使用方式:通过 Membrane CLI 与 SuccessWare21 交互,Membrane 自动处理认证与凭据刷新。安装:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无界面环境会打印授权 URL,完成后执行 membrane login complete <code>。任何命令可加 --json 输出机器可读 JSON。连接:membrane connection ensure "https://successware21.com" --json,用户在浏览器完成认证;若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询,状态 READY 即就绪,CLIENT_ACTION_REQUIRED 需按 clientAction 描述完成操作。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。当动作不覆盖需求时,可用代理直接请求 API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与注意事项:官方文档见 https://successware21.zendesk.com/hc/en-us,其余平台支持范围、收费、配额等信息暂未提供。建议优先使用预置动作,先搜索再自建请求,不要让用户提供 API 密钥或令牌。