Finalizar llamada

Resumen

La herramienta Finalizar llamada permite que tu agente conversacional termine una llamada con el usuario. Es una herramienta del sistema que ofrece flexibilidad sobre cómo y cuándo finalizan las llamadas.

Funcionamiento

• Comportamiento predeterminado: La herramienta puede funcionar sin prompts definidos por el usuario y finalizar la llamada cuando la conversación concluya de forma natural.
• Prompts personalizados: Puedes especificar las condiciones en las que debe finalizar la llamada. Por ejemplo:
  • Finaliza la llamada si el usuario dice «adiós».
  • Concluye la llamada cuando se complete una tarea específica.

Propósito: Finalizar automáticamente las conversaciones cuando se cumplan las condiciones adecuadas.

Condiciones de activación: El LLM debe llamar a esta herramienta cuando:

• Se haya completado la tarea principal y el usuario esté satisfecho.
• La conversación haya llegado a una conclusión natural con acuerdo mutuo.
• El usuario indique explícitamente que quiere finalizar la conversación.

Parámetros:

• reason (cadena, obligatorio): El motivo para finalizar la llamada.
• message (cadena, opcional): Un mensaje de despedida que se enviará al usuario antes de finalizar la llamada.

Formato de llamada a función:

{
  "type": "function",
  "function": {
    "name": "end_call",
    "arguments": "{\"reason\": \"Task completed successfully\", \"message\": \"Thank you for using our service. Have a great day!\"}"
  }
}

Implementación: Configúrala como una herramienta del sistema en los ajustes de tu agente. El LLM recibirá instrucciones detalladas sobre cuándo llamar a esta función.

Implementación de la API

Al crear un agente mediante la API, puedes añadir la herramienta Finalizar llamada a la configuración de tu agente. Debe definirse como una herramienta del sistema:

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "end_call": {
                        "type": "system",
                        "name": "end_call",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {"system_tool_type": "end_call"},
                    }
                }
            },
        ),
    ),
)

Ejemplos de prompts

Ejemplo 1: Finalización básica de llamada

End the call when the user says goodbye, thank you, or indicates they have no more questions.

Ejemplo 2: Finalizar llamada con un prompt personalizado

End the call when the user says goodbye, thank you, or indicates they have no more questions. You can only end the call after all their questions have been answered. Please end the call only after confirming that the user doesn't need any additional assistance.