Changelog

March 23, 2026

ElevenAgents

  • API de variables de entorno: Nuevas rutas de API de variables de entorno para gestionar la configuración a nivel de espacio de trabajo a la que los agentes pueden hacer referencia en tiempo de ejecución mediante plantillas {{system_env__<label>}}. Admite tipos de variables de cadena, secretas y de conexión de autenticación, con anulaciones de valores por entorno. Las rutas incluyen crear, listar, obtener y actualizar.

  • Gestión de conexiones de autenticación: Nueva API de conexiones de autenticación a nivel de espacio de trabajo para gestionar las credenciales de autenticación que usan las herramientas e integraciones de los agentes. Admite varios métodos de autenticación, como credenciales de cliente OAuth2, JWT, autenticación básica, tokens bearer, encabezados personalizados y flujos de código de autorización OAuth2 gestionados por integraciones. Las rutas incluyen operaciones de creación, listado y eliminación.

  • Actualización de URL de la base de conocimientos: Nueva ruta de actualización (POST /v1/convai/knowledge-base/{documentation_id}/refresh) para volver a obtener y actualizar el contenido de los documentos de la base de conocimientos procedentes de URL. Los documentos de la base de conocimientos también admiten ahora la configuración de sincronización automática con los campos enable_auto_sync, auto_remove y auto_sync_info.

  • Reintento de guardrail con comentarios: Los guardrails personalizados y de contenido ahora admiten acciones de activación configurables con las opciones EndCallTriggerAction y RetryTriggerAction. Al configurarlo para reintentar, el agente vuelve a generar su respuesta con comentarios del sistema inyectados, hasta un máximo de 3 intentos. Los marcadores disponibles incluyen {{trigger_reason}} y {{agent_message}} para ofrecer indicaciones contextuales durante el reintento.

  • Variable del sistema de historial de conversación: Se ha añadido una nueva variable dinámica system__conversation_history que proporciona un historial de conversación evaluado de forma diferida y serializado en JSON durante la ejecución. Resulta útil para pasar el contexto completo de la conversación a herramientas, webhooks o transferencias a subagentes.

  • Tipo de contenido de herramientas de webhook: Las herramientas de servidor ahora admiten un tipo de contenido configurable para los parámetros del cuerpo de los webhooks, lo que te permite elegir entre los formatos application/json y application/x-www-form-urlencoded. El formato codificado en URL resulta útil para integrarse con sistemas heredados, rutas de tokens OAuth y procesadores de pagos.

  • Mensajes salientes de WhatsApp: Hemos actualizado la integración de WhatsApp con un nuevo cuadro de diálogo de mensajes salientes en el panel, que permite a los agentes enviar mensajes salientes además de realizar llamadas a través del canal de WhatsApp.

  • Filtros para listar agentes y recursos: Las rutas para listar agentes, listar documentos de la base de conocimientos y listar herramientas ahora admiten un parámetro de consulta created_by_user_id (usa @me para el usuario actual). Los parámetros anteriores show_only_owned_agents y show_only_owned_documents están obsoletos.

  • Expresiones condicionales de workflows: Se ha añadido un nuevo nodo AST conditional_operator al esquema de expresiones de workflows, lo que permite lógica de ramificación en las definiciones de workflows de agentes.

Música

  • Music Marketplace: Nueva documentación de Music Marketplace que explica el mercado para licenciar música generada con IA, incluidos los tipos de uso, los pagos a creadores y los detalles de las licencias.

Lanzamientos de SDK

SDK de Python

  • v2.40.0 - Se ha añadido compatibilidad con el parámetro environment para las conversaciones de ElevenAgents, lo que permite conexiones de agentes específicas por entorno. Regeneración de Fern para ajustarse al esquema de API más reciente, incluidas variables de entorno, conexiones de autenticación, actualización de la base de conocimientos y acciones de activación de guardrails.

