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

# Ljud vid verktygsanrop

## Översikt

Verktygsanropsljud ger diskret ljudåterkoppling medan verktyg körs, vilket skapar en mer naturlig och engagerande konversationsupplevelse. När din agent kör ett verktyg – till exempel hämtar data från ett API eller bearbetar en begäran – hjälper dessa ljud till att fylla tysta stunder och visar användarna att agenten arbetar aktivt.

ElevenLabs Agents stöder flera inbyggda omgivningsljud som du kan konfigurera både på verktygsnivå och integrationsnivå. Det ger dig detaljerad kontroll över när och hur ljud spelas upp i dina konversationer.

> **Note**
>
> Verktygsanropsljud spelas bara upp medan verktyget körs. För ett kontinuerligt bakgrundsljud, se [Ljudmiljö ](/docs/sv/eleven-agents/customization/voice/audio-environment).

## Användningsfall

Verktygsanropsljud är särskilt effektiva i situationer där:

* **API-anrop tar tid att slutföra**: Spela upp omgivningsmusik eller skrivljud medan data hämtas från externa tjänster
* **Långvariga åtgärder**: Ge ljudåterkoppling under databasfrågor, komplexa beräkningar eller tredjepartsintegrationer
* **Naturligt konversationsflöde**: Fyll luckor i konversationen för att undvika obekväma tystnader
* **Användarnas förväntningar**: Signalera att agenten bearbetar deras begäran i stället för att ha tekniska problem

> **Info**
>
> Verktygsanropsljud är valfria. Om du föredrar tyst verktygskörning låter du bara inställningen för
> verktygsanropsljud vara "None".

## Tillgängliga ljud

ElevenLabs erbjuder följande alternativ för omgivningsljud:

| Ljudtyp            | Beskrivning                         | Passar bäst för                      |
| ------------------ | ----------------------------------- | ------------------------------------ |
| None               | Inget ljud medan verktyget körs     | Snabba åtgärder, tysta arbetsflöden  |
| Typing             | Ljudeffekt av tangentbordsskrivning | Sökfrågor, textbearbetning           |
| Elevator Music 1-4 | Lätt bakgrundsmusik (upbeat)        | Längre väntetider, allmän användning |

> **Tip**
>
> Du kan förhandsgranska varje ljud i kontrollpanelen genom att klicka på uppspelningsknappen bredvid rullgardinsmenyn när
> du konfigurerar verktygsanropsljud.

## Konfiguration

Verktygsanropsljud kan konfigureras på två ställen, där konfiguration på verktygsnivå har företräde:

### Konfiguration på verktygsnivå

Konfigurera ljud för enskilda verktyg i agentens verktygsinställningar.

#### Uppdatera via kontrollpanelen

#### Gå till verktygskonfigurationen

I avsnittet **Agent** i agentens inställningar väljer du verktyget du vill konfigurera eller skapar ett nytt verktyg.

#### Konfigurera verktygsanropsljud

Bläddra till avsnittet **Tool Call Sound** längst ned i verktygskonfigurationen.

![rullgardinsmeny för verktygsanropsljud](/docs/_fern-img/093fd6c380e2d51f0b8dbe152377a35e1e4e0e422638519910016b9f1551233d.webp)

Välj ett ljud i rullgardinsmenyn:

* **None**: Inget ljud spelas upp
* **Typing**: Effekt för tangentbordsskrivning
* **Elevator Music 1-4**: Olika alternativ för omgivande bakgrundsmusik

#### Konfigurera ljudbeteende

Om du har valt ett ljud (inte "None") visas ytterligare alternativet **Sound Behavior**:

![rullgardinsmeny för ljudbeteende](/docs/_fern-img/00c7f6ddfb1b0240a900c8d6814c8706e045500d92f6a6c263d4a7c962e24fbe.webp)

Välj när ljudet ska spelas upp:

* **With pre-speech**: Ljudet spelas bara när agenten talar innan verktyget körs
* **Always play**: Ljudet spelas vid varje verktygskörning, oavsett om agenten talar först

#### Spara konfigurationen

Klicka på **Save** för att tillämpa inställningarna för verktygsanropsljud.

#### Uppdatera via CLI

#### Hämta verktygskonfigurationen

```bash
elevenlabs tools pull
```

#### Redigera \`tool\_configs/\<tool-name>.json\`

Ange `tool_call_sound` och `tool_call_sound_behavior`:

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

Använd `"auto"` för **With pre-speech** eller `"always"` för **Always play**.

#### Skicka ändringarna

```bash
elevenlabs tools push
```

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

### Konfiguration på integrationsnivå

För verktyg som skapats via integrationer (MCP-servrar, API-integrationer osv.) kan du ange standardljud för verktygsanrop på integrationsnivå:

#### Gå till integrationsinställningarna

Gå till **Agent Settings > Integrations** och välj din integration.

#### Konfigurera standardljud

Leta upp inställningarna för **Tool Call Sound** i integrationsöversikten.

![rullgardinsmeny för integrationer med verktygsanropsljud](/docs/_fern-img/9c4c33501c814c3d124d76060853ee6eb8c59c8b4f0cc494d16267e9fe5cf56b.webp)

