用途:该技能用于让智能体通过 Membrane CLI 与 LiveChat 客服平台集成,管理聊天会话、消息、预设回复与报表等数据。当用户需要与 LiveChat 数据交互时可使用。
主要能力:涉及 Agent、Conversation、Message、Canned Response 等对象。Membrane 自动处理认证与凭据刷新,无需向用户索取 API key 或 token。可用预置 action 完成常见操作,也可通过代理直接请求 LiveChat API。
使用方式:
- 安装 CLI:npm install -g @membranehq/cli@latest
- 登录:membrane login --tenant --clientName=<agentType>,无交互环境会输出授权 URL,用户完成登录后用 membrane login complete <code> 完成。命令可加 --json 输出机器可读 JSON。
- 连接 LiveChat:membrane connection ensure "https://www.livechat.com/" --json。若返回 state 为 READY 即可继续;若为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪;若为 CLIENT_ACTION_REQUIRED,需按 clientAction 提示完成认证或提供输入;若为 CONFIGURATION_ERROR 或 SETUP_FAILED,查看 error 字段。
- 搜索 action:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。
- 运行 action: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 等选项。
适用场景:客服、销售、营销团队相关的会话管理、消息收发、报表查询等数据交互任务。
限制与说明:官方文档见 https://developers.livechat.com/。应优先使用预置 action 而非原始 API 调用,以减少 token 消耗并提升安全性;使用前先在特定连接上下文内搜索 action。具体可用 action 列表、参数细节、平台支持范围及收费信息暂未提供。