> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Gesprek beëindigen

> **Warning**
>
> 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](#api-implementation) voor meer informatie.

![Gesprek beëindigen](/docs/_fern-img/f260bfd4e43f7fb0374ce12d2ed984efb946a8ca9ebaa1c2d4b3e6d5f52a7851.webp)

## 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**:

```json
{
  "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:

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

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          endCall: {
            type: "system",
            name: "end_call",
            description: "", // Optional: Customize when the tool should be triggered
            params: { systemToolType: "end_call" },
          },
        },
      },
    },
  },
});
```

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/agents/create \
     -H "xi-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "conversation_config": {
    "agent": {
      "prompt": {
        "built_in_tools": {
          "end_call": {
            "type": "system",
            "name": "end_call",
            "description": "",
            "params": { "system_tool_type": "end_call" }
          }
        }
      }
    }
  }
}'
```

> **Tip**
>
> 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.
```