Terminer l’appel

Vue d’ensemble

L’outil End Call permet à votre agent conversationnel de mettre fin à un appel avec l’utilisateur. Cet outil système offre une grande flexibilité quant à la manière et au moment de terminer les appels.

Fonctionnalités

• Comportement par défaut : l’outil peut fonctionner sans prompt défini par l’utilisateur et met fin à l’appel lorsque la conversation se conclut naturellement.
• Prompts personnalisés : les utilisateurs peuvent indiquer les conditions dans lesquelles l’appel doit se terminer. Par exemple :
  • Terminez l’appel si l’utilisateur dit « au revoir ».
  • Concluez l’appel lorsqu’une tâche spécifique est terminée.

Objectif : Mettre automatiquement fin aux conversations lorsque les conditions appropriées sont réunies.

Conditions de déclenchement : le LLM doit appeler cet outil lorsque :

• La tâche principale est terminée et l’utilisateur est satisfait
• La conversation est arrivée à une conclusion naturelle avec un accord mutuel
• L’utilisateur indique explicitement vouloir mettre fin à la conversation

Paramètres :

• reason (chaîne, obligatoire) : la raison de la fin de l’appel
• message (chaîne, facultatif) : un message d’au revoir à envoyer à l’utilisateur avant de mettre fin à l’appel

Format d’appel de fonction :

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

Mise en œuvre : configurez cet outil système dans les paramètres de votre agent. Le LLM recevra des instructions détaillées sur le moment où appeler cette fonction.

Implémentation via l’API

Lors de la création d’un agent via l’API, vous pouvez ajouter l’outil End Call à la configuration de votre agent. Il doit être défini comme un outil système :

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"},
                    }
                }
            },
        ),
    ),
)

Exemples de prompts

Exemple 1 : Fin d’appel simple

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

Exemple 2 : Fin d’appel avec prompt personnalisé

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.