Changelog

ElevenAgents

• Evento WebSocket agent_response_complete: Un nuevo evento de cliente agent_response_complete 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 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 (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 (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 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, el SDK de Python y el SDK de cliente para navegador/Node @elevenlabs/client.

Lanzamientos de SDK

SDK de Python

• 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 - 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 - 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).
• 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 - 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 - 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 - Se ha añadido compatibilidad con la ruta subir archivo de conversación, que permite a los clientes adjuntar archivos a una conversación en curso directamente desde el SDK de cliente.
• @elevenlabs/react@1.2.1, @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, @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, @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, @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