用途:该技能用于让 AI 代理与 GrooveHQ 帮助台软件交互,管理工单、客户、用户、分组、标签和报表等数据。GrooveHQ 是面向小型企业的客服工单系统,用于管理客户支持请求、组织对话并跟踪团队表现。官方文档:https://developers.groovehq.com/
主要能力:通过 Membrane 预置动作完成常见操作,包括列出/获取/创建/更新工单,更新工单负责人与状态,为工单添加标签;列出/获取/创建/更新客户;列出坐席、分组、邮箱与消息,创建消息、创建与更新分组等。动作以自然语言意图检索,返回 id、名称、描述及输入输出 schema。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 GrooveHQ:membrane connection ensure "https://www.groovehq.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 字段。动作未覆盖时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。
适用场景:客服团队自动化处理工单、查询客户信息、分配与流转工单、批量打标签、生成报表数据等。
限制:认证与凭据刷新由 Membrane 服务端管理,不应向用户索取 API key 或 token;具体动作参数与返回字段以实际 schema 为准;资料未提供收费、价格与平台支持等细节。