> 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.

# Avsluta samtal

> **Warning**
>
> 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](#api-implementation) för mer information.

![Avsluta samtal](/docs/_fern-img/f260bfd4e43f7fb0374ce12d2ed984efb946a8ca9ebaa1c2d4b3e6d5f52a7851.webp)

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

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

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