> 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 - **Accodamento delle chiamate e audio di attesa**: Aggiunto l'[accodamento delle chiamate](/docs/it/eleven-agents/guides/call-queueing) per gli agenti al limite di concorrenza. I chiamanti in coda sentono l'audio di attesa e ricevono eventi `queue_status` finché non vengono ammessi o scade il tempo di attesa. Nuovi metodi API consentono di caricare o eliminare audio di attesa personalizzato. - **Metadati delle versioni di test**: I risultati dei test degli agenti ora identificano la versione dell'agente su cui sono stati eseguiti e se includevano modifiche in bozza. I riepiloghi delle invocation indicano inoltre quando i reinvii parziali sono stati eseguiti su versioni diverse. - **Metadati di modelli e account**: La configurazione LLM degli agenti ora accetta `gemini-3.8-flash`. Le risposte degli account WhatsApp identificano se l'account usa la Cloud API o il flusso di registrazione in coesistenza. ### Musica - **Supporto API Music v2.5**: Gli endpoint e gli SDK Music ora accettano `music_v2_5`. I chunk di generazione dei piani di composizione supportano fino a 6.132 caratteri, con un massimo di 30 righe da 200 caratteri ciascuna. ### Rilasci SDK #### SDK JavaScript - [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - Aggiunti metodi per caricare ed eliminare l'audio di attesa degli agenti. Rigenerati i tipi per l'accodamento delle chiamate, i riferimenti alle procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, `gemini-3.8-flash` e `music_v2_5`. #### SDK Python - [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - Aggiunti metodi sincroni e asincroni per caricare ed eliminare l'audio di attesa degli agenti. Rigenerati i tipi per l'accodamento delle chiamate, le procedure, la creazione di rami in bozza, i limiti delle query RAG, i metadati delle versioni di test, `gemini-3.8-flash` e `music_v2_5`. Il wrapper `compose_detailed` ora accetta ogni ID di modello musicale generato e piani di composizione basati sia su prompt sia su chunk. #### SDK iOS - [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - Riconcilia i messaggi degli agenti in base a `response_id` anziché a `event_id`, preservando più risposte attorno alle chiamate degli strumenti ed evitando che parti in streaming o correzioni vengano associate al messaggio sbagliato. #### CLI ElevenLabs - [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - Aggiunti metadati facoltativi `--intent` ai comandi API generati. Aggiunto `elevenlabs feedback missing-capability` per segnalare workflow non supportati dalla CLI. #### Pacchetti - [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) e [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - Corrette le risposte duplicate degli agenti dopo chiamate di strumenti e procedure. Le risposte testuali in streaming mantengono la formattazione Markdown e le conversazioni vocali non visualizzano più parti della chat in streaming non pronunciate. Il pacchetto embed limita inoltre gli eventi `user_activity` a uno al secondo e rimuove il limite al termine di una sessione. ### API ## Nuovi endpoint ### ElevenAgents - [Carica audio di attesa dell'agente](/docs/it/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio` - Accetta `hold_audio_file` obbligatorio (binario) come dati del form multipart. Il file deve essere MP3 o WAV, fino a 40 MB e 180 secondi. - Restituisce `agent_id` obbligatorio (stringa) e `hold_audio` (`AgentHoldAudioConfig`). L'oggetto hold-audio richiede `audio_path`, `audio_url`, `original_filename` (stringhe), `duration_secs` (numero) e `size_bytes` (intero). - [Elimina audio di attesa dell'agente](/docs/it/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio` - Rimuove la clip personalizzata, così i chiamanti in coda sentono il tono di attesa predefinito. - Restituisce `agent_id` obbligatorio (stringa). ## Endpoint aggiornati ### ElevenAgents - [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update) - Aggiunto `platform_settings.queueing_config` (`AgentQueueingConfig`) facoltativo con `enabled` (booleano, predefinito `false`) e `wait_timeout_seconds` (intero, 1–1.800, predefinito `180`). - Le risposte di configurazione della coda includono `hold_audio` (`AgentHoldAudioConfig`) nullable di sola lettura. Le risposte dell'agente includono anche `default_hold_audio_url` facoltativo (stringa). - [Ottieni conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - I metadati aggiungono `queue_wait_secs` facoltativo e nullable (numero). Il tempo in coda è escluso da `call_duration_secs` e dal tempo fatturato. - [Crea ramo dell'agente](/docs/it/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Aggiunto `include_draft` facoltativo (booleano, predefinito `false`). Quando è `true`, un ramo creato dalla punta del ramo include il set di procedure in bozza del chiamante. - [Elenca procedure](/docs/it/api-reference/agents/procedures/list) e gli endpoint per creare, ottenere e gestire le bozze delle procedure - Gli elementi dell'elenco aggiungono `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` e `referenced_dynamic_variables` facoltativi (array di stringhe). - Le risposte dell'agente e di anteprima del merge aggiungono `procedures` facoltativo, una mappa con chiave ID della procedura. - [Elenca invocation di test](/docs/it/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - Aggiunto `search` facoltativo e nullable (stringa) per filtrare test e cartelle per nome. - [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) e [Ottieni invocation di test](/docs/it/api-reference/tests/test-invocations/get) - Le risposte di invocation della suite di test e di esecuzione dei test unitari aggiungono `version_id` facoltativo e nullable (stringa) e `ran_against_draft` facoltativo (booleano, predefinito `false`). - I riepiloghi delle invocation aggiungono anche `runs_diverged_from_version` facoltativo (booleano, predefinito `false`). - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - Il body della richiesta aggiunge gli override specifici della query `max_documents_length` facoltativo e nullable (intero, 1–50.000) e `max_retrieved_rag_chunks_count` (intero, 1–20). - [Ottieni account WhatsApp](/docs/it/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - Aggiunto `account_type` facoltativo (`WhatsAppAccountType`, predefinito `cloud_api`). I valori sono `cloud_api` e `coexistence`. - [Calcola l'utilizzo LLM previsto](/docs/it/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel` aggiunge `price_per_message` obbligatorio (numero). ### Musica - `MusicModelID` aggiunge `music_v2_5` per `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Componi musica](/docs/it/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload` e `POST /v1/music/finetunes`. - `GenerationChunk.text` aumenta `maxLength` da 6.000 a 6.132 caratteri per `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream` e `POST /v1/music/upload`. I nomi delle sezioni possono contenere da 1 a 100 caratteri e i chunk possono contenere fino a 30 righe con 200 caratteri per riga. ## Modifiche allo schema ### ElevenAgents - Gli eventi del server in tempo reale aggiungono `queue_status`. Il relativo `queue_status_event.status` obbligatorio accetta `waiting`, `admitted` o `timed_out`; `timed_out` precede il codice di chiusura WebSocket `4300`. L'audio di attesa continua ad arrivare come normali eventi `audio`. - L'enum `LLM` aggiunge `gemini-3.8-flash`, inclusi gli override per l'avvio della conversazione. - Le union dei risultati degli strumenti di sistema delle conversazioni aggiungono `start_procedure_success`, `start_procedure_error`, `end_procedure_success` e `end_procedure_error`. - `FeaturesUsageCommonModel` aggiunge gli stati delle funzionalità facoltativi `freeform_procedure` e `structured_procedure`.