用途:该技能用于与云端联络中心软件 Talkdesk 交互,管理数据、记录并自动化工作流,适用于需要访问 Talkdesk 数据的场景。官方开发者文档:https://developers.talkdesk.com/。
主要能力:涉及 Agent、Availability、Contact、Call、Account 等对象,可按需使用相应动作名称与参数。底层通过 Membrane CLI 与 Talkdesk 通信,Membrane 自动处理认证与凭据刷新。
安装与登录:安装命令为 npm install -g @membranehq/cli@latest;登录命令为 membrane login --tenant --clientName=<agentType>。交互模式下会打开浏览器,否则打印授权 URL;无头环境需让用户在浏览器打开 URL,完成后用 membrane login complete <code> 结束。命令加 --json 可输出机器可读 JSON。
连接:使用 membrane connection ensure "https://talkdesk.com" --json 查找或创建连接,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY;CLIENT_ACTION_REQUIRED 时按 clientAction 提示处理(connect、provide-input);CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。
查找与运行动作:用 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 直接调用 Talkdesk API,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
最佳实践:优先使用 Membrane 预置动作;先搜索再自建;不要让用户提供 API key 或 token,而是创建连接。
限制:资料未提供具体动作清单、权限范围、速率限制与定价信息。