Avsluta samtal

Låt agenten automatiskt lägga på för användaren.

Verktyget Avsluta samtal läggs som standard till för agenter som skapats i ElevenLabs dashboard. För agenter som skapats via API eller SDK måste du lägga till verktyget Avsluta samtal manuellt som ett systemverktyg i agentens konfiguration om du vill aktivera det. Se API-implementering nedan för mer information.

Översikt

Verktyget Avsluta samtal låter din konversationsagent avsluta ett samtal med användaren. Det här är ett systemverktyg som ger flexibilitet kring hur och när samtal avslutas.

Funktionalitet

Standardbeteende: Verktyget kan fungera utan användardefinierade prompter och avslutar samtalet när konversationen naturligt tar slut.
Anpassade prompter: Användare kan ange villkor för när samtalet ska avslutas. Till exempel:
- Avsluta samtalet om användaren säger “hej då”.
- Avsluta samtalet när en specifik uppgift är klar.

Syfte: Avsluta automatiskt samtal när lämpliga villkor är uppfyllda.

Utlösande villkor: LLM:en ska anropa det här verktyget när:

Huvuduppgiften har slutförts och användaren är nöjd
Samtalet har nått ett naturligt avslut i ömsesidig överenskommelse
Användaren uttryckligen vill avsluta samtalet

Parametrar:

reason (sträng, krävs): Anledningen till att avsluta samtalet
message (sträng, valfritt): Ett avskedsmeddelande att skicka till användaren innan samtalet avslutas

Format för funktionsanrop:

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

Implementering: Konfigurera som ett systemverktyg i agentinställningarna. LLM:en får detaljerade instruktioner om när funktionen ska anropas.

API-implementering

När du skapar en agent via API:et kan du lägga till verktyget Avsluta samtal i agentens konfiguration. Det ska definieras som ett systemverktyg:

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

Lämna beskrivningen tom för att använda standardprompten för att avsluta samtal.

Exempelprompter

Exempel 1: Grundläggande avslut av samtal

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

Exempel 2: Avsluta samtal med anpassad 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.