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

# Sounds bei Tool-Aufrufen

## Überblick

Sounds bei Tool-Aufrufen liefern während der Tool-Ausführung akustisches Umgebungsfeedback und schaffen so ein natürlicheres und ansprechenderes Gesprächserlebnis. Wenn Ihr Agent ein Tool ausführt – etwa Daten über eine API abruft oder eine Anfrage verarbeitet – füllen diese Sounds stille Momente und zeigen Nutzern, dass der Agent aktiv arbeitet.

ElevenLabs Agents unterstützt mehrere integrierte Umgebungssounds, die Sie sowohl auf Tool- als auch auf Integrationsebene konfigurieren können. So steuern Sie detailliert, wann und wie Sounds während Ihrer Unterhaltungen abgespielt werden.

> **Note**
>
> Sounds bei Tool-Aufrufen werden nur während der Tool-Ausführung abgespielt. Informationen zu einem kontinuierlichen Hintergrundsound finden Sie unter [Audio- Umgebung](/docs/de/eleven-agents/customization/voice/audio-environment).

## Anwendungsfälle

Sounds bei Tool-Aufrufen sind besonders effektiv, wenn:

* **API-Aufrufe Zeit benötigen**: Spielen Sie beim Abrufen von Daten aus externen Diensten Umgebungsgeräusche oder Tippgeräusche ab
* **Lang laufende Vorgänge**: Geben Sie während Datenbankabfragen, komplexer Berechnungen oder Drittanbieter-Integrationen akustisches Feedback
* **Natürlicher Gesprächsfluss**: Füllen Sie Lücken in der Unterhaltung, um unangenehme Stille zu vermeiden
* **Nutzererwartungen**: Signalisieren Sie Nutzern, dass der Agent ihre Anfrage verarbeitet und keine technischen Probleme hat

> **Info**
>
> Sounds bei Tool-Aufrufen sind optional. Wenn Sie eine lautlose Tool-Ausführung bevorzugen, lassen Sie die Einstellung für den Sound bei Tool-Aufrufen einfach auf "None".

## Verfügbare Sounds

ElevenLabs bietet die folgenden Optionen für Umgebungsgeräusche:

| Soundtyp           | Beschreibung                          | Am besten geeignet für                  |
| ------------------ | ------------------------------------- | --------------------------------------- |
| None               | Kein Sound bei Tool-Ausführung        | Schnelle Vorgänge, lautlose Abläufe     |
| Typing             | Soundeffekt für Tastatureingaben      | Suchanfragen, Textverarbeitung          |
| Elevator Music 1-4 | Leichte Hintergrundmusik (beschwingt) | Längere Wartezeiten, allgemeine Nutzung |

> **Tip**
>
> Sie können jeden Sound im Dashboard anhören, indem Sie beim Konfigurieren der Sounds für Tool-Aufrufe auf die Wiedergabeschaltfläche neben dem Dropdown-Menü klicken.

## Konfiguration

Sie können Sounds bei Tool-Aufrufen an zwei Stellen konfigurieren, wobei die Konfiguration auf Tool-Ebene Vorrang hat:

### Konfiguration auf Tool-Ebene

Konfigurieren Sie Sounds für einzelne Tools in den Tool-Einstellungen Ihres Agents.

#### Über das Dashboard aktualisieren

#### Zur Tool-Konfiguration navigieren

Wählen Sie im Bereich **Agent** Ihrer Agent-Einstellungen das Tool aus, das Sie konfigurieren möchten, oder erstellen Sie ein neues Tool.

#### Sound bei Tool-Aufruf konfigurieren

Scrollen Sie zum Bereich **Tool Call Sound** am Ende der Tool-Konfiguration.

![Dropdown-Menü für Sound bei Tool-Aufruf](/docs/_fern-img/093fd6c380e2d51f0b8dbe152377a35e1e4e0e422638519910016b9f1551233d.webp)

Wählen Sie einen Sound aus dem Dropdown-Menü:

* **None**: Es wird kein Sound abgespielt
* **Typing**: Effekt für Tastatureingaben
* **Elevator Music 1-4**: Verschiedene Optionen für Hintergrundmusik

#### Soundverhalten konfigurieren

Wenn Sie einen Sound ausgewählt haben (nicht "None"), wird eine zusätzliche Option **Sound Behavior** angezeigt:

![Dropdown-Menü für Soundverhalten](/docs/_fern-img/00c7f6ddfb1b0240a900c8d6814c8706e045500d92f6a6c263d4a7c962e24fbe.webp)

Wählen Sie, wann der Sound abgespielt werden soll:

