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

### ElevenAgents

- **Evento WebSocket `agent_response_complete`**: Un nuevo [evento de cliente `agent_response_complete`](/docs/es/eleven-agents/customization/events/client-events) se activa exactamente una vez cuando la respuesta de un agente se ha entregado por completo -- después de que terminen toda la generación del LLM, las cadenas de llamadas a herramientas y la reproducción de audio. Tras este evento, el agente solo generará más resultados si el usuario proporciona una nueva entrada o si un tiempo de espera de turno activa un nuevo turno. El evento permite a los clientes detectar de forma fiable el final del turno para agrupar mensajes, activar mediante palabra de activación o actualizar la interfaz tras el turno. Se ha añadido un nuevo valor `AGENT_RESPONSE_COMPLETE` al enum `ClientEvent` y un modelo de respuesta `AgentResponseCompleteClientEvent` correspondiente.

- **Modo de voz previo a la herramienta**: Se ha añadido un nuevo campo `pre_tool_speech` (enum `PreToolSpeechMode`, valor predeterminado `auto`) a la configuración del servidor MCP y a las anulaciones por herramienta. Sustituye al booleano `force_pre_tool_speech`, ahora obsoleto. Valores: `auto` decide si el agente habla antes de la llamada a la herramienta según la latencia reciente de las herramientas, `force` siempre indica al agente que hable y `off` desactiva esta opción por completo.

- **El envío de herramientas respeta el modo de ejecución**: Los nodos de envío de herramientas de los flujos de trabajo ahora respetan correctamente el `execution_mode` de cada herramienta anidada. Si alguna herramienta de un nodo de envío usa `POST_TOOL_SPEECH`, el flujo de trabajo espera a que el audio del turno actual se exponga por completo antes de ejecutar el envío.

- **Tiempo de espera de respuesta MCP**: Se ha añadido un campo `response_timeout_secs` (entero, valor predeterminado `30`, mínimo `5`, máximo `120`) a la configuración del servidor MCP y a las anulaciones por herramienta, que controla el tiempo máximo de espera para que se complete cada llamada a herramienta MCP.

- **Contexto de confianza del agente**: Se ha añadido un campo `trust_context` a los ajustes de plataforma del agente (enum `AgentTrustContext`: `unknown` | `low` | `high`, valor predeterminado `unknown`). `low` es para agentes que atienden a participantes externos no fiables, donde se deben revisar los resultados y limitar el acceso a herramientas; `high` es para agentes que atienden al propietario, cuando es adecuado disponer de acceso completo a las herramientas; `unknown` cubre los agentes creados antes de esta función.

- **Opción de atribución de fuentes**: Se ha añadido un booleano `source_attribution` (valor predeterminado `false`) a la configuración de conversación. Cuando está activado y hay contenido de la base de conocimientos, se indica al LLM que informe de qué fuentes ha utilizado.

- **Filtro de modo de compartición de pruebas**: La ruta [listar pruebas](/docs/es/api-reference/tests/list) ahora acepta un parámetro de consulta `sharing_mode` (`all` | `shared_with_me`, valor predeterminado `all`) para filtrar las pruebas y carpetas y mostrar solo las compartidas con el usuario actual que este no haya creado.

- **Iconos de herramientas y metadatos de ejecución**: Se han añadido los campos `icons` (matriz de `Icon`) y `execution` (`ToolExecution`) al esquema `Tool`. `Icon` incluye `src`, `mimeType` y `sizes` para su visualización en la interfaz, y `ToolExecution.taskSupport` (`forbidden` | `optional` | `required`) declara cómo participa la herramienta en las tareas.

- **Valor predeterminado del compilador de procedimientos**: El valor predeterminado de `ProcedureCompilerMode` ha cambiado de `deterministic` a `append`, y se ha eliminado el valor `llm`. Los agentes existentes que establecen explícitamente `deterministic` no se ven afectados.

