用途:这是面向 Mojo Helpdesk 的集成技能。Mojo Helpdesk 是客服团队使用的工单系统,用于跟踪、排序并响应客户咨询,常见于中小型企业。该技能适合用户需要与 Mojo Helpdesk 数据交互时使用,可围绕工单(Ticket)、评论(Comment)、用户(User)、组织(Organization)进行查询与操作,官方文档见 https://mojohelpdesk.zendesk.com/hc/en-us。
主要能力:通过 Membrane 调用 Mojo Helpdesk,支持查找或创建连接、搜索可用动作、运行动作,以及在预置动作不足时通过代理直接请求 Mojo Helpdesk API。Membrane 负责认证和凭证刷新,无需向用户索取 API 密钥或令牌。
安装与认证:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,可能打开浏览器或输出授权 URL;无头环境需让用户在浏览器打开授权链接,完成后执行 membrane login complete <code>。任何命令可加 --json 获得机器可读输出。agentType 可用 claude、openclaw、codex、warp、windsurf 等。
连接:membrane connection ensure "https://www.mojohelpdesk.com" --json,用户在浏览器完成认证后得到连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询;状态 READY 即可用;CLIENT_ACTION_REQUIRED 时按 clientAction 描述处理(如 connect、provide-input),完成后再次轮询。
搜索与运行动作:先按意图搜索,如 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。运行:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。结果在响应的 output 字段。
代理请求:membrane request CONNECTION_ID /path/to/endpoint,常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
限制与说明:具体可用动作、字段和报告范围需以实际搜索到的 action 为准,资料未给出完整动作清单;使用前需具备 Membrane 账号与有效连接。建议优先使用预置动作而非自建 API 调用,并让 Membrane 管理凭证。