> 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 - **Colas de llamadas y audio de espera**: Hemos añadido [colas de llamadas](/docs/es/eleven-agents/guides/call-queueing) 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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/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](https://github.com/elevenlabs/cli/releases/tag/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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) y [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.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](/docs/es/api-reference/agents/hold-audio/create) - `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](/docs/es/api-reference/agents/hold-audio/delete) - `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](/docs/es/api-reference/agents/create), [Obtener agente](/docs/es/api-reference/agents/get) y [Actualizar agente](/docs/es/api-reference/agents/update) - 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](/docs/es/api-reference/conversations/get) - `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](/docs/es/api-reference/agents/branches/create) - `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](/docs/es/api-reference/agents/procedures/list) 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](/docs/es/api-reference/tests/test-invocations/list) - `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](/docs/es/api-reference/tests/run-tests) y [Obtener invocación de prueba](/docs/es/api-reference/tests/test-invocations/get) - 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](/docs/es/api-reference/whats-app/accounts/get) - `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](/docs/es/api-reference/agents/calculate) - `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](/docs/es/api-reference/music/compose), `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.