- **Metadatos de atribución de RAG y de la base de conocimientos**: Se ha añadido `used_static_kb_document_ids` (matriz de cadenas) a `ConversationHistoryTranscriptCommonModel` y `ConversationHistoryTranscriptResponseModel`, y `used_chunk_ids` a `RagRetrievalInfo`, mostrando exactamente qué documentos de la base de conocimientos y fragmentos de RAG han contribuido a cada turno de la transcripción.

- **Refactorización de variables dinámicas**: `dynamic_variables` y `dynamic_variable_placeholders` ahora hacen referencia a los esquemas unificados `DynamicVariableValueType-Input` / `DynamicVariableValueType-Output` (en sustitución de los anteriores esquemas `DynamicVariableContainerValueType-*`), con una compatibilidad más amplia con valores anidados y de lista. `DynamicVariableAssignment` incorpora un campo `preserve_native_type` para conservar valores tipados en lugar de convertirlos en cadenas.

### Limpiar Audio

- **Rutas de historial**: Dos nuevas rutas exponen tu historial de limpieza de audio.
  - [Listar historial de limpieza de audio](/docs/es/api-reference/audio-isolation/list) (`GET /v1/audio-isolation/history`) devuelve una lista paginada de todas tus generaciones de limpieza de audio. Admite los parámetros de consulta `page_size`, `page` y `search`.
  - [Eliminar elemento del historial de limpieza de audio](/docs/es/api-reference/audio-isolation/delete) (`DELETE /v1/audio-isolation/history/{history_item_id}`) elimina un elemento específico y sus archivos multimedia asociados.

### Voz a Texto

