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

# Dźwięki wywołań narzędzi

## Omówienie

Dźwięki wywołań narzędzi zapewniają dźwięk tła podczas działania narzędzia, tworząc bardziej naturalne i angażujące doświadczenie rozmowy. Gdy agent uruchamia narzędzie — na przykład pobiera dane z API lub przetwarza żądanie — dźwięki te wypełniają chwile ciszy i informują użytkowników, że agent aktywnie pracuje.

ElevenLabs Agents obsługuje wiele wbudowanych dźwięków tła, które możesz skonfigurować zarówno na poziomie narzędzia, jak i integracji. Dzięki temu masz precyzyjną kontrolę nad tym, kiedy i jak dźwięki są odtwarzane podczas rozmów.

> **Note**
>
> Dźwięki wywołań narzędzi są odtwarzane tylko podczas działania narzędzia. Aby ustawić ciągły dźwięk w tle, zobacz [Środowisko audio](/docs/pl/eleven-agents/customization/voice/audio-environment).

## Przypadki użycia

Dźwięki wywołań narzędzi sprawdzają się szczególnie dobrze, gdy:

* **Wywołania API wymagają czasu**: Odtwarzaj muzykę tła lub dźwięki pisania podczas pobierania danych z zewnętrznych usług
* **Długie operacje**: Zapewnij informację dźwiękową podczas zapytań do bazy danych, złożonych obliczeń lub integracji z usługami zewnętrznymi
* **Naturalny przebieg rozmowy**: Wypełniaj przerwy w rozmowie, by uniknąć niezręcznej ciszy
* **Oczekiwania użytkowników**: Daj użytkownikom znać, że agent przetwarza ich żądanie, a nie ma problemów technicznych

> **Info**
>
> Dźwięki wywołań narzędzi są opcjonalne. Jeśli wolisz ciche działanie narzędzi, po prostu pozostaw
> ustawienie dźwięku wywołania narzędzia jako „None”.

## Dostępne dźwięki

ElevenLabs oferuje następujące opcje dźwięków tła:

| Typ dźwięku        | Opis                                     | Najlepsze zastosowanie                   |
| ------------------ | ---------------------------------------- | ---------------------------------------- |
| None               | Brak dźwięku podczas działania narzędzia | Szybkie operacje, ciche workflow         |
| Typing             | Efekt dźwiękowy pisania na klawiaturze   | Wyszukiwanie, przetwarzanie tekstu       |
| Elevator Music 1-4 | Lekka muzyka w tle (energiczna)          | Dłuższe oczekiwanie, zastosowania ogólne |

> **Tip**
>
> Możesz odsłuchać każdy dźwięk w panelu, klikając przycisk odtwarzania obok listy rozwijanej podczas
> konfiguracji dźwięków wywołań narzędzi.

## Konfiguracja

Dźwięki wywołań narzędzi możesz skonfigurować w dwóch miejscach, przy czym konfiguracja na poziomie narzędzia ma pierwszeństwo:

### Konfiguracja na poziomie narzędzia

Skonfiguruj dźwięki dla poszczególnych narzędzi w ustawieniach narzędzi agenta.

#### Aktualizacja w panelu

#### Przejdź do konfiguracji narzędzia

W sekcji **Agent** w ustawieniach agenta wybierz narzędzie, które chcesz skonfigurować, lub utwórz nowe.

#### Skonfiguruj dźwięk wywołania narzędzia

Przewiń do sekcji **Tool Call Sound** na dole konfiguracji narzędzia.

![lista rozwijana dźwięku wywołania narzędzia](/docs/_fern-img/093fd6c380e2d51f0b8dbe152377a35e1e4e0e422638519910016b9f1551233d.webp)

Wybierz dźwięk z listy rozwijanej:

* **None**: Dźwięk nie będzie odtwarzany
* **Typing**: Efekt pisania na klawiaturze
* **Elevator Music 1-4**: Różne opcje muzyki tła

#### Skonfiguruj zachowanie dźwięku

