Personalizacja

Omówienie

Personalizacja pozwala dostosować zachowanie agenta do każdego użytkownika, dzięki czemu rozmowy są bardziej naturalne i lepiej dopasowane do kontekstu. ElevenLabs oferuje kilka metod personalizacji:

1. Zmienne dynamiczne — wstawiaj wartości w czasie działania do promptów i wiadomości
2. Nadpisania — całkowicie zastępuj prompty systemowe lub wiadomości
3. Webhooki rozpoczęcia rozmowy — pobieraj dane z serwera przy rozpoczęciu rozmowy

Metody personalizacji

Struktura danych klienta inicjującego rozmowę

Obiekt conversation_initiation_client_data określa, co można dostosować przy rozpoczynaniu rozmowy. Klienci mogą wysyłać go bezpośrednio. Webhook rozpoczęcia rozmowy zwraca ten sam obiekt.

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "overriding system prompt",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "overriding first message",
      "language": "en"
    },
    "tts": {
      "voice_id": "voice-id-here"
    },
    "conversation": {
      "text_only": false
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso"]
    }
  },
  "custom_llm_extra_body": {
    "temperature": 0.7,
    "max_tokens": 100
  },
  "dynamic_variables": {
    "string_var": "text value",
    "number_var": 1.2,
    "integer_var": 123,
    "boolean_var": true
  },
  "user_id": "your_custom_user_id",
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

Webhooki rozpoczęcia rozmowy

W przypadku telefonii i wiadomości przychodzących ElevenAgents może pobierać te dane inicjujące z twojego serwera zamiast od klienta. Gdy webhook jest włączony, ElevenAgents wysyła żądanie POST i stosuje zwrócony JSON.

Skonfiguruj adres URL webhooka i sekrety nagłówków w ustawieniach Agents. Na karcie Security agenta włącz Fetch initiation client data from a webhook oraz wszystkie pola nadpisań, które może zawierać odpowiedź.

Webhook działa dla nowej rozmowy przychodzącej przez Twilio voice, Exotel, SIP trunk, WhatsApp lub Twilio SMS, gdy dane inicjujące klienta nie są jeszcze dostępne. Działa też dla sesji Amazon Connect, gdzie odpowiedź jest łączona z kontekstem kontaktu dostarczanym przez Amazon Connect.

Połączenia wychodzące Twilio voice, Exotel, SIP i WhatsApp uruchamiają go tylko wtedy, gdy żądanie wychodzące nie zawierało conversation_initiation_client_data. Wychodzące wiadomości WhatsApp nigdy go nie uruchamiają — przekaż zamiast tego zmienne dynamiczne w żądaniu wychodzącym.

Nie działa on w rozmowach przez widget lub SDK, innych integracjach wiadomości ani we wznowionych wątkach WhatsApp i SMS.

ElevenAgents wysyła kontekst dzwoniącego w treści żądania:

{
  "caller_id": "+15551234567",
  "called_number": "+15557654321",
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "conversation_id": "conv_8901k5zvyjhmfg983brhmhkd98n6"
}

caller_id i called_number to numery telefonów w Twilio, Exotel, SIP i SMS. W przychodzącym WhatsApp są to identyfikator użytkownika WhatsApp i identyfikator numeru telefonu WhatsApp. W połączeniach wychodzących caller_id to twój numer, a called_number to numer osoby, do której dzwonisz. call_sid to SID połączenia dostawcy w telefonii oraz pusty ciąg w WhatsApp, SMS i Amazon Connect. Połączenia SIP mogą także zawierać call_id i sip_headers. Sesje Amazon Connect zawierają call_id ustawione na identyfikator kontaktu.

Twoja odpowiedź musi mieć powyższą strukturę conversation_initiation_client_data. Uwzględnij każdą niestandardową zmienną dynamiczną zdefiniowaną przez agenta. Nadpisania są opcjonalne i muszą być włączone w Security. Treść odpowiedzi HTTP musi mieć maksymalnie 256 KB (262 144 bajty).

Nieudany webhook lub przekroczenie limitu czasu może uniemożliwić rozpoczęcie rozmowy. Konfigurację Twilio opisuje Personalizacja Twilio. Ten webhook jest oddzielny od webhooków po rozmowie.

Wybór właściwego podejścia

Dowiedz się więcej

• Dokumentacja zmiennych dynamicznych
• Dokumentacja nadpisań
• Personalizacja Twilio