Encerrar chamada

Visão geral

A ferramenta Encerrar chamada permite que seu agente conversacional encerre uma chamada com o usuário. Esta é uma ferramenta de sistema que oferece flexibilidade sobre como e quando as chamadas são encerradas.

Funcionalidade

• Comportamento padrão: a ferramenta pode funcionar sem prompts definidos pelo usuário, encerrando a chamada quando a conversa chega naturalmente ao fim.
• Prompts personalizados: você pode especificar condições para encerrar a chamada. Por exemplo:
  • Encerre a chamada se o usuário disser “tchau”.
  • Conclua a chamada quando uma tarefa específica for concluída.

Objetivo: Encerrar conversas automaticamente quando as condições apropriadas forem atendidas.

Condições de acionamento: o LLM deve chamar esta ferramenta quando:

• A tarefa principal tiver sido concluída e o usuário estiver satisfeito
• A conversa tiver chegado a uma conclusão natural, com concordância mútua
• O usuário indicar explicitamente que deseja encerrar a conversa

Parâmetros:

• reason (string, obrigatório): o motivo para encerrar a chamada
• message (string, opcional): uma mensagem de despedida para enviar ao usuário antes de encerrar a chamada

Formato da chamada de função:

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

Implementação: configure como uma ferramenta de sistema nas configurações do seu agente. O LLM receberá instruções detalhadas sobre quando chamar esta função.

Implementação via API

Ao criar um agente via API, você pode adicionar a ferramenta Encerrar chamada à configuração do agente. Ela deve ser definida como uma ferramenta de 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"},
                    }
                }
            },
        ),
    ),
)

Exemplos de prompts

Exemplo 1: Encerramento básico de chamada

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

Exemplo 2: Encerrar chamada com 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.