Jeśli wybierzesz dźwięk (inny niż „None”), zobaczysz dodatkową opcję **Sound Behavior**:

![lista rozwijana zachowania dźwięku](/docs/_fern-img/00c7f6ddfb1b0240a900c8d6814c8706e045500d92f6a6c263d4a7c962e24fbe.webp)

Wybierz, kiedy dźwięk ma być odtwarzany:

* **With pre-speech**: Dźwięk jest odtwarzany tylko wtedy, gdy agent mówi przed uruchomieniem narzędzia
* **Always play**: Dźwięk jest odtwarzany przy każdym uruchomieniu narzędzia, niezależnie od tego, czy agent najpierw coś powie

#### Zapisz konfigurację

Kliknij **Save**, aby zastosować ustawienia dźwięku wywołania narzędzia.

#### Aktualizacja przez CLI

#### Pobierz konfigurację narzędzia

```bash
elevenlabs tools pull
```

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

Ustaw `tool_call_sound` i `tool_call_sound_behavior`:

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

Użyj `"auto"` dla **With pre-speech** lub `"always"` dla **Always play**.

#### Wypchnij zmiany

```bash
elevenlabs tools push
```

#### Aktualizacja przez API

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

### Konfiguracja na poziomie integracji

W przypadku narzędzi utworzonych przez integracje (serwery MCP, integracje API itd.) możesz ustawić domyślne dźwięki wywołań narzędzi na poziomie integracji:

#### Przejdź do ustawień integracji

Przejdź do **Agent Settings > Integrations** i wybierz integrację.

#### Skonfiguruj domyślny dźwięk

W podsumowaniu integracji znajdź ustawienia **Tool Call Sound**.

![lista rozwijana integracji dźwięku wywołania narzędzia](/docs/_fern-img/9c4c33501c814c3d124d76060853ee6eb8c59c8b4f0cc494d16267e9fe5cf56b.webp)

Wybierz domyślny dźwięk, który będzie stosowany do wszystkich narzędzi z tej integracji, chyba że zostanie zastąpiony na poziomie narzędzia.

#### Zastąp na poziomie narzędzia (opcjonalnie)

Możesz zastąpić domyślne ustawienie na poziomie integracji dla konkretnych narzędzi, konfigurując dźwięki wywołań w ustawieniach danego narzędzia.

## Opcje zachowania dźwięku

Ustawienie zachowania dźwięku określa, kiedy dźwięki wywołań narzędzi są odtwarzane podczas rozmowy:

### With Pre-Speech (Auto)

**Domyślne zachowanie**. Dźwięk jest odtwarzany tylko wtedy, gdy agent mówi przed użyciem narzędzia.

**Przykładowy scenariusz:**

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

**Kiedy używać:**

* Gdy chcesz, aby dźwięki były odtwarzane dopiero po potwierdzeniu żądania przez agenta
* Aby rozmowa przebiegała bardziej naturalnie, gdy cisza po wypowiedzi użytkownika byłaby niezręczna
* Gdy uruchomienie narzędzia następuje bezpośrednio po wypowiedzi agenta

### Always Play

Dźwięk jest odtwarzany przy każdym uruchomieniu narzędzia, niezależnie od tego, czy agent wcześniej coś powie.

**Przykładowy scenariusz:**

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

**Kiedy używać:**

* W przypadku operacji, które zawsze zajmują zauważalną ilość czasu
* Gdy chcesz zapewnić spójną informację dźwiękową przy każdym wywołaniu narzędzia
* W przypadku operacji w tle, które mogą nie wymagać potwierdzenia przez agenta

> **Warning**
>
> Jeśli wybierzesz „Always play”, dźwięk będzie odtwarzany nawet wtedy, gdy agent nie mówi przed użyciem
> narzędzia. Może to spowodować odtworzenie dźwięku zaraz po tym, jak użytkownik skończy mówić, co
> w niektórych kontekstach rozmowy może wydawać się nagłe.

## Dobre praktyki

#### Dopasuj dźwięki do czasu działania narzędzia

