> 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 - **Nuevas opciones de configuración del widget**: Ya están disponibles varios ajustes nuevos para el widget de conversación de ElevenAgents en el panel de agentes: - **Widget plegable** (`widget.dismissible`): Permite que usuarios minimicen o cierren el widget durante una conversación. - **Indicador de acción** (`widget.show_agent_status`): Muestra un indicador visual cuando el agente está usando herramientas activamente, con estados distintos para en curso, completado y error. Al activar este ajuste, se añaden automáticamente `agent_tool_request` y `agent_tool_response` a los eventos de cliente del agente. - **Visualización del ID de conversación** (`widget.show_conversation_id`): Muestra el ID de conversación a usuarios cuando termina una llamada. El valor predeterminado es `true` tanto para agentes nuevos como existentes. - **Visibilidad de etiquetas de audio** (`widget.strip_audio_tags`): Oculta las etiquetas de audio en las transcripciones de conversaciones. El valor predeterminado es `true` tanto para agentes nuevos como existentes. - **Tema de resaltado de sintaxis** (`widget.syntax_highlight_theme`): Configura el resaltado de bloques de código en las transcripciones. Acepta `null` (Automático), `light` o `dark`. - **Pruebas de agentes con carpetas**: La ruta [List agent tests](/docs/es/api-reference/tests/list) ahora permite organizar pruebas en carpetas. Se han añadido los parámetros de consulta `parent_folder_id`, `include_folders` y `sort_mode` para listas filtradas. Las rutas de creación y actualización de pruebas aceptan `parent_folder_id` para asignar pruebas a carpetas, y los resúmenes de pruebas ahora incluyen el tipo de entidad, la ruta de la carpeta principal y el número de elementos secundarios. - **Nodo `say` de workflow **: Se ha añadido un nuevo tipo de nodo `say` a los workflows de agentes (`WorkflowSayNodeModel`). Este nodo admite `conversation_config`, `additional_prompt` y anulaciones de herramientas y base de conocimiento. La carga útil del mensaje del nodo usa una unión discriminada con dos variantes: `literal` (texto estático mediante `text`) y `prompt` (generado por LLM mediante `prompt`). - **Configuración de herramientas SMB**: Se ha formalizado el esquema `SMBToolConfig` con un objeto `params` discriminado y obligatorio. Los tipos de operación compatibles son `create`, `list`, `search`, `update` y `delete`, todos aplicables a categorías de entidades SMB como clientes, personal, servicios, productos y activos. - **Idioma del resumen para agentes**: Se ha añadido el campo `summary_language` a la configuración del agente para especificar el idioma de los resúmenes posteriores a la conversación. - **Grabación de llamadas de Twilio**: Se ha añadido el campo opcional `call_recording_enabled` al cuerpo de la solicitud de [Twilio outbound call](/docs/es/api-reference/twilio/outbound-call) para activar la grabación de llamadas salientes. - **Indicador de mensajería de WhatsApp**: Se ha añadido el indicador `enable_messaging` a los modelos de cuentas de WhatsApp y a las solicitudes de actualización para controlar si la mensajería está activada para un número de teléfono determinado. ### Diccionarios de pronunciación - **Establecer todas las reglas de una vez**: La nueva ruta [Set rules](/docs/es/api-reference/pronunciation-dictionaries/rules/set) (`POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules`) sustituye todas las reglas existentes de un diccionario de pronunciación en una sola llamada, como alternativa a añadir o eliminar reglas individuales de forma incremental. - **Opciones de coincidencia de reglas**: Se han añadido los campos `case_sensitive` (booleano) y `word_boundaries` (booleano) a las definiciones de reglas de diccionarios de pronunciación para controlar con mayor precisión cómo las reglas coinciden con el texto. ### Música - **Subir audio**: La nueva ruta [Upload music](/docs/es/api-reference/music/upload) (`POST /v1/music/upload`) acepta una solicitud `multipart/form-data` con un archivo de audio. Opcionalmente extrae un plan de composición del audio subido y devuelve un `MusicUploadResponse` con un `song_id`. - **Compatibilidad con nombres fonéticos**: Se ha añadido el parámetro `use_phonetic_names` a las rutas [Generate music](/docs/es/api-reference/music/compose), [Generate music detailed](/docs/es/api-reference/music/compose-detailed) y [Stream music](/docs/es/api-reference/music/stream). - **ID de canción en las respuestas**: Las respuestas de generación de música ahora muestran el campo `song_id`, lo que facilita hacer referencia a canciones generadas en llamadas posteriores a la API. ### Audio Native - **Actualizar contenido de proyectos desde una URL**: La nueva ruta [Update content](/docs/es/api-reference/audio-native/update-content) (`POST /v1/audio-native/content`) permite actualizar un proyecto de AudioNative proporcionando una URL. La ruta extrae el contenido de la URL y lo pone en cola para su conversión y publicación automática. ### Voces - **Marcadores de voz**: Se ha añadido el campo `bookmarked` a las solicitudes de actualización de voces y `is_bookmarked` a los objetos de respuesta de voces, lo que permite que usuarios guarden voces en marcadores para acceder a ellas fácilmente. ### Lanzamientos de SDK #### SDK de JavaScript - [v2.37.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.37.0) - Se ha añadido compatibilidad para mostrar `song_id` en las respuestas de generación de música. Se ha actualizado para incluir los últimos cambios del esquema de la API tras la regeneración de Fern. #### SDK de Python - [v2.37.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.37.0) - Se ha añadido compatibilidad con los nuevos parámetros de generación de música y para mostrar `song_id` en las respuestas de generación de música. Se ha actualizado para incluir los últimos cambios del esquema de la API tras la regeneración de Fern. #### Paquetes - [@elevenlabs/convai-widget-core@0.10.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.0) - Se ha propagado `event_id` mediante callbacks de transcripción y streaming. Se ha refactorizado el seguimiento del estado de las herramientas, pasando de usar Map a entradas de transcripción en línea con una utilidad `display-transcript`. Se ha añadido la opción de configuración `show-conversation-id` (booleano, `true` de forma predeterminada) para controlar la visibilidad del ID de conversación en los mensajes de desconexión. - [@elevenlabs/convai-widget-embed@0.10.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.0) - Se ha propagado `event_id` mediante callbacks de transcripción y streaming. Se ha refactorizado el seguimiento del estado de las herramientas para usar entradas de transcripción en línea. - [@elevenlabs/types@0.6.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.0) - Se ha propagado `event_id` mediante callbacks de transcripción y streaming. ### API ## Nuevas rutas - [Establecer reglas del diccionario de pronunciación](/docs/es/api-reference/pronunciation-dictionaries/rules/set) - `POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules` - Sustituye todas las reglas de un diccionario de pronunciación en una sola llamada - [Subir música](/docs/es/api-reference/music/upload) - `POST /v1/music/upload` - Sube un archivo de audio para crear una canción o hacer referencia a ella y, opcionalmente, extrae un plan de composición - [Actualizar contenido de Audio Native desde una URL](/docs/es/api-reference/audio-native/update-content) - `POST /v1/audio-native/content` - Actualiza un proyecto de AudioNative extrayendo contenido de una URL proporcionada y poniéndolo en cola para su conversión ## Rutas actualizadas ### ElevenAgents - [Listar pruebas de agentes](/docs/es/api-reference/tests/list) - Se ha añadido el parámetro de consulta `parent_folder_id` (cadena, opcional) para filtrar pruebas por carpeta - Se ha añadido el parámetro de consulta `include_folders` (booleano, opcional) para incluir objetos de carpeta en los resultados - Se ha añadido el parámetro de consulta `sort_mode` (cadena, opcional) para controlar el orden de los resultados - La respuesta ahora incluye metadatos de carpeta: tipo de entidad, ruta principal y número de elementos secundarios en `UnitTestSummaryResponseModel` - [Crear prueba de agente](/docs/es/api-reference/tests/create), [Actualizar prueba de agente](/docs/es/api-reference/tests/update) - Se ha añadido el campo `parent_folder_id` (cadena, opcional) para asignar una prueba a una carpeta - [Crear agente](/docs/es/api-reference/agents/create), [Actualizar agente](/docs/es/api-reference/agents/update), [Obtener agente](/docs/es/api-reference/agents/get) - Se ha añadido el campo `summary_language` (cadena, opcional) a la configuración del agente para el idioma del resumen posterior a la conversación - Se ha añadido `widget.dismissible` (booleano) - permite que usuarios plieguen o cierren el widget - Se ha añadido `widget.show_agent_status` (booleano) - muestra el indicador de estado de uso de herramientas en el widget - Se ha añadido `widget.show_conversation_id` (booleano) - muestra el ID de conversación cuando termina la llamada; el valor predeterminado es `true` - Se ha añadido `widget.strip_audio_tags` (booleano) - oculta las etiquetas de audio de las transcripciones; el valor predeterminado es `true` - Se ha añadido `widget.syntax_highlight_theme` (cadena, admite valores nulos) - tema de resaltado de bloques de código (`null`, `light` o `dark`) - Se ha añadido el nuevo tipo de nodo de workflow `say` con el esquema `WorkflowSayNodeModel`, que incluye `conversation_config`, `additional_prompt` y anulaciones de herramientas/base de conocimiento; la carga útil del mensaje admite las variantes discriminadas `literal` y `prompt` - [Llamada saliente de Twilio](/docs/es/api-reference/twilio/outbound-call) - Se ha añadido el campo `call_recording_enabled` (booleano, opcional) para activar la grabación de llamadas salientes de Twilio - [Actualizar cuenta de WhatsApp](/docs/es/api-reference/whats-app/accounts/update) - Se ha añadido el campo `enable_messaging` (booleano, opcional) para activar o desactivar la mensajería de la cuenta - [Actualizar webhook](/docs/es/api-reference/webhooks/update) - Se ha añadido el campo `schema_overrides` (objeto, opcional) para personalizar el esquema de la carga útil del webhook ### Diccionarios de pronunciación - [Añadir reglas al diccionario de pronunciación](/docs/es/api-reference/pronunciation-dictionaries/rules/add), [Eliminar reglas del diccionario de pronunciación](/docs/es/api-reference/pronunciation-dictionaries/rules/remove) - Se ha añadido el campo `case_sensitive` (booleano) a las definiciones de reglas para coincidencias que distinguen entre mayúsculas y minúsculas - Se ha añadido el campo `word_boundaries` (booleano) a las definiciones de reglas para coincidencias que tienen en cuenta los límites de las palabras ### Música - [Generar música](/docs/es/api-reference/music/compose), [Generar música detallada](/docs/es/api-reference/music/compose-detailed), [Transmitir música](/docs/es/api-reference/music/stream) - Se ha añadido el parámetro `use_phonetic_names` (booleano, opcional) para controlar el tratamiento de nombres fonéticos durante la generación - Las respuestas ahora incluyen el campo `song_id` ### Voces - [Listar voces](/docs/es/api-reference/voices/search), [Obtener voz](/docs/es/api-reference/voices/get) - Se ha añadido el campo `is_bookmarked` (booleano) a los objetos de respuesta de voces ## Cambios en los esquemas ### Nuevos esquemas - `WorkflowSayNodeModel` - Nodo de workflow para operaciones `say` de agentes con configuración de conversación, prompts y anulaciones de herramientas - `WorkflowSayNodeMessageLiteral` - Carga útil de mensaje literal (texto estático) para nodos `say` - `WorkflowSayNodeMessagePrompt` - Carga útil de mensaje basada en prompt (generada por LLM) para nodos `say` - `MusicUploadResponse` - Modelo de respuesta para la subida de música que incluye `song_id` - `SMBToolConfigCreateClientParams`, `SMBToolConfigListClientsParams`, `SMBToolConfigSearchClientsParams`, `SMBToolConfigUpdateClientParams`, `SMBToolConfigDeleteClientParams` - Tipos de parámetros discriminados para operaciones de herramientas SMB ### Esquemas modificados - `AgentConfig` - Se ha añadido el campo `summary_language` - `WidgetConfigV2` - Se han añadido los campos `dismissible`, `show_agent_status`, `show_conversation_id`, `strip_audio_tags` y `syntax_highlight_theme` - `SMBToolConfig` - El campo `params` ahora es obligatorio y usa una unión discriminada - `PronunciationDictionaryRule` - Se han añadido los campos `case_sensitive` y `word_boundaries` - `CustomGuardrailConfig` - El campo `model` ahora es opcional y tiene un valor predeterminado - `UnitTestSummaryResponseModel` - Se han añadido campos de metadatos de carpeta: tipo de entidad, ruta principal y número de elementos secundarios