Voximplant

Utwórz lub wybierz agenta

Utwórz agenta w ElevenAgents. Ustaw mu pierwszą wiadomość, jeśli ma zacząć mówić od razu po połączeniu. Formaty audio są ustawiane przez integrację, więc skonfigurowane formaty agenta nie są używane w rozmowach Voximplant.

Włącz Zakończ połączenie

W Agent → Tools → System tools włącz End call, aby agent mógł zakończyć rozmowę. Powód podany przez agenta przy kończeniu połączenia jest wysyłany do scenariusza wraz z decyzją.

Dodaj regułę przekazania Voximplant (opcjonalnie)

Aby agent mógł przekazać dzwoniącego człowiekowi, dodaj mu narzędzie systemowe Transfer to number z regułą przekazania, której konfiguracja dostawcy to voximplant. Reguła nie ma miejsca docelowego: rozmowa kończy się decyzją transfer-to-agent, a dzwoniącego przekierowuje twój scenariusz. Reguły przekazania konfiguruje się przez API. Dodaj narzędzie przez PATCH na agencie:

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

Wyślij pełny obiekt built_in_tools agenta, w tym narzędzia, które już ma, takie jak end_call. Opcja, którą agent odsyła, to stały token voximplant, więc wystarczy jedna reguła Voximplant na narzędzie. Numery telefonów i identyfikatory URI SIP skonfigurowane dla innych dostawców nie są dostępne w rozmowach Voximplant.

Utwórz osobny klucz API

Utwórz klucz API w tym samym obszarze roboczym co agent i ogranicz jego zakres do ElevenAgents. Aby akceptować połączenia tylko z Voximplant, ogranicz dozwolone adresy IP klucza do serwerów mediów Voximplant, które Voximplant podaje pod adresem https://api.voximplant.com/getMediaResources?with_mediaservers.

Zanotuj adres URL WebSocket

Scenariusz łączy się z adresem URL zawierającym ID twojego agenta:

Aby przypiąć gałąź agenta, dodaj ?branch_id=<branch_id>.

Utwórz aplikację

W panelu Voximplant otwórz Applications i kliknij Create application. Nadaj jej nazwę, na przykład elevenlabs-agent, a następnie kliknij Create.

Zapisz klucz API jako sekret

W aplikacji otwórz Secrets i kliknij Add secret. Nazwij go ELEVENLABS_API_KEY, wklej klucz API utworzony dla obszaru roboczego agenta w polu Value i kliknij Add secret. Scenariusz odczytuje go przez VoxEngine.getSecretValue(), więc klucz nigdy nie pojawia się w kodzie scenariusza.

Utwórz scenariusz

Otwórz Scenarios, kliknij Create scenario, nazwij go elevenlabs_agent, wklej kod poniżej, zastąp ID agenta w ELEVENLABS_URL i kliknij Save. Odbiera on połączenie przychodzące, przesyła je strumieniowo do agenta i wykonuje działanie zgodne z decyzją po zakończeniu rozmowy. W przypadku połączenia wychodzącego otwórz WebSocket w procedurze obsługi CallEvents.Connected wykonanego połączenia.

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

Przekieruj połączenia do scenariusza

Otwórz Routing, kliknij Create rule, nadaj jej nazwę i przypisz scenariusz elevenlabs_agent. Domyślny wzorzec .* wysyła każde połączenie do aplikacji przez scenariusz; zawęź go do numeru telefonu, jeśli aplikacja obsługuje także inne połączenia. Aby przekierować numer telefonu, przypisz go do aplikacji w sekcji Numbers.

Wykonaj połączenie testowe

Możesz zadzwonić do aplikacji z przeglądarki bez numeru telefonu:

1. Otwórz Users, kliknij Create user i utwórz użytkownika z hasłem.

   

2. W Routing kliknij Test tools, a potem Softphone. Zaloguj się jako ten użytkownik, zezwól na dostęp do mikrofonu, wpisz dowolny cel i zadzwoń. Agent odbierze połączenie swoją pierwszą wiadomością.

3. Po zakończeniu połączenia otwórz Call history. Przy każdym połączeniu widnieje odcinek WebSocket obok samego połączenia. Kliknij View log, aby zobaczyć sesję.

   

   Dziennik pokazuje decyzję wysłaną przez ElevenLabs, zamknięcie WebSocket i kolejne działanie scenariusza. W tym przykładzie dzwoniący poprosił o rozmowę z człowiekiem, więc decyzja to transfer-to-agent z powodem podanym przez agenta.