Åsidosättningar
Anpassa varje konversation med personligt kontext för varje användare.
Även om åsidosättningar fortfarande stöds för att helt ersätta systemprompter eller första meddelanden, rekommenderar vi att du använder dynamiska variabler för att anpassa agentens svar och lägga in data i realtid. Dynamiska variabler är enklare att underhålla och ger en mer strukturerad metod för personalisering.
Åsidosättningar gör att din assistent kan anpassa sitt beteende för varje användarinteraktion. Du kan skicka anpassad data och inställningar i början av varje konversation, så att assistenten kan anpassa sina svar och sin kunskap med kontext i realtid. Åsidosättningar ersätter helt agentens standardvärden som definierats i agentens kontrollpanel.
Översikt
Med åsidosättningar kan du ändra AI-agentens beteende i realtid utan att skapa flera agenter. På så sätt kan du anpassa svar med användarspecifika data.
Åsidosättningar kan aktiveras för följande fält i agentens säkerhetsinställningar:
- Systemprompt
- Första meddelandet
- Språk
- Röst-ID
- LLM (Large Language Model)
- LLM-resonemangsnivå
- Verktyg
- Kunskapsbas
- Endast text-läge
- Stabilitet
- Hastighet
- Likhetsförstärkning
- ASR-nyckelord
- Procedurer
- Startnod för workflow
Åsidosättningen Procedures använder inte conversation_config_override. I stället skickar klienten procedure_ids och start_procedure_ids på toppnivån i klientdata för att starta konversationen. Se Välj procedurer per konversation.
Åsidosättningen Workflow start node fungerar också utanför conversation_config_override: klienten skickar starting_workflow_node_id på toppnivån. Se klientdatastrukturen.
När åsidosättningar är aktiverade för ett fält är det fortfarande valfritt att ange en åsidosättning. Om ingen anges använder agenten standardvärdena som definierats i agentens kontrollpanel. För de flesta fält uppstår ett fel om en åsidosättning anges när åsidosättningar inte är aktiverade för fältet.
ASR-nyckelord använder mjuk blockering: om säkerhetsreglaget är avstängt och klienten ändå skickar
asr.keywords fortsätter konversationen och nyckelorden ignoreras (inget fel). Aktivera åsidosättningen
ASR-nyckelord i säkerhetsinställningarna när du vill använda nyckelordsförstärkning per konversation.
Upp till 50 nyckelord stöds per konversation.
Resonemangsnivå måste vara en nivå som stöds av agentens LLM. Annars startar inte konversationen
och anslutningen stängs med ett fel som anger den nivå som inte stöds. Om säkerhetsreglaget
är avstängt ignoreras prompt.reasoning_effort och agentens sparade resonemangsnivå
används. Värdet är fast för hela konversationen och kan inte ändras efter att den har startat.
Här är några exempel där åsidosättningar kan vara användbara:
- Hälsa på användare med deras namn
- Inkludera kontospecifika uppgifter i svar
- Anpassa agentens språk eller ton utifrån användarens preferenser
- Skicka data i realtid som kontosaldon eller orderstatus
- Förbättra transkribering av namn eller termer per samtal (till exempel CRM-företagsnamn) med ASR-nyckelord
Åsidosättningar är särskilt användbara för program som kräver personliga interaktioner eller hanterar känsliga användardata som inte bör lagras i agentens grundkonfiguration.
Guide
Förutsättningar
- Ett ElevenLabs-konto
- En konfigurerad ElevenLabs konversationsagent (skapa en här)
Den här guiden visar hur du åsidosätter agentens standardinställningar för systemprompt, första meddelande, LLM, resonemangsnivå, verktyg, kunskapsbas, TTS-inställningar och ASR-nyckelord.
Aktivera åsidosättningar
Av säkerhetsskäl är åsidosättningar inaktiverade som standard. Aktivera de fält som du vill tillåta åsidosättning för, till exempel first_message, prompt.prompt, prompt.reasoning_effort, prompt.tool_ids, prompt.knowledge_base, language eller asr.keywords.
Uppdatera via kontrollpanelen
Uppdatera via CLI
Uppdatera via API:et
Gå till agentens inställningar och välj fliken Security. Aktivera First message, System prompt, Tools, Knowledge base, ASR keywords och andra åsidosättningar du behöver, till exempel LLM eller Reasoning effort.

Åsidosätt konversationen
I din kod, där konversationen startas, skickar du åsidosättningarna som en parameter. Åsidosättningar för verktyg och kunskapsbas ersätter standardarrayerna för den konversationen. Åsidosättningar för ASR-nyckelord ersätter agentens standardlista med nyckelord för den konversationen (högst 50 nyckelord).
Se till att du har den senaste SDK:n installerad.
När du använder åsidosättningar ska du utelämna fält som du inte vill åsidosätta i stället för att ange tomma strängar eller null-värden. Inkludera bara de fält som du specifikt vill anpassa.
Information om rätt LLM-modellsträng finns i API-referensen för agenter, där alla LLM-modeller som stöds och deras exakta strängidentifierare listas.