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

# Sonidos de llamadas a herramientas

## Descripción general

Los sonidos de llamadas a herramientas proporcionan respuesta de audio ambiental durante la ejecución de herramientas, lo que crea una experiencia de conversación más natural y atractiva. Cuando tu agente ejecuta una herramienta —por ejemplo, al obtener datos de una API o procesar una solicitud—, estos sonidos ayudan a llenar los momentos de silencio e indican a usuarios que el agente está trabajando activamente.

ElevenLabs Agents admite varios sonidos ambientales integrados que puedes configurar tanto a nivel de herramienta como de integración, lo que te permite controlar con precisión cuándo y cómo se reproducen los sonidos durante tus conversaciones.

> **Note**
>
> Los sonidos de llamadas a herramientas solo se reproducen durante la ejecución de herramientas. Para un sonido de fondo continuo, consulta [Entorno de audio](/docs/es/eleven-agents/customization/voice/audio-environment).

## Casos de uso

Los sonidos de llamadas a herramientas son especialmente eficaces en situaciones en las que:

* **Las llamadas a la API tardan en completarse**: Reproduce música ambiental o sonidos de tecleo mientras obtienes datos de servicios externos
* **Operaciones de larga duración**: Proporciona respuesta de audio durante consultas a bases de datos, cálculos complejos o integraciones de terceros
* **Flujo natural de la conversación**: Llena los huecos de la conversación para evitar silencios incómodos
* **Expectativas de usuarios**: Indica a usuarios que el agente está procesando su solicitud en lugar de tener problemas técnicos

> **Info**
>
> Los sonidos de llamadas a herramientas son opcionales. Si prefieres que la ejecución de herramientas sea silenciosa, deja el ajuste de sonido de llamada a
> herramienta como "None".

## Sonidos disponibles

ElevenLabs ofrece las siguientes opciones de audio ambiental:

| Tipo de sonido     | Descripción                      | Ideal para                                    |
| ------------------ | -------------------------------- | --------------------------------------------- |
| None               | Sin sonido durante la ejecución  | Operaciones rápidas, flujos silenciosos       |
| Typing             | Efecto de sonido de tecleo       | Consultas de búsqueda, procesamiento de texto |
| Elevator Music 1-4 | Música de fondo ligera (animada) | Esperas más largas, uso general               |

> **Tip**
>
> Puedes previsualizar cada sonido en el panel de control haciendo clic en el botón de reproducción junto al menú desplegable al
> configurar los sonidos de llamadas a herramientas.

## Configuración

Puedes configurar los sonidos de llamadas a herramientas en dos lugares; la configuración a nivel de herramienta tiene prioridad:

### Configuración a nivel de herramienta

Configura sonidos para herramientas individuales en los ajustes de herramientas de tu agente.

#### Actualizar desde el panel de control

#### Ve a la configuración de la herramienta

En la sección **Agent** de los ajustes de tu agente, selecciona la herramienta que quieres configurar o crea una nueva.

#### Configura el sonido de llamada a herramienta

Desplázate hasta la sección **Tool Call Sound**, al final de la configuración de la herramienta.

![menú desplegable de sonido de llamada a herramienta](/docs/_fern-img/093fd6c380e2d51f0b8dbe152377a35e1e4e0e422638519910016b9f1551233d.webp)

Selecciona un sonido en el menú desplegable:

* **None**: No se reproducirá ningún sonido
* **Typing**: Efecto de tecleo en teclado
* **Elevator Music 1-4**: Varias opciones de música ambiental de fondo

#### Configura el comportamiento del sonido

Si has seleccionado un sonido (que no sea "None"), verás una opción adicional: **Sound Behavior**:

![menú desplegable de comportamiento del sonido](/docs/_fern-img/00c7f6ddfb1b0240a900c8d6814c8706e045500d92f6a6c263d4a7c962e24fbe.webp)

Elige cuándo debe reproducirse el sonido:

* **With pre-speech**: El sonido se reproduce solo cuando el agente habla antes de ejecutar la herramienta
* **Always play**: El sonido se reproduce durante cada ejecución de la herramienta, independientemente de si el agente habla primero

#### Guarda la configuración

Haz clic en **Save** para aplicar la configuración de sonido de llamadas a herramientas.

#### Actualizar mediante la CLI

#### Obtén la configuración de la herramienta

```bash
elevenlabs tools pull
```

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

Configura `tool_call_sound` y `tool_call_sound_behavior`:

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

Usa `"auto"` para **With pre-speech** o `"always"` para **Always play**.

#### Envía tus cambios

```bash
elevenlabs tools push
```

