Skip to navigation
ConfigurerenPersonalisatie

Overschrijvingen

Pas elk gesprek aan met gepersonaliseerde context voor elke gebruiker.

Hoewel overschrijvingen nog steeds worden ondersteund om system prompts of eerste berichten volledig te vervangen, raden we aan om dynamische variabelen te gebruiken als voorkeursmethode om de reacties van je agent aan te passen en realtimegegevens in te voegen. Dynamische variabelen zijn beter onderhoudbaar en bieden 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 reacties en kennis kan personaliseren met realtime context. Overschrijvingen vervangen de standaardwaarden van de agent die zijn ingesteld 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 reacties personaliseren met gebruikersspecifieke gegevens.

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

  • System prompt
  • Eerste bericht
  • Taal
  • Stem-ID
  • LLM (Large Language Model)
  • Tools
  • Kennisbank
  • Alleen-tekstmodus
  • Stabiliteit
  • Snelheid
  • Similarity boost
  • ASR-keywords

Wanneer overschrijvingen voor een veld zijn ingeschakeld, blijft het opgeven van een overschrijving optioneel. Als je niets opgeeft, gebruikt de agent de standaardwaarden die zijn ingesteld 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-keywords gebruiken soft disallow: als de schakelaar voor Security uit staat en de client toch asr.keywords verstuurt, gaat het gesprek door en worden de keywords genegeerd (geen fout). Schakel de overschrijving voor ASR-keywords in bij de beveiligingsinstellingen wanneer je keywordboosting per gesprek wilt toepassen. Per gesprek worden maximaal 50 keywords ondersteund.

Hier zijn enkele voorbeelden waarin overschrijvingen nuttig kunnen zijn:

  • Begroet gebruikers met hun naam
  • Neem accountspecifieke gegevens op in reacties
  • Pas de taal of toon van de agent aan op basis van gebruikersvoorkeuren
  • Geef realtimegegevens door, zoals rekeningsaldi of bestelstatus
  • Verbeter transcriptie van namen of termen per gesprek (bijvoorbeeld bedrijfsnamen uit CRM) via ASR-keywords

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

Handleiding

Vereisten

In deze handleiding zie je hoe je de standaardwaarden voor System prompt, Eerste bericht, LLM, Tools, Kennisbank, TTS-instellingen en ASR-keywords van de agent overschrijft.

1

Overschrijvingen inschakelen

Om veiligheidsredenen zijn overschrijvingen standaard uitgeschakeld. Schakel de velden in die je wilt laten overschrijven, 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 Security. Schakel First message, System prompt, Tools, Knowledge base, ASR keywords en alle 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-keywords vervangen de standaardkeywordlijst van de agent voor dat gesprek (maximaal 50 keywords).

Payload voor gespreksstart
{
  "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()

Laat bij het gebruik van overschrijvingen 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 Agent API-referentie om de juiste LLM-modelstring te vinden. Daar vind je alle ondersteunde LLM-modellen en hun exacte string-ID’s.