Välj ett standardljud som gäller för alla verktyg från den här integrationen, om det inte åsidosätts på verktygsnivå.

#### Åsidosätt på verktygsnivå (valfritt)

Du kan åsidosätta standardinställningen på integrationsnivå för specifika verktyg genom att konfigurera verktygsanropsljud i inställningarna för det enskilda verktyget.

## Alternativ för ljudbeteende

Inställningen för ljudbeteende avgör när verktygsanropsljud spelas upp under en konversation:

### With Pre-Speech (Auto)

**Standardbeteende**. Ljudet spelas bara när agenten talar innan verktyget används.

**Exempelscenario:**

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

**När ska det användas:**

* När du vill att ljud bara ska spelas efter att agenten har bekräftat begäran
* För ett mer naturligt konversationsflöde där tystnad efter användarens tal skulle kännas obekväm
* När verktyget körs direkt efter att agenten har talat

### Always Play

Ljudet spelas upp vid varje verktygskörning, oavsett om agenten har talat innan.

**Exempelscenario:**

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

**När ska det användas:**

* För åtgärder som alltid tar märkbar tid
* När du vill ha konsekvent ljudåterkoppling för varje verktygsanrop
* För bakgrundsåtgärder som kanske inte kräver att agenten bekräftar dem

> **Warning**
>
> Om du väljer "Always play" spelas ljudet upp även när agenten inte talar innan verktyget används.
> Det kan leda till att ljud spelas upp direkt efter att användaren har talat klart, vilket
> kan kännas abrupt i vissa konversationssammanhang.

## Bästa praxis

#### Anpassa ljud efter verktygets körtid

För snabba åtgärder (\< 1 sekund) bör du överväga att använda "None" eller skrivljudet. För längre åtgärder (> 3 sekunder) ger alternativen för hissmusik en bättre användarupplevelse.

#### Använd "With pre-speech" för bekräftade åtgärder

När agenten uttryckligen bekräftar en begäran innan den körs använder du beteendet "With pre-speech" för att skapa ett naturligt konversationsflöde:

**`Systemprompt`**

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

#### Konfigurera på integrationsnivå för konsekvens

Om du har flera verktyg från samma integration kan du konfigurera verktygsanropsljud på integrationsnivå för att säkerställa konsekvent ljudåterkoppling för alla relaterade verktyg.

#### Testa med realistiska svarstider

Testa verktygsanropsljuden med realistiska API-svarstider för att säkerställa att ljudåterkopplingen motsvarar användarnas förväntningar. Tänk på:

* Nätverksfördröjning till dina API:er
* API-bearbetningstid
* Användarnas geografiska spridning

#### Balansera med hantering av avbrott

Om agenten stöder användaravbrott stoppas verktygsanropsljud automatiskt när användaren avbryter. Se till att konversationsflödet hanterar detta smidigt.

## Exempelkonfigurationer

### Sökagent

**Användningsfall**: Agent som söker i en kunskapsbas eller databas

**Konfiguration**:

* Verktygsanropsljud: **Typing**
* Ljudbeteende: **With pre-speech**
* Systemprompten innehåller: *"När användare ställer frågor, säg 'Låt mig söka efter det' innan du anropar sökverktyget."*

### Kundtjänstagent

**Användningsfall**: Agent som kontrollerar orderstatus, lagerstatus eller kunduppgifter

**Konfiguration**:

* Verktygsanropsljud: **Elevator Music 3**
* Ljudbeteende: **Always play**
* Motivering: Åtgärder kan ta 2–5 sekunder, och bakgrundsmusik ger en bättre upplevelse än tystnad

### Arbetsflöde i flera steg

**Användningsfall**: Agent som utför flera verktygsanrop i följd

**Konfiguration**:

* Första verktyget: **Typing** med **With pre-speech**
* Efterföljande verktyg: **Elevator Music 1** med **Always play**
* Systemprompten styr: *"Bekräfta först begäran och kör sedan verktygen i följd."*

## Felsökning

### Ljudet spelas inte upp

**Möjliga orsaker:**

1. **Inget förtal**: Om du använder beteendet "With pre-speech" måste agenten tala innan verktyget körs. Uppdatera systemprompten så att den innehåller en bekräftelse.
2. **Snabb körning**: Om verktyget slutförs på mindre än \~500 ms kanske ljudet inte hinner spelas upp märkbart.

## Relaterade resurser

* [Webhook-verktyg](/docs/sv/eleven-agents/customization/tools/webhook-tools) - Läs hur du konfigurerar webhook-verktyg
* [Klientverktyg](/docs/sv/eleven-agents/customization/tools/client-tools) - Förstå verktygskörning på klientsidan
* [Systemverktyg](/docs/sv/eleven-agents/customization/tools/system-tools) - Utforska inbyggda plattformsverktyg
* [Bästa praxis](/docs/sv/eleven-api/guides/how-to/websockets/multi-context-web-socket) - Allmän bästa praxis för att bygga konversationsagenter