> 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 - **Mise en file d'attente des appels et audio d'attente** : ajout de la [mise en file d'attente des appels](/docs/fr/eleven-agents/guides/call-queueing) pour les agents ayant atteint leur limite de requêtes simultanées. Les appelants en attente entendent un audio d'attente et reçoivent des événements `queue_status` jusqu'à leur admission ou l'expiration du délai. De nouvelles méthodes API permettent d'importer ou de supprimer un audio d'attente personnalisé. - **Métadonnées des versions de test** : les résultats des tests d'agent identifient désormais la version de l'agent sur laquelle ils ont été exécutés et indiquent s'ils incluaient des modifications de brouillon. Les récapitulatifs d'invocation signalent également lorsque des soumissions partielles ont été exécutées sur différentes versions. - **Métadonnées de modèle et de compte** : la configuration LLM de l'agent accepte désormais `gemini-3.8-flash`. Les réponses des comptes WhatsApp indiquent si le compte utilise l'API Cloud ou le processus d'inscription en coexistence. ### Musique - **Prise en charge de l'API Music v2.5** : les points de terminaison Music et les SDK acceptent désormais `music_v2_5`. Les segments de génération de plans de composition prennent en charge jusqu'à 6 132 caractères, avec jusqu'à 30 lignes de 200 caractères chacune. ### Versions des SDK #### SDK JavaScript - [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - Ajout de méthodes pour importer et supprimer l'audio d'attente d'un agent. Types régénérés pour la mise en file d'attente des appels, les références de procédures, la création de branches de brouillon, les limites de requêtes RAG, les métadonnées de versions de test, `gemini-3.8-flash` et `music_v2_5`. #### SDK Python - [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - Ajout de méthodes synchrones et asynchrones pour importer et supprimer l'audio d'attente d'un agent. Types régénérés pour la mise en file d'attente des appels, les procédures, la création de branches de brouillon, les limites de requêtes RAG, les métadonnées de versions de test, `gemini-3.8-flash` et `music_v2_5`. Le wrapper `compose_detailed` accepte désormais chaque ID de modèle de musique généré ainsi que les plans de composition basés sur des prompts et sur des segments. #### SDK iOS - [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - Rapproche les messages de l'agent par `response_id` plutôt que par `event_id`, en préservant plusieurs réponses autour des appels d'outils et en évitant que des parties diffusées en streaming ou des corrections soient associées au mauvais message. #### CLI ElevenLabs - [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - Ajout de métadonnées facultatives `--intent` aux commandes API générées. Ajout de `elevenlabs feedback missing-capability` pour signaler les workflows que la CLI ne prend pas en charge. #### Packages - [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) et [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - Correction des réponses d'agent en double après les appels d'outils et de procédures. Les réponses textuelles diffusées en streaming conservent leur mise en forme Markdown, et les conversations vocales n'affichent plus les parties de chat diffusées mais non prononcées. Le package embed limite également les événements `user_activity` à un par seconde et supprime cette limite à la fin d'une session. ### API ## Nouveaux points de terminaison ### ElevenAgents - [Importer l'audio d'attente d'un agent](/docs/fr/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio` - Accepte le champ obligatoire `hold_audio_file` (binaire) sous forme de données de formulaire multipartites. Le fichier doit être au format MP3 ou WAV, ne pas dépasser 40 Mo ni 180 secondes. - Renvoie les champs obligatoires `agent_id` (chaîne) et `hold_audio` (`AgentHoldAudioConfig`). L'objet d'audio d'attente requiert `audio_path`, `audio_url`, `original_filename` (chaînes), `duration_secs` (nombre) et `size_bytes` (entier). - [Supprimer l'audio d'attente d'un agent](/docs/fr/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio` - Supprime le clip personnalisé afin que les appelants en attente entendent la tonalité d'attente par défaut. - Renvoie le champ obligatoire `agent_id` (chaîne). ## Points de terminaison mis à jour ### ElevenAgents - [Créer un agent](/docs/fr/api-reference/agents/create), [Obtenir un agent](/docs/fr/api-reference/agents/get) et [Mettre à jour un agent](/docs/fr/api-reference/agents/update) - Ajout de `platform_settings.queueing_config` (`AgentQueueingConfig`) facultatif, avec `enabled` (booléen, valeur par défaut `false`) et `wait_timeout_seconds` (entier, 1–1 800, valeur par défaut `180`). - Les réponses de configuration de file d'attente incluent `hold_audio` (`AgentHoldAudioConfig`) en lecture seule et pouvant être nul. Les réponses d'agent incluent également `default_hold_audio_url` (chaîne) facultatif. - [Obtenir une conversation](/docs/fr/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - Les métadonnées ajoutent `queue_wait_secs` (nombre) facultatif et pouvant être nul. Le temps d'attente dans la file est exclu de `call_duration_secs` et du temps facturé. - [Créer une branche d'agent](/docs/fr/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Ajout de `include_draft` (booléen, valeur par défaut `false`) facultatif. Lorsqu'il est défini sur `true`, une branche créée à partir de l'extrémité de la branche inclut l'ensemble des procédures de brouillon de l'appelant. - [Lister les procédures](/docs/fr/api-reference/agents/procedures/list) et les points de terminaison de création, d'obtention et de brouillon des procédures - Les éléments de liste ajoutent `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` et `referenced_dynamic_variables` (tableaux de chaînes) facultatifs. - Les réponses d'agent et d'aperçu de fusion ajoutent `procedures` facultatif, une map indexée par ID de procédure. - [Lister les invocations de test](/docs/fr/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - Ajout de `search` (chaîne) facultatif et pouvant être nul pour filtrer les tests et les dossiers par nom. - [Exécuter des tests sur un agent](/docs/fr/api-reference/tests/run-tests) et [Obtenir une invocation de test](/docs/fr/api-reference/tests/test-invocations/get) - Les réponses d'invocation de suite de tests et d'exécution de test unitaire ajoutent `version_id` (chaîne) facultatif et pouvant être nul, ainsi que `ran_against_draft` (booléen, valeur par défaut `false`) facultatif. - Les récapitulatifs d'invocation ajoutent également `runs_diverged_from_version` (booléen, valeur par défaut `false`) facultatif. - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - Le corps de la requête ajoute les remplacements spécifiques à la requête `max_documents_length` (entier, 1–50 000) et `max_retrieved_rag_chunks_count` (entier, 1–20), facultatifs et pouvant être nuls. - [Obtenir un compte WhatsApp](/docs/fr/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - Ajout de `account_type` (`WhatsAppAccountType`, valeur par défaut `cloud_api`) facultatif. Les valeurs sont `cloud_api` et `coexistence`. - [Calculer l'utilisation LLM attendue](/docs/fr/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel` ajoute `price_per_message` (nombre) obligatoire. ### Musique - `MusicModelID` ajoute `music_v2_5` pour `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Composer de la musique](/docs/fr/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload` et `POST /v1/music/finetunes`. - `GenerationChunk.text` augmente `maxLength` de 6 000 à 6 132 caractères pour `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream` et `POST /v1/music/upload`. Les noms de sections peuvent contenir 1 à 100 caractères, et les segments peuvent contenir jusqu'à 30 lignes de 200 caractères chacune. ## Modifications du schéma ### ElevenAgents - Les événements serveur en temps réel ajoutent `queue_status`. Son champ obligatoire `queue_status_event.status` accepte `waiting`, `admitted` ou `timed_out` ; `timed_out` précède le code de fermeture WebSocket `4300`. L'audio d'attente continue d'arriver sous forme d'événements `audio` classiques. - L'énumération `LLM` ajoute `gemini-3.8-flash`, y compris pour les remplacements d'initialisation de conversation. - Les unions de résultats des outils système de conversation ajoutent `start_procedure_success`, `start_procedure_error`, `end_procedure_success` et `end_procedure_error`. - `FeaturesUsageCommonModel` ajoute les statuts de fonctionnalité facultatifs `freeform_procedure` et `structured_procedure`.