* **With pre-speech**: Der Sound wird nur abgespielt, wenn der Agent vor der Tool-Ausführung spricht
* **Always play**: Der Sound wird bei jeder Tool-Ausführung abgespielt, unabhängig davon, ob der Agent zuerst spricht

#### Konfiguration speichern

Klicken Sie auf **Save**, um Ihre Einstellungen für Sounds bei Tool-Aufrufen zu übernehmen.

#### Über die CLI aktualisieren

#### Tool-Konfiguration abrufen

```bash
elevenlabs tools pull
```

#### \`tool_configs/\<tool-name>.json\` bearbeiten

Legen Sie `tool_call_sound` und `tool_call_sound_behavior` fest:

```json
{
  "type": "webhook",
  "name": "get_weather",
  "tool_call_sound": "typing",
  "tool_call_sound_behavior": "auto"
}
```

Verwenden Sie `"auto"` für **With pre-speech** oder `"always"` für **Always play**.

#### Änderungen übertragen

```bash
elevenlabs tools push
```

#### Über die API aktualisieren

```python
from elevenlabs import ElevenLabs, ToolRequestModel

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.tools.update(
    tool_id="tool_7101k5zvyjhmfg983brhmhkd98n6",
    request=ToolRequestModel(
        tool_config={
            "type": "webhook",
            "name": "get_weather",
            "description": "Gets current weather data",
            "tool_call_sound": "typing",
            "tool_call_sound_behavior": "auto",
            "api_schema": {
                "url": "https://api.weather.com/data",
                "method": "GET",
            },
        },
    )
)
```

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.tools.update("tool_7101k5zvyjhmfg983brhmhkd98n6", {
  toolConfig: {
    type: "webhook",
    name: "get_weather",
    description: "Gets current weather data",
    toolCallSound: "typing",
    toolCallSoundBehavior: "auto",
    apiSchema: {
      url: "https://api.weather.com/data",
      method: "GET",
    },
  },
});
```

### Konfiguration auf Integrationsebene

Bei Tools, die über Integrationen erstellt wurden (MCP-Server, API-Integrationen usw.), können Sie Standard-Sounds bei Tool-Aufrufen auf Integrationsebene festlegen:

#### Zu den Integrationseinstellungen navigieren

Gehen Sie zu **Agent Settings > Integrations** und wählen Sie Ihre Integration aus.

#### Standard-Sound konfigurieren

Suchen Sie in der Integrationsübersicht die Einstellungen für **Tool Call Sound**.

![Dropdown-Menü für Integrationen von Sounds bei Tool-Aufrufen](/docs/_fern-img/9c4c33501c814c3d124d76060853ee6eb8c59c8b4f0cc494d16267e9fe5cf56b.webp)

Wählen Sie einen Standard-Sound, der auf alle Tools dieser Integration angewendet wird, sofern er nicht auf Tool-Ebene überschrieben wird.

#### Auf Tool-Ebene überschreiben (optional)

Sie können den Standardwert auf Integrationsebene für bestimmte Tools überschreiben, indem Sie Sounds bei Tool-Aufrufen in den einzelnen Tool-Einstellungen konfigurieren.

## Optionen für das Soundverhalten

Die Einstellung für das Soundverhalten bestimmt, wann Sounds bei Tool-Aufrufen während einer Unterhaltung abgespielt werden:

### Mit vorangestellter Ansage (Auto)

**Standardverhalten**. Der Sound wird nur abgespielt, wenn der Agent vor der Verwendung des Tools spricht.

**Beispielszenario:**

```
User: "What's the weather in Tokyo?"
Agent: "Let me check that for you..." [typing sound plays while fetching weather data]
Agent: "It's currently 72 degrees and sunny in Tokyo."
```

**Wann verwenden:**

* Wenn Sounds nur abgespielt werden sollen, nachdem der Agent die Anfrage bestätigt hat
* Für einen natürlicheren Gesprächsfluss, bei dem Stille nach der Nutzereingabe unangenehm wäre
* Wenn die Tool-Ausführung direkt auf die Agent-Ansage folgt

### Immer abspielen

Der Sound wird bei jeder Tool-Ausführung abgespielt, unabhängig davon, ob der Agent zuvor spricht.

**Beispielszenario:**

```
User: "Check my order status"
[typing sound plays immediately while fetching order data]
Agent: "Your order #12345 shipped yesterday and will arrive tomorrow."
```

**Wann verwenden:**

* Für Vorgänge, die immer merklich Zeit benötigen
* Wenn Sie bei jedem Tool-Aufruf konsistentes akustisches Feedback möchten
* Für Hintergrundvorgänge, die möglicherweise keine Bestätigung durch den Agent erfordern

> **Warning**
>
> Wenn Sie "Always play" auswählen, wird der Sound auch abgespielt, wenn der Agent vor der Verwendung
> des Tools nicht spricht. Dadurch können Sounds sofort nach Ende der Nutzereingabe abgespielt werden,
> was in manchen Gesprächskontexten abrupt wirken kann.

## Best Practices

#### Sounds an die Tool-Ausführungszeit anpassen

Bei schnellen Vorgängen (\< 1 Sekunde) sollten Sie "None" oder den Tipp-Sound verwenden. Bei längeren Vorgängen (> 3 Sekunden) bieten Optionen für Fahrstuhlmusik eine bessere Nutzererfahrung.

#### "With pre-speech" für bestätigte Aktionen verwenden

Wenn Ihr Agent eine Anfrage ausdrücklich bestätigt, bevor er sie ausführt, verwenden Sie das Verhalten "With pre-speech", um einen natürlichen Gesprächsfluss zu schaffen:

**`System prompt`**

```plaintext System prompt
When users request information, first acknowledge their request before using tools.
For example: "Let me check that for you..." then call the appropriate tool.
```

#### Für Konsistenz auf Integrationsebene konfigurieren

Wenn Sie mehrere Tools aus derselben Integration haben, konfigurieren Sie Sounds bei Tool-Aufrufen auf Integrationsebene, um ein einheitliches akustisches Feedback für alle zugehörigen Tools sicherzustellen.

#### Mit realistischen Latenzen testen

Testen Sie Ihre Sounds bei Tool-Aufrufen mit realistischen API-Latenzen, um sicherzustellen, dass das akustische Feedback den Nutzererwartungen entspricht. Berücksichtigen Sie:

* Netzwerklatenz zu Ihren APIs
* Verarbeitungszeit der API
* Geografische Verteilung Ihrer Nutzer

#### Unterbrechungen berücksichtigen

Wenn Ihr Agent Nutzerunterbrechungen unterstützt, werden Sounds bei Tool-Aufrufen automatisch gestoppt, wenn der Nutzer unterbricht. Stellen Sie sicher, dass Ihr Gesprächsablauf damit angemessen umgeht.

## Beispielkonfigurationen

### Such-Agent

**Anwendungsfall**: Agent, der eine Wissensdatenbank oder Datenbank durchsucht

**Konfiguration**:

* Sound bei Tool-Aufruf: **Typing**
* Soundverhalten: **With pre-speech**
* System-Prompt enthält: *"Wenn Nutzer Fragen stellen, sagen Sie vor dem Aufruf des Such-Tools: 'Ich suche danach'."*

### Kundendienst-Agent

**Anwendungsfall**: Agent, der Bestellstatus, Lagerbestand oder Kundendaten prüft

**Konfiguration**:

* Sound bei Tool-Aufruf: **Elevator Music 3**
* Soundverhalten: **Always play**
* Begründung: Vorgänge können 2–5 Sekunden dauern, und Hintergrundmusik bietet eine bessere Erfahrung als Stille

### Mehrstufiger Workflow

**Anwendungsfall**: Agent, der mehrere aufeinanderfolgende Tool-Aufrufe ausführt

**Konfiguration**:

* Erstes Tool: **Typing** mit **With pre-speech**
* Nachfolgende Tools: **Elevator Music 1** mit **Always play**
* System-Prompt steuert: *"Bestätigen Sie zuerst die Anfrage und führen Sie dann die Tools nacheinander aus."*

## Fehlerbehebung

### Sound wird nicht abgespielt

**Mögliche Ursachen:**

1. **Keine vorangestellte Ansage**: Bei Verwendung des Verhaltens "With pre-speech" muss der Agent sprechen, bevor das Tool ausgeführt wird. Aktualisieren Sie Ihren System-Prompt, um eine Bestätigung einzubeziehen.
2. **Schnelle Ausführung**: Wenn das Tool in weniger als etwa 500 ms abgeschlossen wird, hat der Sound möglicherweise nicht genügend Zeit, hörbar abgespielt zu werden.

## Verwandte Ressourcen

* [Webhook-Tools](/docs/de/eleven-agents/customization/tools/webhook-tools) – Erfahren Sie, wie Sie Webhook-Tools konfigurieren
* [Client-Tools](/docs/de/eleven-agents/customization/tools/client-tools) – Verstehen Sie die clientseitige Tool-Ausführung
* [Systemtools](/docs/de/eleven-agents/customization/tools/system-tools) – Entdecken Sie integrierte Plattform-Tools
* [Best Practices](/docs/de/eleven-api/guides/how-to/websockets/multi-context-web-socket) – Allgemeine Best Practices für die Entwicklung von Conversational Agents