用途:该技能用于让用户与 SignalWire 数据交互。SignalWire 是一个云通信平台,为语音、视频和消息提供 API,开发者可借此在应用中构建通信功能。官方文档见 https://developer.signalwire.com/。该技能通过 Membrane CLI 与 SignalWire 交互,Membrane 自动处理认证与凭据刷新。
主要覆盖对象包括:Phone Number、Call、Participant、Messaging、Message、Task、Space、User、API Key、Project。
使用方式:
- 安装 CLI:npm install -g @membranehq/cli@latest
- 认证:membrane login --tenant --clientName=<agentType>;无界面环境会输出授权 URL,完成后执行 membrane login complete <code>。
- 建立连接:membrane connection ensure "https://signalwire.com/" --json,用户在浏览器完成认证。若状态为 BUILDING,用 npx @membranehq/cli@latest 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 --json,可用 --input '{"key": "value"}' 传参。
- 代理请求:当动作不足时使用 membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。
建议:优先使用 Membrane 与外部应用通信;先搜索现有动作再自行构建;由 Membrane 管理凭据,不要向用户索取 API key。具体可用的动作列表和完整参数需通过 action list 查询,资料未逐一提供。