Sobrescrituras

Las sobrescrituras permiten que tu asistente adapte su comportamiento a cada interacción con el usuario. Puedes enviar datos y ajustes personalizados al inicio de cada conversación, lo que permite al asistente personalizar sus respuestas y conocimientos con contexto en tiempo real. Las sobrescrituras reemplazan por completo los valores predeterminados del agente definidos en el panel del agente.

Descripción general

Las sobrescrituras te permiten modificar el comportamiento de tu agente de IA en tiempo real sin crear varios agentes. Esto te permite personalizar las respuestas con datos específicos de cada usuario.

Las sobrescrituras se pueden activar para los siguientes campos en la configuración de seguridad del agente:

• Prompt del sistema
• Primer mensaje
• Idioma
• ID de voz
• LLM (modelo de lenguaje extenso)
• Esfuerzo de razonamiento del LLM
• Herramientas
• Base de conocimientos
• Modo de solo texto
• Estabilidad
• Velocidad
• Mejora de similitud
• Palabras clave de ASR
• Procedimientos

La sobrescritura de Procedimientos no usa conversation_config_override. En su lugar, el cliente envía procedure_ids y start_procedure_ids en el nivel superior de los datos del cliente de inicio de la conversación. Consulta Elegir procedimientos por conversación.

Cuando las sobrescrituras están activadas para un campo, proporcionar una sobrescritura sigue siendo opcional. Si no se proporciona, el agente usará los valores predeterminados definidos en el panel del agente. Para la mayoría de los campos, se generará un error si se proporciona una sobrescritura cuando ese campo no tiene activadas las sobrescrituras.

Estos son algunos ejemplos en los que las sobrescrituras pueden ser útiles:

• Saludar a usuarios por su nombre
• Incluir datos específicos de la cuenta en las respuestas
• Ajustar el idioma o el tono del agente según las preferencias del usuario
• Enviar datos en tiempo real como saldos de cuenta o el estado de un pedido
• Mejorar la transcripción de nombres o términos por llamada (por ejemplo, nombres de empresas de CRM) mediante palabras clave de ASR

Guía

Requisitos previos

• Una cuenta de ElevenLabs
• Un agente conversacional de ElevenLabs configurado (crea uno aquí)

Esta guía te muestra cómo sobrescribir el prompt del sistema, el primer mensaje, el LLM, el esfuerzo de razonamiento, las herramientas, la base de conocimientos, la configuración de TTS y las palabras clave de ASR predeterminados del agente.

{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "reasoning_effort": "high",
        "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.
            "reasoning_effort": "high", # Optional: override the reasoning effort. Requires Security → Reasoning effort.
            "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()