W przypadku szybkich operacji (\< 1 sekunda) rozważ użycie „None” lub dźwięku pisania. W przypadku dłuższych operacji (> 3 sekundy) muzyka wind zapewnia lepsze doświadczenie użytkownika.

#### Używaj „With pre-speech” przy potwierdzonych działaniach

Gdy agent wyraźnie potwierdza żądanie przed jego wykonaniem, użyj zachowania „With pre-speech”, aby rozmowa przebiegała naturalnie:

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

#### Konfiguruj na poziomie integracji dla spójności

Jeśli masz wiele narzędzi z tej samej integracji, skonfiguruj dźwięki wywołań narzędzi na poziomie integracji, aby zapewnić spójną informację dźwiękową we wszystkich powiązanych narzędziach.

#### Testuj przy realistycznych opóźnieniach

Testuj dźwięki wywołań narzędzi przy realistycznych opóźnieniach API, aby upewnić się, że informacja dźwiękowa spełnia oczekiwania użytkowników. Weź pod uwagę:

* Opóźnienie sieci do API
* Czas przetwarzania API
* Rozmieszczenie geograficzne użytkowników

#### Zachowaj równowagę z obsługą przerwań

Jeśli agent obsługuje przerwania przez użytkownika, dźwięki wywołań narzędzi zostaną automatycznie zatrzymane, gdy użytkownik przerwie. Upewnij się, że przebieg rozmowy dobrze to obsługuje.

## Przykładowe konfiguracje

### Agent wyszukiwania

**Przypadek użycia**: Agent przeszukujący bazę wiedzy lub bazę danych

**Konfiguracja**:

* Dźwięk wywołania narzędzia: **Typing**
* Zachowanie dźwięku: **With pre-speech**
* Prompt systemowy zawiera: *„Gdy użytkownicy zadają pytania, powiedz „Pozwól, że tego poszukam” przed wywołaniem narzędzia wyszukiwania.”*

### Agent obsługi klienta

**Przypadek użycia**: Agent sprawdzający status zamówień, stan magazynowy lub dane klientów

**Konfiguracja**:

* Dźwięk wywołania narzędzia: **Elevator Music 3**
* Zachowanie dźwięku: **Always play**
* Uzasadnienie: Operacje mogą trwać 2–5 sekund, a muzyka w tle zapewnia lepsze doświadczenie niż cisza

### Wieloetapowy workflow

**Przypadek użycia**: Agent wykonujący kilka kolejnych wywołań narzędzi

**Konfiguracja**:

* Pierwsze narzędzie: **Typing** z **With pre-speech**
* Kolejne narzędzia: **Elevator Music 1** z **Always play**
* Prompt systemowy określa: *„Najpierw potwierdź żądanie, a potem uruchamiaj narzędzia kolejno.”*

## Rozwiązywanie problemów

### Dźwięk się nie odtwarza

**Możliwe przyczyny:**

1. **Brak wypowiedzi przed użyciem narzędzia**: Jeśli używasz zachowania „With pre-speech”, agent musi powiedzieć coś przed uruchomieniem narzędzia. Zaktualizuj prompt systemowy, aby zawierał potwierdzenie.
2. **Szybkie wykonanie**: Jeśli narzędzie kończy działanie w mniej niż około 500 ms, dźwięk może nie mieć czasu, by zostać zauważalnie odtworzony.

## Powiązane materiały

* [Narzędzia webhook](/docs/pl/eleven-agents/customization/tools/webhook-tools) - Dowiedz się, jak konfigurować narzędzia webhook
* [Narzędzia klienckie](/docs/pl/eleven-agents/customization/tools/client-tools) - Dowiedz się, jak działają narzędzia po stronie klienta
* [Narzędzia systemowe](/docs/pl/eleven-agents/customization/tools/system-tools) - Poznaj wbudowane narzędzia platformy
* [Dobre praktyki](/docs/pl/eleven-api/guides/how-to/websockets/multi-context-web-socket) - Ogólne dobre praktyki tworzenia agentów konwersacyjnych