ElevenAgents

  • Colas de llamadas y audio de espera: Hemos añadido colas de llamadas para agentes que han alcanzado su límite de concurrencia. Las personas en espera oyen audio de espera y reciben eventos queue_status hasta que se les admite o se agota el tiempo de espera. Los nuevos métodos de la API permiten subir o eliminar audio de espera personalizado.
  • Metadatos de versiones de prueba: Los resultados de las pruebas de agentes ahora identifican la versión del agente con la que se ejecutaron e indican si incluían cambios de borrador. Los resúmenes de invocación también indican cuándo los reenvíos parciales se ejecutaron con versiones diferentes.
  • Metadatos de modelos y cuentas: La configuración de LLM de agentes ahora acepta gemini-3.8-flash. Las respuestas de cuentas de WhatsApp identifican si la cuenta usa la API de Cloud o el flujo de registro de coexistencia.

Música

  • Compatibilidad con la API de Música v2.5: Las rutas de Música y los SDK ahora aceptan music_v2_5. Los fragmentos de generación de planes de composición admiten hasta 6.132 caracteres, con hasta 30 líneas de 200 caracteres cada una.

Lanzamientos de SDK

SDK de JavaScript

  • v2.68.0 - Se han añadido métodos para subir y eliminar audio de espera de agentes. Se han regenerado los tipos para colas de llamadas, referencias a procedimientos, creación de ramas de borrador, límites de consultas RAG, metadatos de versiones de prueba, gemini-3.8-flash y music_v2_5.

SDK de Python

  • v2.68.0 - Se han añadido métodos síncronos y asíncronos para subir y eliminar audio de espera de agentes. Se han regenerado los tipos para colas de llamadas, procedimientos, creación de ramas de borrador, límites de consultas RAG, metadatos de versiones de prueba, gemini-3.8-flash y music_v2_5. El wrapper compose_detailed ahora acepta todos los ID de modelos de música generados y planes de composición basados tanto en prompts como en fragmentos.

SDK de iOS

  • v3.3.1 - Concilia los mensajes de agentes mediante response_id en lugar de event_id, preservando varias respuestas alrededor de llamadas a herramientas y evitando que las partes transmitidas o las correcciones se adjunten al mensaje incorrecto.

CLI de ElevenLabs

  • v1.3.0 - Se han añadido metadatos opcionales --intent a los comandos de API generados. Se ha añadido elevenlabs feedback missing-capability para informar de flujos de trabajo que la CLI no admite.

Paquetes

  • @elevenlabs/convai-widget-core@0.18.2 y @elevenlabs/convai-widget-embed@0.18.2 - Se han corregido respuestas duplicadas de agentes después de llamadas a herramientas y procedimientos. Las respuestas de texto transmitidas conservan el formato Markdown y las conversaciones de voz ya no muestran partes de chat transmitidas que no se han pronunciado. El paquete embed también limita los eventos user_activity a uno por segundo y elimina el límite cuando termina una sesión.

API

Nuevas rutas

ElevenAgents

  • Subir audio de espera de un agente - POST /v1/convai/agents/{agent_id}/hold-audio
    • Acepta el campo obligatorio hold_audio_file (binario) como datos de formulario multipartes. El archivo debe ser MP3 o WAV, de hasta 40 MB y 180 segundos.
    • Devuelve agent_id obligatorio (cadena) y hold_audio (AgentHoldAudioConfig). El objeto de audio de espera requiere audio_path, audio_url, original_filename (cadenas), duration_secs (número) y size_bytes (entero).
  • Eliminar audio de espera de un agente - DELETE /v1/convai/agents/{agent_id}/hold-audio
    • Elimina el clip personalizado para que las personas en espera oigan el tono de espera predeterminado.
    • Devuelve agent_id obligatorio (cadena).

Rutas actualizadas

ElevenAgents

  • Crear agente, Obtener agente y Actualizar agente
    • Se ha añadido platform_settings.queueing_config opcional (AgentQueueingConfig) con enabled (booleano, valor predeterminado false) y wait_timeout_seconds (entero, 1–1.800, valor predeterminado 180).
    • Las respuestas de configuración de colas incluyen hold_audio de solo lectura y anulable (AgentHoldAudioConfig). Las respuestas de agentes también incluyen default_hold_audio_url opcional (cadena).
  • Obtener conversación - GET /v1/convai/conversations/{conversation_id}
    • Los metadatos añaden queue_wait_secs opcional y anulable (número). El tiempo en cola se excluye de call_duration_secs y del tiempo facturado.
  • Crear rama de agente - POST /v1/convai/agents/{agent_id}/branches
    • Se ha añadido include_draft opcional (booleano, valor predeterminado false). Cuando es true, una rama creada desde la punta de la rama incluye el conjunto de procedimientos de borrador de quien realiza la llamada.
  • Listar procedimientos y rutas de creación, obtención y borrador de procedimientos
    • Los elementos de la lista añaden referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids y referenced_dynamic_variables opcionales (matrices de cadenas).
    • Las respuestas de agente y de vista previa de fusión añaden procedures opcional, un mapa con claves por ID de procedimiento.
  • Listar invocaciones de prueba - GET /v1/convai/test-invocations
    • Se ha añadido search opcional y anulable (cadena) para filtrar pruebas y carpetas por nombre.
  • Ejecutar pruebas en un agente y Obtener invocación de prueba
    • Las respuestas de invocación de suites de pruebas y de ejecución de pruebas unitarias añaden version_id opcional y anulable (cadena), y ran_against_draft opcional (booleano, valor predeterminado false).
    • Los resúmenes de invocación también añaden runs_diverged_from_version opcional (booleano, valor predeterminado false).
  • POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
    • El cuerpo de la solicitud añade las anulaciones específicas de consulta max_documents_length opcional y anulable (entero, 1–50.000) y max_retrieved_rag_chunks_count opcional y anulable (entero, 1–20).
  • Obtener cuenta de WhatsApp - GET /v1/convai/whatsapp-accounts/{phone_number_id}
    • Se ha añadido account_type opcional (WhatsAppAccountType, valor predeterminado cloud_api). Los valores son cloud_api y coexistence.
  • Calcular uso previsto de LLM - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
    • LLMUsageCalculatorLLMResponseModel añade price_per_message obligatorio (número).

Música

  • MusicModelID añade music_v2_5 para POST /v1/music/video-to-music, POST /v1/music/plan, Componer música, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload y POST /v1/music/finetunes.
  • GenerationChunk.text aumenta maxLength de 6.000 a 6.132 caracteres para POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream y POST /v1/music/upload. Los nombres de sección pueden contener entre 1 y 100 caracteres, y los fragmentos pueden contener hasta 30 líneas de 200 caracteres por línea.

Cambios en esquemas

ElevenAgents

  • Los eventos del servidor en tiempo real añaden queue_status. Su queue_status_event.status obligatorio acepta waiting, admitted o timed_out; timed_out precede al código de cierre de WebSocket 4300. El audio de espera sigue llegando como eventos audio normales.
  • La enumeración LLM añade gemini-3.8-flash, incluidas las anulaciones de inicio de conversación.
  • Las uniones de resultados de herramientas del sistema de conversación añaden start_procedure_success, start_procedure_error, end_procedure_success y end_procedure_error.
  • FeaturesUsageCommonModel añade estados de funcionalidades freeform_procedure y structured_procedure opcionales.