Gesprek beëindigen

Laat je agent automatisch ophangen bij de gebruiker.

De tool End Call wordt standaard toegevoegd aan agents die in het ElevenLabs-dashboard zijn gemaakt. Voor agents die via API of SDK zijn gemaakt, moet je de End Call-tool handmatig toevoegen als een systeemtool in je agentconfiguratie als je deze wilt inschakelen. Zie de API-implementatie hieronder voor meer informatie.

Overzicht

Met de tool End Call kan je conversationele agent een gesprek met de gebruiker beëindigen. Dit is een systeemtool die flexibiliteit biedt in de manier en het moment waarop gesprekken worden beëindigd.

Functionaliteit

Standaardgedrag: De tool kan werken zonder door de gebruiker gedefinieerde prompts en beëindigt het gesprek wanneer het gesprek vanzelf ten einde komt.
Aangepaste prompts: Gebruikers kunnen voorwaarden opgeven waaronder het gesprek moet worden beëindigd. Bijvoorbeeld:
- Beëindig het gesprek als de gebruiker “tot ziens” zegt.
- Rond het gesprek af wanneer een specifieke taak is voltooid.

Doel: Gesprekken automatisch beëindigen wanneer aan de juiste voorwaarden is voldaan.

Triggervoorwaarden: De LLM moet deze tool aanroepen wanneer:

De hoofdtaak is voltooid en de gebruiker tevreden is
Het gesprek op natuurlijke wijze is afgerond en beide partijen het eens zijn
De gebruiker expliciet aangeeft het gesprek te willen beëindigen

Parameters:

reason (string, vereist): De reden voor het beëindigen van het gesprek
message (string, optioneel): Een afscheidsbericht dat je naar de gebruiker stuurt voordat je het gesprek beëindigt

Indeling van de functieaanroep:

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

Implementatie: Configureer dit als een system tool in de instellingen van je agent. De LLM ontvangt gedetailleerde instructies over wanneer deze functie moet worden aangeroepen.

API-implementatie

Wanneer je een agent via de API maakt, kun je de End Call-tool toevoegen aan de configuratie van je agent. Deze moet als systeemtool worden gedefinieerd:

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

Laat de beschrijving leeg om de standaardprompt voor het beëindigen van een gesprek te gebruiken.

Voorbeeldprompts

Voorbeeld 1: Gesprek eenvoudig beëindigen

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

Voorbeeld 2: Gesprek beëindigen met aangepaste prompt

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.