SDK de JavaScript

  • v2.40.0 - Se ha añadido el tipo de evento WebSocket multimodal_message para las conversaciones en tiempo real de ElevenAgents. Regeneración de Fern para ajustarse al esquema de API más reciente, incluidas variables de entorno, conexiones de autenticación, actualización de la base de conocimientos y acciones de activación de guardrails.

SDK de iOS

  • v3.1.1 - Se ha añadido compatibilidad con el parámetro environment para conexiones de agentes específicas por entorno. Se ha corregido un error de compilación de visionOS al elevar el requisito de plataforma a v2.

Paquetes

Candidato a lanzamiento de paquetes v1.0.0

Ya está disponible el primer candidato a lanzamiento de la versión v1.0.0 de los SDK de cliente de ElevenAgents. Es una versión principal con cambios incompatibles que mejoran la superficie de la API, añaden hooks granulares de React para un mejor rendimiento de renderizado y unifican el SDK de React Native con el SDK de React.

Para probar el candidato a lanzamiento:

npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next

Hay disponible una skill elevenlabs:sdk-migration para ayudar a los asistentes de programación con IA a migrar automáticamente tu base de código a las nuevas API. Añádela a tu proyecto de Claude Code, Cursor o Windsurf para recibir ayuda guiada durante la migración.

