Substituições

As substituições permitem que seu assistente adapte o comportamento a cada interação do usuário. Você pode transmitir dados e configurações personalizados no início de cada conversa, permitindo que o assistente personalize suas respostas e conhecimentos com contexto em tempo real. As substituições substituem completamente os valores padrão do agente definidos no painel do agente.

Visão geral

As substituições permitem modificar o comportamento do seu agente de IA em tempo real sem criar vários agentes. Isso permite personalizar respostas com dados específicos do usuário.

As substituições podem ser ativadas para os seguintes campos nas configurações de segurança do agente:

• Prompt do sistema
• Primeira mensagem
• Idioma
• ID da voz
• LLM (Large Language Model)
• Ferramentas
• Base de conhecimento
• Modo somente texto
• Estabilidade
• Velocidade
• Impulso de similaridade
• Palavras-chave de ASR

Quando as substituições estão ativadas para um campo, fornecer uma substituição ainda é opcional. Se ela não for fornecida, o agente usará os valores padrão definidos no painel do agente. Para a maioria dos campos, ocorrerá um erro se uma substituição for fornecida quando esse campo não estiver com substituições ativadas.

Veja alguns exemplos em que as substituições podem ser úteis:

• Cumprimentar usuários pelo nome
• Incluir detalhes específicos da conta nas respostas
• Ajustar o idioma ou o tom do agente com base nas preferências do usuário
• Transmitir dados em tempo real, como saldos de conta ou status do pedido
• Melhorar a transcrição de nomes ou termos por chamada (por exemplo, nomes de empresas no CRM) por meio de palavras-chave de ASR

Guia

Pré-requisitos

• Uma conta da ElevenLabs
• Um Agente Conversacional da ElevenLabs configurado (crie um aqui)

Este guia mostra como substituir o prompt do sistema, a primeira mensagem, o LLM, as ferramentas, a base de conhecimento, as configurações de TTS e as palavras-chave de ASR padrão do agente.

{
  "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"]
    }
  }
}

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