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 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 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 (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 (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, Generate music detailed y Stream music.

  • 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 (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 - 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 - 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 - 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 - 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 - Se ha propagado event_id mediante callbacks de transcripción y streaming.

API

Nuevas rutas

  • Establecer reglas del diccionario de pronunciación - 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 - 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 - 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

    • 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, Actualizar prueba de agente

    • Se ha añadido el campo parent_folder_id (cadena, opcional) para asignar una prueba a una carpeta
  • Crear agente, Actualizar agente, Obtener agente

    • 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

    • 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

    • Se ha añadido el campo enable_messaging (booleano, opcional) para activar o desactivar la mensajería de la cuenta
  • Actualizar webhook

    • Se ha añadido el campo schema_overrides (objeto, opcional) para personalizar el esquema de la carga útil del webhook

Diccionarios de pronunciación

Música

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