#### Actualizar mediante la 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",
    },
  },
});
```

### Configuración a nivel de integración

Para herramientas creadas mediante integraciones (servidores MCP, integraciones de API, etc.), puedes establecer sonidos de llamadas a herramientas predeterminados a nivel de integración:

#### Ve a los ajustes de integración

Ve a **Agent Settings > Integrations** y selecciona tu integración.

#### Configura el sonido predeterminado

En la descripción general de la integración, localiza los ajustes de **Tool Call Sound**.

![menú desplegable de integraciones de sonidos de llamadas a herramientas](/docs/_fern-img/9c4c33501c814c3d124d76060853ee6eb8c59c8b4f0cc494d16267e9fe5cf56b.webp)

Selecciona un sonido predeterminado que se aplicará a todas las herramientas de esta integración, salvo que se anule a nivel de herramienta.

#### Anula el ajuste a nivel de herramienta (opcional)

Puedes anular el valor predeterminado a nivel de integración para herramientas concretas configurando los sonidos de llamadas a herramientas en los ajustes individuales de cada herramienta.

## Opciones de comportamiento del sonido

El ajuste de comportamiento del sonido determina cuándo se reproducen los sonidos de llamadas a herramientas durante una conversación:

### Con habla previa (automático)

**Comportamiento predeterminado**. El sonido se reproduce solo cuando el agente habla antes de usar la herramienta.

**Ejemplo:**

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

**Cuándo usarlo:**

* Cuando quieres que los sonidos se reproduzcan solo después de que el agente haya confirmado la solicitud
* Para un flujo de conversación más natural, en el que el silencio tras la intervención de usuario sería incómodo
* Cuando la ejecución de la herramienta sigue inmediatamente a la intervención del agente

### Reproducir siempre

El sonido se reproduce durante cada ejecución de herramienta, independientemente de si el agente habla antes.

**Ejemplo:**

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

**Cuándo usarlo:**

* Para operaciones que siempre tardan un tiempo apreciable
* Cuando quieres una respuesta de audio coherente para cada llamada a herramienta
* Para operaciones en segundo plano que quizá no requieran confirmación del agente

> **Warning**
>
> Si seleccionas "Always play", el sonido se reproducirá incluso cuando el agente no hable antes de usar
> la herramienta. Esto puede hacer que los sonidos se reproduzcan inmediatamente después de que usuario termine de hablar, lo que
> puede parecer brusco en algunos contextos de conversación.

## Buenas prácticas

#### Ajusta los sonidos al tiempo de ejecución de la herramienta

Para operaciones rápidas (\< 1 segundo), considera usar "None" o el sonido de tecleo. Para operaciones más largas (> 3 segundos), las opciones de música de ascensor ofrecen una mejor experiencia de usuario.

#### Usa "With pre-speech" para acciones confirmadas

Cuando tu agente confirme explícitamente una solicitud antes de ejecutarla, usa el comportamiento "With pre-speech" para crear un flujo de conversación natural:

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

#### Configura a nivel de integración para mantener la coherencia

Si tienes varias herramientas de la misma integración, configura los sonidos de llamadas a herramientas a nivel de integración para garantizar una respuesta de audio coherente en todas las herramientas relacionadas.

#### Haz pruebas con latencias realistas

Prueba los sonidos de llamadas a herramientas con latencias de API realistas para garantizar que la respuesta de audio cumpla las expectativas de usuarios. Ten en cuenta:

* La latencia de red de tus API
* El tiempo de procesamiento de la API
* La distribución geográfica de tus usuarios

#### Equilibra el manejo de interrupciones

Si tu agente admite interrupciones de usuarios, los sonidos de llamadas a herramientas se detendrán automáticamente cuando usuario interrumpa. Asegúrate de que el flujo de conversación gestione esto correctamente.

## Ejemplos de configuración

### Agente de búsqueda

**Caso de uso**: Agente que busca en una base de conocimientos o base de datos

**Configuración**:

* Sonido de llamada a herramienta: **Typing**
* Comportamiento del sonido: **With pre-speech**
* El prompt del sistema incluye: *"Cuando usuarios hagan preguntas, di «Déjame buscarlo» antes de llamar a la herramienta de búsqueda."*

### Agente de atención al cliente

**Caso de uso**: Agente que consulta el estado de pedidos, inventario o registros de clientes

**Configuración**:

* Sonido de llamada a herramienta: **Elevator Music 3**
* Comportamiento del sonido: **Always play**
* Motivo: Las operaciones pueden tardar entre 2 y 5 segundos, y la música de fondo ofrece una mejor experiencia que el silencio

### Flujo de trabajo de varios pasos

**Caso de uso**: Agente que realiza varias llamadas a herramientas secuenciales

**Configuración**:

* Primera herramienta: **Typing** con **With pre-speech**
* Herramientas posteriores: **Elevator Music 1** con **Always play**
* El prompt del sistema coordina: *"Primero confirma la solicitud y, después, ejecuta las herramientas secuencialmente."*

## Solución de problemas

### El sonido no se reproduce

**Posibles causas:**

1. **Sin habla previa**: Si usas el comportamiento "With pre-speech", el agente debe hablar antes de que se ejecute la herramienta. Actualiza el prompt del sistema para incluir una confirmación.
2. **Ejecución rápida**: Si la herramienta se completa en menos de unos 500 ms, puede que el sonido no tenga tiempo de reproducirse de forma perceptible.

## Recursos relacionados

* [Herramientas webhook](/docs/es/eleven-agents/customization/tools/webhook-tools) - Aprende a configurar herramientas webhook
* [Herramientas de cliente](/docs/es/eleven-agents/customization/tools/client-tools) - Comprende la ejecución de herramientas en el lado del cliente
* [Herramientas del sistema](/docs/es/eleven-agents/customization/tools/system-tools) - Explora las herramientas integradas de la plataforma
* [Buenas prácticas](/docs/es/eleven-api/guides/how-to/websockets/multi-context-web-socket) - Buenas prácticas generales para crear agentes conversacionales