Voximplant

创建或选择智能体

在 ElevenAgents 中创建智能体。如果希望通话一接通就说话，请为其设置首条消息。 音频格式由集成设置，因此不会使用智能体配置的格式 处理 Voximplant 通话。

启用结束通话

在 智能体 → 工具 → 系统工具 中启用 结束通话，让智能体能够结束对话。 智能体结束通话时提供的原因会随决策一起发送到场景。

添加 Voximplant 转接规则（可选）

如需让智能体将来电者转接给人工，请为其添加 转接至号码 系统工具，并设置提供商配置为 voximplant 的 转接规则。该规则没有目标号码：对话将以 transfer-to-agent 决策结束，由场景负责路由来电者。 转接规则通过 API 配置。使用 PATCH 请求为智能体添加该工具：

curl -X PATCH "https://api.elevenlabs.io/v1/convai/agents/agent_7101k5zvyjhmfg983brhmhkd98n6" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "conversation_config": {"agent": {"prompt": {"built_in_tools": {
      "end_call": {"type": "system", "name": "end_call", "description": "",
                   "params": {"system_tool_type": "end_call"}},
      "transfer_to_number": {
        "type": "system", "name": "transfer_to_number", "description": "",
        "params": {
          "system_tool_type": "transfer_to_number",
          "transfers": [],
          "transfer_rules": [{
            "condition": "the caller asks to speak with a human",
            "provider_configs": [
              {"type": "voximplant", "config": {"type": "voximplant_handoff"}}
            ]
          }]
        }
      }
    }}}}
  }'

发送智能体完整的 built_in_tools 对象，包括其已有的工具，例如 end_call。 智能体返回的选项是固定令牌 voximplant，因此每个工具只需一条 Voximplant 规则。 为其他提供商配置的电话号码和 SIP URI 不会用于 Voximplant 通话。

创建专用 API 密钥

在与智能体相同的工作区中创建 API 密钥，并将其范围限定为 ElevenAgents。如需仅接受来自 Voximplant 的 连接，请将密钥允许的 IP 地址限制为 Voximplant 的媒体服务器，Voximplant 在以下地址列出了这些服务器： https://api.voximplant.com/getMediaResources?with_mediaservers。

记录 WebSocket URL

场景会连接到一个包含智能体 ID 的 URL：

如需固定使用智能体的某个分支，请添加 ?branch_id=<branch_id>。

创建应用

在 Voximplant 控制面板中，打开 Applications， 然后点击 Create application。为应用命名，例如 elevenlabs-agent，然后点击 Create。

将 API 密钥存为密钥

在应用中，打开 Secrets 并点击 Add secret。将其命名为 ELEVENLABS_API_KEY，把为智能体工作区创建的 API 密钥粘贴到 Value，然后点击 Add secret。场景通过 VoxEngine.getSecretValue() 读取密钥， 因此密钥不会出现在场景代码中。

创建场景

打开 Scenarios，点击 Create scenario，将其命名为 elevenlabs_agent，粘贴以下代码， 替换 ELEVENLABS_URL 中的智能体 ID，然后点击 Save。它会接听呼入电话，将其流式传输给智能体， 并在对话结束时根据决策执行操作。对于呼出电话，请在所发起通话的 CallEvents.Connected 处理程序中打开 WebSocket。

const ELEVENLABS_URL =
  "wss://api.elevenlabs.io/v1/convai/conversation/voximplant/agent_7101k5zvyjhmfg983brhmhkd98n6";
VoxEngine.addEventListener(AppEvents.CallAlerting, ({ call }) => {
  call.answer();
  let decision = null;
  const ws = VoxEngine.createWebSocket(ELEVENLABS_URL, {
    headers: [
      {
        name: "Authorization",
        value: `Bearer ${VoxEngine.getSecretValue("ELEVENLABS_API_KEY")}`,
      },
    ],
  });
  ws.addEventListener(WebSocketEvents.OPEN, () => {
    call.sendMediaTo(ws, {
      encoding: WebSocketAudioEncoding.PCM16_8KHZ,
      customParameters: { customer_name: "Ana", task_id: "task-7" },
    });
    ws.sendMediaTo(call);
  });
  ws.addEventListener(WebSocketEvents.MESSAGE, ({ text }) => {
    const message = JSON.parse(text);
    if (message.customEvent === "elevenlabs-decision") {
      decision = message.payload;
      Logger.write(`ElevenLabs decision: ${JSON.stringify(decision)}`);
    }
  });
  ws.addEventListener(WebSocketEvents.CLOSE, (e) => {
    Logger.write(`ElevenLabs socket closed: code=${e.code} reason=${e.reason}`);
    if (decision?.action === "transfer-to-agent") {
      // Route the caller to a human here, for example with VoxEngine.callPSTN().
      call.say("Connecting you to an agent.", { language: VoiceList.Amazon.en_US_Joanna });
      call.addEventListener(CallEvents.PlaybackFinished, () => call.hangup());
      return;
    }
    call.hangup();
  });
  call.addEventListener(CallEvents.Disconnected, () => {
    ws.close();
    VoxEngine.terminate();
  });
});

将通话路由到场景

打开 Routing，点击 Create rule，为规则命名，并分配 elevenlabs_agent 场景。默认模式 .* 会将应用的每通电话通过该场景处理； 如果应用还处理其他通话，请将其限制为特定电话号码。要路由电话号码，请在 Numbers 下将其附加到应用。

拨打测试电话

无需电话号码，也可以通过浏览器呼叫应用：

1. 打开 Users，点击 Create user，然后创建一个设有密码的用户。

   

2. 在 Routing 中，点击 Test tools，然后点击 Softphone。以该用户身份登录，允许 访问麦克风，输入任意目标号码后拨号。智能体会以首条消息接听。

3. 通话结束后，打开 Call history。每通电话会在通话记录旁列出一个 WebSocket 分支。 点击 View log 查看会话。

   

   日志会显示 ElevenLabs 发送的决策、WebSocket 关闭以及场景接下来执行的操作。 在本示例中，来电者请求转人工，因此决策为 transfer-to-agent， 并附带智能体给出的原因。