Voximplant

Agenten erstellen oder auswählen

Erstellen Sie den Agenten in ElevenAgents. Geben Sie ihm eine erste Nachricht, wenn er sprechen soll, sobald der Anruf verbunden ist. Die Audioformate werden von der Integration festgelegt. Die für den Agenten konfigurierten Formate werden für Voximplant-Anrufe nicht verwendet.

Anruf beenden aktivieren

Aktivieren Sie unter Agent → Tools → Systemtools Anruf beenden, damit der Agent die Konversation abschließen kann. Der Grund, den der Agent beim Beenden des Anrufs angibt, wird mit der Entscheidung an Ihr Szenario gesendet.

Voximplant-Weiterleitungsregel hinzufügen (optional)

Damit der Agent den Anrufer an einen Menschen übergeben kann, geben Sie ihm das Systemtool An Nummer weiterleiten mit einer Weiterleitungsregel, deren Provider-Konfiguration voximplant lautet. Die Regel hat kein Ziel: Die Konversation endet mit einer transfer-to-agent-Entscheidung, und Ihr Szenario leitet den Anrufer weiter. Weiterleitungsregeln werden über die API konfiguriert. Fügen Sie das Tool mit einem PATCH für den Agenten hinzu:

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"}}
            ]
          }]
        }
      }
    }}}}
  }'

Senden Sie das vollständige built_in_tools-Objekt des Agenten, einschließlich bereits vorhandener Tools wie end_call. Die Option, die der Agent zurückgibt, ist das feste Token voximplant. Daher reicht eine Voximplant-Regel pro Tool aus. Telefonnummern und SIP-URIs, die für andere Provider konfiguriert sind, werden bei Voximplant-Anrufen nicht angeboten.

Dedizierten API-Schlüssel erstellen

Erstellen Sie einen API-Schlüssel im selben Workspace wie der Agent und beschränken Sie seinen Umfang auf ElevenAgents. Um nur Verbindungen von Voximplant zu akzeptieren, beschränken Sie die zulässigen IP-Adressen des Schlüssels auf die Media- Server von Voximplant, die Voximplant unter https://api.voximplant.com/getMediaResources?with_mediaservers auflistet.

WebSocket-URL notieren

Das Szenario verbindet sich mit einer URL, die Ihre Agenten-ID enthält:

Um einen Branch des Agenten festzulegen, fügen Sie ?branch_id=<branch_id> hinzu.

Anwendung erstellen

Öffnen Sie im Voximplant Control Panel Applications und klicken Sie auf Create application. Geben Sie einen Namen ein, zum Beispiel elevenlabs-agent, und klicken Sie auf Create.

API-Schlüssel als Secret speichern

Öffnen Sie in der Anwendung Secrets und klicken Sie auf Add secret. Nennen Sie es ELEVENLABS_API_KEY, fügen Sie den API-Schlüssel, den Sie für den Workspace des Agenten erstellt haben, unter Value ein und klicken Sie auf Add secret. Das Szenario liest ihn mit VoxEngine.getSecretValue(), sodass der Schlüssel nie im Szenariocode erscheint.

Szenario erstellen

Öffnen Sie Scenarios, klicken Sie auf Create scenario, nennen Sie es elevenlabs_agent, fügen Sie den folgenden Code ein, ersetzen Sie die Agenten-ID in ELEVENLABS_URL und klicken Sie auf Save. Das Szenario nimmt einen eingehenden Anruf entgegen, streamt ihn an den Agenten und handelt nach der Entscheidung, wenn die Konversation endet. Für einen ausgehenden Anruf öffnen Sie den WebSocket im Handler CallEvents.Connected des von Ihnen getätigten Anrufs.

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();
  });
});

Anrufe an das Szenario weiterleiten

Öffnen Sie Routing, klicken Sie auf Create rule, geben Sie ihr einen Namen und weisen Sie das Szenario elevenlabs_agent zu. Das Standardmuster .* leitet jeden Anruf an die Anwendung über das Szenario weiter; beschränken Sie es auf eine Telefonnummer, wenn die Anwendung auch andere Anrufe verarbeitet. Um eine Telefonnummer weiterzuleiten, fügen Sie sie unter Numbers zur Anwendung hinzu.

Testanruf tätigen

Sie können die Anwendung ohne Telefonnummer im Browser anrufen:

1. Öffnen Sie Users, klicken Sie auf Create user und erstellen Sie einen Benutzer mit Passwort.

   

2. Klicken Sie unter Routing auf Test tools und dann auf Softphone. Melden Sie sich als dieser Benutzer an, erlauben Sie den Mikrofonzugriff, geben Sie ein beliebiges Ziel ein und rufen Sie an. Der Agent antwortet mit seiner ersten Nachricht.

3. Öffnen Sie nach Ende des Anrufs Call history. Jeder Anruf führt neben dem Anruf selbst eine WebSocket-Verbindung auf. Klicken Sie auf View log, um die Sitzung anzuzeigen.

   

   Das Protokoll zeigt die von ElevenLabs gesendete Entscheidung, das Schließen des WebSockets und die anschließende Aktion des Szenarios. In diesem Beispiel bat der Anrufer um eine Person, daher lautet die Entscheidung transfer-to-agent mit dem vom Agenten angegebenen Grund.