用途:该技能用于让 AI 智能体通过 Membrane CLI 与 Switchboard 云电话系统交互,管理 Organizations、Users,并处理 Call、Participant、Switchboard Settings、Call History 等数据。官方文档为 https://developers.switchboard.xyz/。
主要能力:可发现并运行预置 action,也可通过 Membrane 代理直接请求 Switchboard API;Membrane 自动处理认证与凭据刷新,并内置分页、字段映射与错误处理。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境会打印授权 URL,完成后运行 membrane login complete <code>。连接:membrane connection ensure "https://www.switchboard.ai/" --json,若 state 为 BUILDING 则用 npx @membranehq/cli connection get <id> --wait --json 轮询。查找 action:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行 action:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。代理请求:membrane request CONNECTION_ID /path/to/endpoint,可配合 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项;任何命令加 --json 可获机器可读输出。
适用场景:需要以自然语言意图查询或操作 Switchboard 组织、用户、通话与通话记录数据时。
限制:应优先使用 Membrane 预置 action,避免自行编写底层 API 调用;不要向用户索取 API key 或 token,应通过创建连接完成认证;若 connection 返回 CONFIGURATION_ERROR 或 SETUP_FAILED,需检查 error 字段。其余具体计费、平台支持等信息资料未提供。