Cambios principales en v1.0.0:

  • @elevenlabs/client: Conversation ahora es un objeto de espacio de nombres y un alias de tipo para TextConversation | VoiceConversation, en lugar de una clase. Las clases Input y Output se sustituyen por las interfaces InputController y OutputController, con nuevos métodos prácticos en la instancia de conversación (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() y changeOutputDevice() ahora devuelven void.
  • @elevenlabs/react: useConversation ahora requiere un antecesor ConversationProvider. Nuevos hooks granulares para una renderización detallada: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Nuevo hook useConversationClientTool() para registrar dinámicamente herramientas de cliente desde componentes de React con total seguridad de tipos.
  • @elevenlabs/react-native: Reescritura completa de la API que sustituye ElevenLabsProvider y useConversation por ConversationProvider y los mismos hooks granulares de @elevenlabs/react. Los polyfills de WebRTC y la configuración nativa de AudioSession se aplican automáticamente al importar.

Consulta las notas completas de lanzamiento y las guías de migración:

API

Nuevas rutas

ElevenAgents

  • Crear variable de entorno - POST /v1/convai/environment-variables - Crea una nueva variable de entorno de tipo cadena, secreto o conexión de autenticación
  • Listar variables de entorno - GET /v1/convai/environment-variables - Lista todas las variables de entorno del espacio de trabajo
  • Obtener variable de entorno - GET /v1/convai/environment-variables/{env_var_id} - Obtiene una variable de entorno específica
  • Actualizar variable de entorno - PATCH /v1/convai/environment-variables/{env_var_id} - Actualiza una variable de entorno, incluida la eliminación de valores por entorno mediante null
  • Actualizar contenido de documento URL - POST /v1/convai/knowledge-base/{documentation_id}/refresh - Vuelve a obtener contenido para documentos de la base de conocimientos procedentes de URL

Espacios de trabajo

  • POST /v1/workspace/auth-connections - Crea una conexión de autenticación del espacio de trabajo con compatibilidad con métodos de autenticación OAuth2, JWT, básica, bearer, encabezado personalizado y gestionados por integraciones
  • GET /v1/workspace/auth-connections - Lista todas las conexiones de autenticación del espacio de trabajo con información de dependencias (herramientas, servidores MCP y conexiones de integración)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Elimina una conexión de autenticación del espacio de trabajo

Voz a Texto

  • GET /v1/speech-to-text/evaluation/eval-criteria - Lista criterios de evaluación
  • POST /v1/speech-to-text/evaluation/eval-criteria - Crea un criterio de evaluación
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Obtiene un criterio de evaluación específico
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Actualiza un criterio de evaluación
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Elimina un criterio de evaluación
  • POST /v1/speech-to-text/evaluation/evaluations - Activa una evaluación
  • GET /v1/speech-to-text/evaluation/evaluations - Lista evaluaciones
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Obtiene una evaluación específica
  • GET /v1/speech-to-text/evaluation/human-agents - Lista agentes humanos
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Obtiene un agente humano
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Elimina un agente humano
  • GET /v1/speech-to-text/evaluation/analytics - Obtiene analíticas de evaluación
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Obtiene analíticas de un criterio específico
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Obtiene analíticas de un agente humano específico

Rutas actualizadas

ElevenAgents

  • Obtener URL firmada, Obtener token de conversación

    • Se ha añadido el parámetro de consulta environment (cadena, opcional) para la resolución específica por entorno

  • Listar agentes

    • Se ha añadido el parámetro de consulta created_by_user_id (cadena, opcional, admite @me)
    • show_only_owned_agents está obsoleto en favor de created_by_user_id

  • Listar documentos de la base de conocimientos

    • Se ha añadido el parámetro de consulta created_by_user_id (cadena, opcional, admite @me)
    • show_only_owned_documents está obsoleto en favor de created_by_user_id

  • Listar herramientas

    • Se ha añadido el parámetro de consulta created_by_user_id (cadena, opcional, admite @me)
    • show_only_owned_documents está obsoleto en favor de created_by_user_id

  • Obtener fragmento de la base de conocimientos

    • Se ha añadido el parámetro de consulta embedding_model (cadena, opcional) para especificar el modelo de embeddings para recuperar fragmentos

  • Crear agente, Actualizar agente, Crear borrador

    • Se ha añadido compatibilidad con guardrail_trigger_action mediante los esquemas EndCallTriggerAction y RetryTriggerAction
    • Se ha añadido el nodo AST conditional_operator a las definiciones de expresiones de workflows
    • Los esquemas de agentes ahora admiten ConvAIEnvVarLocator y EnvironmentAuthConnectionLocator para hacer referencia a variables de entorno en configuraciones de herramientas

  • Llamada saliente de troncal SIP

    • Se ha actualizado el esquema de solicitud para incluir nuevos campos relacionados con el entorno

  • Simular conversación, Simular flujo de conversación

    • Se ha añadido el campo simulation_environment al esquema de solicitud

Cambios de esquema

Nuevos esquemas

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modelos de variables de entorno compatibles con tipos de cadena, secreto y conexión de autenticación
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Localizadores para hacer referencia a variables de entorno en configuraciones de herramientas y servidores MCP
  • EndCallTriggerAction, RetryTriggerAction - Esquemas de acciones de activación de guardrails para los comportamientos de finalizar llamada y reintentar con comentarios
  • ConditionalOperator - Nuevo nodo AST para expresiones condicionales en workflows de agentes
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Esquemas de gestión de conexiones de autenticación de espacios de trabajo compatibles con métodos de autenticación OAuth2, JWT, básica, bearer, encabezado personalizado, WhatsApp y gestionados por integraciones
  • SpeechToTextEvaluation* - Conjunto de esquemas para criterios de evaluación de voz a texto, evaluaciones, agentes humanos y analíticas

Esquemas modificados

  • MCPServerConfig, MCPServerConfigOutput - Se ha añadido compatibilidad con referencias ConvAIEnvVarLocator en la configuración del servidor
  • CustomGuardrailConfig - Se ha añadido el campo trigger_action para configurar el comportamiento de finalizar llamada o reintentar
  • Contributor - Se han añadido los campos opcionales bio (cadena) y profile_id (cadena)
  • ASTLLMNode - Se ha añadido el campo value_schema; el campo prompt está obsoleto en favor de value_schema
  • TelephonyDirection - Se ha refactorizado como una enumeración compartida a la que hacen referencia varios modelos de conversación y telefonía