Nadpisania

Nadpisania pozwalają asystentowi dostosować zachowanie do każdej interakcji z użytkownikiem. Na początku każdej rozmowy możesz przekazać własne dane i ustawienia, dzięki czemu asystent spersonalizuje odpowiedzi i wiedzę, korzystając z kontekstu w czasie rzeczywistym. Nadpisania całkowicie zastępują domyślne wartości agenta ustawione w jego panelu.

Omówienie

Nadpisania pozwalają zmieniać zachowanie agenta AI w czasie rzeczywistym bez tworzenia wielu agentów. Dzięki temu możesz personalizować odpowiedzi danymi konkretnego użytkownika.

Nadpisania można włączyć dla następujących pól w ustawieniach zabezpieczeń agenta:

• Prompt systemowy
• Pierwsza wiadomość
• Język
• ID głosu
• LLM (Large Language Model)
• Poziom wysiłku rozumowania LLM
• Narzędzia
• Baza wiedzy
• Tryb tylko tekstowy
• Stabilność
• Szybkość
• Zwiększenie podobieństwa
• Słowa kluczowe ASR
• Procedury

Nadpisanie Procedury nie używa conversation_config_override. Zamiast tego klient przekazuje procedure_ids i start_procedure_ids na najwyższym poziomie danych klienta inicjujących rozmowę. Zobacz Wybieranie procedur dla każdej rozmowy.

Gdy nadpisania są włączone dla danego pola, ich podanie nadal jest opcjonalne. Jeśli ich nie podasz, agent użyje domyślnych wartości ustawionych w jego panelu. W przypadku większości pól wystąpi błąd, jeśli podasz nadpisanie dla pola, w którym nadpisania nie są włączone.

Oto kilka przykładów, gdy nadpisania mogą się przydać:

• Witaj użytkowników po imieniu
• Uwzględniaj dane konkretnego konta w odpowiedziach
• Dostosuj język agenta lub ton do preferencji użytkownika
• Przekazuj dane w czasie rzeczywistym, takie jak saldo konta lub status zamówienia
• Popraw transkrypcję nazw lub terminów z konkretnego połączenia (na przykład nazw firm w CRM) za pomocą słów kluczowych ASR

Przewodnik

Wymagania wstępne

• Konto ElevenLabs
• Skonfigurowany agent konwersacyjny ElevenLabs (utwórz go tutaj)

Ten przewodnik pokazuje, jak nadpisać domyślne ustawienia: prompt systemowy, pierwsza wiadomość, LLM, wysiłek rozumowania, narzędzia, baza wiedzy, ustawienia TTS i słowa kluczowe ASR.

{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "reasoning_effort": "high",
        "tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
        "knowledge_base": [
          {
            "type": "file",
            "name": "Unladen Swallow Facts",
            "id": "5xM3yVvZQKV0EfqQpLrJ",
            "usage_mode": "auto"
          }
        ]
      }
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso", "Globex"]
    }
  }
}

from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
...
conversation_override = {
    "agent": {
        "prompt": {
            "prompt": f"The customer's bank account balance is {customer_balance}. They are based in {customer_location}.", # Optional: override the system prompt.
            "llm": "gpt-4o", # Optional: override the LLM model.
            "reasoning_effort": "high", # Optional: override the reasoning effort. Requires Security → Reasoning effort.
            "tool_ids": [
                "tool_7101k5zvyjhmfg983brhmhkd98n6"
            ], # Optional: replace the tools available to the agent.
            "knowledge_base": [
                {
                    "type": "file",
                    "name": "Unladen Swallow Facts",
                    "id": "5xM3yVvZQKV0EfqQpLrJ",
                    "usage_mode": "auto",
                }
            ], # Optional: replace the knowledge base available to the agent.
        },
        "first_message": f"Hi {customer_name}, how can I help you today?", # Optional: override the first_message.
        "language": "en" # Optional: override the language.
    },
    "tts": {
        "voice_id": "custom_voice_id", # Optional: override the voice.
        "stability": 0.7, # Optional: override stability (0.0 to 1.0).
        "speed": 1.1, # Optional: override speed (0.7 to 1.2).
        "similarity_boost": 0.9 # Optional: override similarity boost (0.0 to 1.0).
    },
    "conversation": {
        "text_only": True # Optional: enable text-only mode (no audio).
    },
    "asr": {
        "keywords": ["Acme Corp", "Contoso"] # Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
    }
}
config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    ...
    config=config,
    ...
)
conversation.start_session()