- **Términos clave en tiempo real y modo literal**: El [WebSocket de Scribe en tiempo real](/docs/es/api-reference/speech-to-text/v-1-speech-to-text-realtime) ahora acepta un parámetro `keyterms` (matriz de cadenas, máximo 50 entradas de hasta 20 caracteres cada una) para orientar el modelo hacia términos específicos, y un booleano `no_verbatim` para eliminar muletillas, falsos comienzos y disfluencias de las transcripciones. Ambos parámetros se devuelven en el evento `session_started`. Disponible en el [SDK de JavaScript](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0), el [SDK de Python](https://github.com/elevenlabs/elevenlabs-python) y el SDK de cliente para navegador/Node [`@elevenlabs/client`](https://github.com/elevenlabs/packages/tree/main/packages/client).

### Lanzamientos de SDK

#### SDK de Python

- [v2.45.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.45.0) - Regeneración de Fern para el esquema de la API del 27 de abril de 2026, incluidas las rutas de historial de limpieza de audio, ejecuciones de herramientas, `pre_tool_speech` y `response_timeout_secs` de MCP, y el evento de cliente `agent_response_complete`. También incluye una corrección de la indicación de instalación de notebooks en el README.
- [v2.44.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.44.0) - Regeneración de Fern para el esquema de la API del 21 de abril de 2026, que incorpora el campo `trust_context`, el modo `pre_tool_speech`, compatibilidad con transcripción de recursos y configuración de tiempo de espera de respuesta MCP.

#### SDK de JavaScript

- [v2.45.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0) - Se han añadido las opciones `keyterms` (matriz de cadenas, máximo 50 términos clave de hasta 20 caracteres cada uno) y `noVerbatim` (booleano) al cliente de Scribe en tiempo real. Los `keyterms` se envían como parámetros de consulta repetidos en la URL de WebSocket para orientar la transcripción, y `noVerbatim` elimina muletillas y disfluencias. Ambos campos también se añaden a la interfaz tipada `Config` para la devolución de `session_started`. También incluye la regeneración de Fern del 27 de abril de 2026 ([#376](https://github.com/elevenlabs/elevenlabs-js/pull/376)).
- [v2.44.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.44.0) - Regeneración de Fern para el esquema de la API del 21 de abril de 2026, que incorpora el campo `trust_context`, el modo `pre_tool_speech` y la configuración de tiempo de espera de respuesta MCP.

#### SDK de Swift

- [v3.1.4](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.4) - Se ha corregido un problema por el que el micrófono local seguía publicando tras desconectarse un agente (tiempo de espera de silencio o herramienta `end_call`). Ahora `onAgentDisconnected` desconecta la sala de LiveKit y desmonta el estado de la conversación, y `onDisconnect` se activa con un motivo `.agent`. `ConnectionManaging.onAgentDisconnected` ahora es `async`. Se ha eliminado el contenedor `ConversationConnectionManager` sin usar.

#### Paquetes

- [@elevenlabs/client@1.3.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.1) - Se ha corregido que el sonido de llamada a herramienta del agente se interpretara como voz del usuario e interrumpiera al agente durante la ejecución de herramientas.
- [@elevenlabs/client@1.3.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.0) - Se ha añadido compatibilidad con la ruta [subir archivo de conversación](/docs/es/api-reference/conversations/upload-file), que permite a los clientes adjuntar archivos a una conversación en curso directamente desde el SDK de cliente.
- [@elevenlabs/react@1.2.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.1), [@elevenlabs/react@1.2.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.0) - Actualizado a `@elevenlabs/client@1.3.1` / `@elevenlabs/client@1.3.0`, incorporando la corrección del sonido de llamada a herramienta y la compatibilidad para subir archivos de conversación.
- [@elevenlabs/react-native@1.1.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.3), [@elevenlabs/react-native@1.1.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.2) - Actualizado a la versión más reciente de `@elevenlabs/client` con las mismas correcciones.
- [@elevenlabs/convai-widget-core@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.6), [@elevenlabs/convai-widget-embed@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.6) - Actualizado a `@elevenlabs/client@1.3.1` para corregir el sonido de llamada a herramienta.
- [@elevenlabs/convai-widget-core@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.5), [@elevenlabs/convai-widget-embed@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.5) - Actualizado a `@elevenlabs/client@1.3.0` para añadir compatibilidad con la subida de archivos de conversación.

### API

<Accordion title="Ver cambios de la API">

## Nuevas rutas

- [Listar historial de limpieza de audio](/docs/es/api-reference/audio-isolation/list) - `GET /v1/audio-isolation/history`
- [Eliminar elemento del historial de limpieza de audio](/docs/es/api-reference/audio-isolation/delete) - `DELETE /v1/audio-isolation/history/{history_item_id}`
- [Obtener ejecuciones de herramientas](/docs/es/api-reference/tools/get-executions) - `GET /v1/convai/tools/{tool_id}/executions` devuelve ejecuciones de herramientas paginadas para una herramienta específica con filtros opcionales `cursor`, `page_size`, `is_error`, `agent_id`, `branch_id`, `start_time` y `end_time`

## Rutas actualizadas

### ElevenAgents

- [Crear agente](/docs/es/api-reference/agents/create), [Obtener agente](/docs/es/api-reference/agents/get), [Actualizar agente](/docs/es/api-reference/agents/update)

  - Se ha añadido el campo `trust_context` (enum `AgentTrustContext`: `unknown` | `low` | `high`, valor predeterminado `unknown`) a `AgentPlatformSettingsRequestModel`
  - Se ha añadido el campo `source_attribution` (booleano, valor predeterminado `false`) a `ConversationConfig`

- [Actualizar configuración del servidor MCP](/docs/es/api-reference/mcp/update), [Crear servidor MCP](/docs/es/api-reference/mcp/create)

  - Se ha añadido el campo `pre_tool_speech` (enum `PreToolSpeechMode`: `auto` | `force` | `off`, valor predeterminado `auto`)
  - Se ha añadido el campo `response_timeout_secs` (entero, valor predeterminado `30`, mínimo `5`, máximo `120`)

- [Crear anulación de configuración](/docs/es/api-reference/mcp/tool-configuration/create), [Actualizar anulación de configuración](/docs/es/api-reference/mcp/tool-configuration/update)

  - Se ha añadido el campo `pre_tool_speech` (enum `PreToolSpeechMode`, admite valores nulos, opcional)
  - Se ha añadido el campo `response_timeout_secs` (entero, admite valores nulos, opcional)
  - Se ha añadido el campo `response_mocks` a `MCPToolConfigOverride-Input` / `MCPToolConfigOverride-Output`
  - `force_pre_tool_speech` se ha marcado como obsoleto; usa `pre_tool_speech` en su lugar

- [Listar pruebas](/docs/es/api-reference/tests/list)

  - Se ha añadido el parámetro de consulta opcional `sharing_mode` (enum `TestSharingMode`: `all` | `shared_with_me`, valor predeterminado `all`)

- [Simular conversación](/docs/es/api-reference/agents/simulate-conversation), [Transmitir simulación de conversación](/docs/es/api-reference/agents/simulate-conversation-stream)

  - Se han refactorizado las cargas útiles de `dynamic_variables` y `dynamic_variable_placeholders` para que hagan referencia a los esquemas unificados `DynamicVariableValueType-Input` / `DynamicVariableValueType-Output` con una compatibilidad más amplia con valores anidados y de lista

- Esquema `Tool`

  - Se ha añadido el campo `icons` (matriz de `Icon`, admite valores nulos) para su visualización en la interfaz
  - Se ha añadido el campo `execution` (`ToolExecution`, admite valores nulos), incluido `taskSupport` (`forbidden` | `optional` | `required`)

- Enum `ClientEvent`

  - Se ha añadido el valor `agent_response_complete` con el nuevo modelo de respuesta `AgentResponseCompleteClientEvent`

- Enum `ProcedureCompilerMode`

  - El valor predeterminado ha cambiado de `deterministic` a `append`
  - Se ha eliminado el valor `llm`

- `ConversationHistoryTranscriptCommonModel`, `ConversationHistoryTranscriptResponseModel`

  - Se ha añadido el campo `used_static_kb_document_ids` (matriz de cadenas)

- `RagRetrievalInfo`

  - Se ha añadido el campo `used_chunk_ids` (matriz de cadenas)

- `DynamicVariableAssignment`

  - Se ha añadido el campo `preserve_native_type` (booleano) para conservar valores tipados en lugar de convertirlos en cadenas

- Nodos de flujo de trabajo

  - Se ha añadido el campo `auto_advance_after_first_response` a los esquemas de nodos de flujo de trabajo pertinentes

- Documentación de configuración de herramientas
  - Se ha añadido el campo `response_body_schema` para documentar la estructura de respuesta esperada

### Espacios de trabajo

- `GetUserSubscriptionResponseModel`

  - Se ha añadido el campo `max_credit_limit_extension`

- [Obtener el uso del espacio de trabajo por producto a lo largo del tiempo](/docs/es/api-reference/workspace/usage/get-usage-by-product-over-time)
  - Se ha reforzado la validación de solicitudes: los mínimos de `start_time` y `end_time` se han elevado a `2020-01-01`, y se han añadido descripciones a ambos campos. El resumen de la ruta se ha renombrado a `Get Workspace Usage`.

### Otros

- Nuevo enum compartido `Currency` con los valores `eur`, `inr`, `usd`, que sustituye las cadenas de moneda en línea en varios esquemas.
- Los nuevos esquemas `AssetTranscription` y `AssetTranscriptionData` amplían los modelos de recursos con compatibilidad para transcripción.
- Los nuevos `PendingBlocksMetadataModel` y `PendingExternalAudiosMetadataModel` proporcionan metadatos más completos sobre las tareas pendientes.
- Se ha añadido el nuevo valor `InVPC` a los enums relacionados con fuentes.
- Los `keyterms` de transcripción ahora tienen restricciones de longitud explícitas en la especificación.
- Se han añadido los nuevos esquemas `MemoryEntrySearchResult`, `ConversationSource` y `ManualSource`.

</Accordion>