Vai alla navigazione
ConfigurazionePersonalizzazione

Sovrascritture

Personalizza ogni conversazione con un contesto su misura per ogni utente.

Sebbene le sovrascritture siano ancora supportate per sostituire completamente i prompt di sistema o i primi messaggi, ti consigliamo di usare le variabili dinamiche come metodo preferito per personalizzare le risposte del tuo agente e inserire dati in tempo reale. Le variabili dinamiche offrono una migliore manutenibilità e un approccio più strutturato alla personalizzazione.

Le sovrascritture consentono al tuo assistente di adattare il proprio comportamento a ogni interazione con l’utente. Puoi passare dati e impostazioni personalizzati all’inizio di ogni conversazione, permettendo all’assistente di personalizzare le risposte e le conoscenze con il contesto in tempo reale. Le sovrascritture sostituiscono completamente i valori predefiniti dell’agente definiti nel dashboard dell’agente.

Panoramica

Le sovrascritture ti consentono di modificare in tempo reale il comportamento del tuo agente IA senza creare più agenti. In questo modo puoi personalizzare le risposte con dati specifici dell’utente.

Puoi abilitare le sovrascritture per i seguenti campi nelle impostazioni di sicurezza dell’agente:

  • Prompt di sistema
  • Primo messaggio
  • Lingua
  • ID voce
  • LLM (modello linguistico di grandi dimensioni)
  • Tool
  • Knowledge base
  • Modalità solo testo
  • Stabilità
  • Velocità
  • Aumento della somiglianza
  • Parole chiave ASR

Quando le sovrascritture sono abilitate per un campo, fornirne una resta facoltativo. Se non viene fornita, l’agente utilizzerà i valori predefiniti definiti nel dashboard dell’agente. Per la maggior parte dei campi, viene generato un errore se viene fornita una sovrascrittura quando per quel campo non sono abilitate le sovrascritture.

Le parole chiave ASR utilizzano un blocco soft: se l’interruttore Security è disattivato e il client invia comunque asr.keywords, la conversazione continua e le parole chiave vengono ignorate (nessun errore). Abilita la sovrascrittura ASR keywords nelle impostazioni Security quando vuoi applicare il potenziamento delle parole chiave per conversazione. Sono supportate fino a 50 parole chiave per conversazione.

Ecco alcuni esempi in cui le sovrascritture possono essere utili:

  • Salutare gli utenti con il loro nome
  • Includere dettagli specifici dell’account nelle risposte
  • Adattare la lingua dell’agente o il tono in base alle preferenze dell’utente
  • Passare dati in tempo reale come saldi del conto o stato dell’ordine
  • Migliorare la trascrizione di nomi o termini per chiamata (ad esempio nomi di aziende CRM) tramite parole chiave ASR

Le sovrascritture sono particolarmente utili per le applicazioni che richiedono interazioni personalizzate o gestiscono dati sensibili degli utenti che non dovrebbero essere archiviati nella configurazione di base dell’agente.

Guida

Prerequisiti

Questa guida mostra come sovrascrivere Prompt di sistema, Primo messaggio, LLM, Tool, Knowledge base, impostazioni TTS e parole chiave ASR predefiniti dell’agente.

1

Abilita le sovrascritture

Per motivi di sicurezza, le sovrascritture sono disabilitate per impostazione predefinita. Abilita i campi per cui vuoi consentire la sovrascrittura, come first_message, prompt.prompt, prompt.tool_ids, prompt.knowledge_base, language o asr.keywords.

Vai alle impostazioni dell’agente e seleziona la scheda Security. Abilita First message, System prompt, Tools, Knowledge base, ASR keywords e qualsiasi altra sovrascrittura necessaria, ad esempio LLM.

Abilita le sovrascritture

2

Sovrascrivi la conversazione

Nel tuo codice, nel punto in cui viene avviata la conversazione, passa le sovrascritture come parametro. Le sovrascritture dei tool e della knowledge base sostituiscono gli array predefiniti per quella conversazione. Le sovrascritture delle parole chiave ASR sostituiscono l’elenco predefinito di parole chiave dell’agente per quella conversazione (massimo 50 parole chiave).

Payload di avvio della conversazione
{
  "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"]
    }
  }
}

Assicurati di avere installato l’SDK più recente.

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

Quando usi le sovrascritture, ometti i campi che non vuoi sovrascrivere anziché impostarli su stringhe vuote o valori null. Includi solo i campi che vuoi personalizzare in modo specifico.

Per trovare la stringa corretta del modello LLM, consulta il riferimento API degli agenti, che elenca tutti i modelli LLM supportati e i relativi identificatori stringa esatti.