Skip to navigation
ConfigurerenPersonalisatie

Overschrijvingen

Stem elk gesprek af met gepersonaliseerde context voor elke gebruiker.

Hoewel overschrijvingen nog steeds worden ondersteund voor het volledig vervangen van systeemprompts of eerste berichten, raden we aan dynamische variabelen te gebruiken als voorkeursmethode om de antwoorden van je agent aan te passen en realtimegegevens in te voegen. Dynamische variabelen bieden beter onderhoudsgemak en een meer gestructureerde aanpak voor personalisatie.

Met overschrijvingen kan je assistent zijn gedrag aanpassen aan elke gebruikersinteractie. Je kunt aan het begin van elk gesprek aangepaste gegevens en instellingen doorgeven, zodat de assistent zijn antwoorden en kennis kan personaliseren met realtimecontext. Overschrijvingen vervangen de standaardwaarden van de agent die zijn gedefinieerd in het dashboard van de agent volledig.

Overzicht

Met overschrijvingen kun je het gedrag van je AI-agent realtime aanpassen zonder meerdere agents te maken. Zo kun je antwoorden personaliseren met gebruikersspecifieke gegevens.

Overschrijvingen kunnen worden ingeschakeld voor de volgende velden in de beveiligingsinstellingen van de agent:

  • Systeemprompt
  • Eerste bericht
  • Taal
  • Stem-ID
  • LLM (Large Language Model)
  • Tools
  • Kennisbank
  • Alleen-tekstmodus
  • Stabiliteit
  • Snelheid
  • Similarity boost
  • ASR-trefwoorden
  • Procedures

De overschrijving Procedures gebruikt geen conversation_config_override. In plaats daarvan geeft de client procedure_ids en start_procedure_ids op het hoogste niveau van de clientgegevens voor het starten van het gesprek door. Zie Procedures per gesprek kiezen.

Wanneer overschrijvingen voor een veld zijn ingeschakeld, is het opgeven van een overschrijving nog steeds optioneel. Als je er geen opgeeft, gebruikt de agent de standaardwaarden die zijn gedefinieerd in het dashboard van de agent. Voor de meeste velden wordt een fout gegenereerd als je een overschrijving opgeeft terwijl overschrijvingen voor dat veld niet zijn ingeschakeld.

ASR-trefwoorden gebruiken een zachte weigering: als de beveiligingsschakelaar uit staat en de client toch asr.keywords verstuurt, gaat het gesprek door en worden de trefwoorden genegeerd (zonder fout). Schakel de overschrijving voor ASR-trefwoorden in de beveiligingsinstellingen in wanneer je boosting van trefwoorden per gesprek wilt toepassen. Per gesprek worden maximaal 50 trefwoorden ondersteund.

Hier zijn enkele voorbeelden waarin overschrijvingen nuttig kunnen zijn:

  • Begroet gebruikers met hun naam
  • Neem ანგარიშspecifieke gegevens op in antwoorden
  • Pas de taal of toon van de agent aan op basis van gebruikersvoorkeuren
  • Geef realtimegegevens door, zoals rekeningsaldi of orderstatus
  • Verbeter transcriptie van namen of termen per gesprek (bijvoorbeeld bedrijfsnamen uit CRM) via ASR-trefwoorden

Overschrijvingen zijn vooral handig voor applicaties die gepersonaliseerde interacties vereisen of gevoelige gebruikersgegevens verwerken die niet in de basisconfiguratie van de agent moeten worden opgeslagen.

Handleiding

Vereisten

In deze handleiding lees je hoe je de standaardwaarden voor systeemprompt, eerste bericht, LLM, tools, kennisbank, TTS-instellingen en ASR-trefwoorden van de agent overschrijft.

1

Overschrijvingen inschakelen

Om veiligheidsredenen zijn overschrijvingen standaard uitgeschakeld. Schakel de velden in waarvoor je overschrijving wilt toestaan, zoals first_message, prompt.prompt, prompt.tool_ids, prompt.knowledge_base, language of asr.keywords.

Ga naar de instellingen van je agent en selecteer het tabblad Beveiliging. Schakel First message, System prompt, Tools, Knowledge base, ASR keywords en andere overschrijvingen in die je nodig hebt, zoals LLM.

Overschrijvingen inschakelen

2

Het gesprek overschrijven

Geef in je code, waar het gesprek wordt gestart, de overschrijvingen door als parameter. Overschrijvingen voor tools en de kennisbank vervangen de standaardarrays voor dat gesprek. Overschrijvingen voor ASR-trefwoorden vervangen de standaardlijst met trefwoorden van de agent voor dat gesprek (maximaal 50 trefwoorden).

Payload voor het starten van een gesprek
{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
        "knowledge_base": [
          {
            "type": "file",
            "name": "Unladen Swallow Facts",
            "id": "5xM3yVvZQKV0EfqQpLrJ",
            "usage_mode": "auto"
          }
        ]
      }
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso", "Globex"]
    }
  }
}

Zorg dat je de nieuwste SDK hebt geïnstalleerd.

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.
            "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()

Wanneer je overschrijvingen gebruikt, laat je velden die je niet wilt overschrijven weg in plaats van ze in te stellen op lege strings of null-waarden. Neem alleen de velden op die je specifiek wilt aanpassen.

Raadpleeg de API-referentie voor agents voor de juiste LLM-modelstring. Daar vind je alle ondersteunde LLM-modellen en hun exacte string-ID’s.