> 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. ### Interfaccia utente - **Notifiche migliorate**: aggiornato il sistema di notifiche per mostrare quelle pertinenti alla piattaforma attiva che stai visualizzando, offrendo un'esperienza più mirata e contestuale. ### Piattaforma Agents - **Destinazioni di trasferimento con variabili dinamiche**: i trasferimenti degli agenti ora supportano variabili dinamiche per numeri di telefono e URI SIP, consentendo di determinare a runtime le destinazioni di trasferimento in base al contesto della conversazione. - **Override della configurazione degli strumenti MCP**: aggiunta la possibilità di creare, aggiornare, recuperare ed eliminare override di configurazione personalizzati per strumenti specifici dei server MCP, per un controllo granulare sul comportamento e sui parametri degli strumenti. ### Text to Dialogue - **Timestamp e segmenti vocali**: Text to Dialogue ora supporta output con timestamp, allineamento a livello di carattere e tracciamento dei segmenti vocali, semplificando la sincronizzazione dei dialoghi con animazioni o sottotitoli. ### API Music - **Separazione degli stem**: aggiunto un nuovo endpoint per la separazione degli stem, che isola diversi componenti audio (voci, batteria, basso, strumenti) da tracce musicali esistenti. - **Maggiore lunghezza dei prompt**: la generazione musicale ora supporta prompt fino a 4.100 caratteri, con singole righe di testo fino a 200 caratteri. ### Sicurezza - **Token monouso**: introdotta la generazione di token monouso a durata limitata per operazioni sicure, con maggiore sicurezza per le operazioni API sensibili. ### Rilasci SDK #### SDK JavaScript - [v2.22.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.22.0) - Aggiornato con le ultime modifiche allo schema API, incluse le approvazioni dei modelli del workspace e gli endpoint di configurazione degli strumenti MCP. - [v2.21.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.21.0) - Aggiunto il supporto per l'intercettazione dei messaggi WebSocket non elaborati tramite un handler `message` generico, consentendo agli sviluppatori di accedere a tutti i messaggi oltre ai callback standard, inclusi tipi di messaggio non documentati come `agent_tool_response`. #### SDK Python - [v2.22.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.22.0) - Aggiornato con le ultime modifiche allo schema API, incluse le approvazioni dei modelli del workspace e gli endpoint di configurazione degli strumenti MCP. - [v2.21.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.21.0) - Sostituite le istruzioni print con un logging adeguato per supportare meglio il debug e i casi d'uso in produzione. #### Pacchetti Agents - [@elevenlabs/agents-cli@0.6.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/agents-cli%400.6.1) - Pacchetto deprecato a favore della [CLI unificata di ElevenLabs](https://www.npmjs.com/package/@elevenlabs/cli). - [@elevenlabs/react@0.9.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/react%400.9.1) - Corretto un problema per cui lo strumento `end_call` non terminava correttamente le conversazioni e migliorata la logica di riconnessione di React Native dopo una disconnessione manuale. - [@elevenlabs/react-native@0.5.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/react-native%400.5.2) - Corretto un problema per cui lo strumento `end_call` non terminava correttamente le conversazioni e migliorata la logica di riconnessione dopo una disconnessione manuale. - [@elevenlabs/client@0.9.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs/client%400.9.1) - Corretto un problema per cui lo strumento `end_call` non terminava correttamente le conversazioni e migliorata la logica di riconnessione di React Native. #### SDK Android - [v0.4.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.4.0) - Migliorata la sicurezza dei tipi usando gli enum `ConversationMode` anziché stringhe, eseguita la migrazione da LiveData a StateFlow con supporto per la compatibilità con le versioni precedenti e corretto un bug per cui gli agenti non terminavano le chiamate quando richiesto. #### SDK iOS - [v2.0.16](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v2.0.16) - Corretto un problema per cui lo strumento `end_call` non terminava correttamente le conversazioni, garantendo che gli agenti possano terminare le chiamate correttamente. #### CLI - [@elevenlabs/cli@0.2.0](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs/cli%400.2.0) - Rimosso il supporto per il flag `--env` destinato all'isolamento degli ambienti virtuali. Questa funzionalità verrà reintrodotta quando il prodotto supporterà un adeguato isolamento degli ambienti. ### API #### TLS I nostri endpoint TLS non consentono più alcune modalità di cifratura meno recenti e non sicure. La maggior parte dei client non dovrebbe risentirne, poiché negozia già una modalità di cifratura moderna. ## Nuovi endpoint ### Piattaforma Agents #### Configurazione degli strumenti MCP - [POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs](/docs/it/api-reference/mcp/tool-configuration/create) - Crea override di configurazione per uno strumento MCP specifico. - [GET /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/it/api-reference/mcp/tool-configuration/get) - Recupera gli override di configurazione per uno strumento MCP specifico. - [PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/it/api-reference/mcp/tool-configuration/update) - Aggiorna gli override di configurazione per uno strumento MCP specifico. - [DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}](/docs/it/api-reference/mcp/tool-configuration/delete) - Rimuove gli override di configurazione per uno strumento MCP specifico. ### Text to Dialogue - [POST /v1/text-to-dialogue/with-timestamps](/docs/it/api-reference/text-to-dialogue/convert-with-timestamps) - Genera dialoghi con allineamento a livello di carattere e informazioni sui segmenti vocali. - [POST /v1/text-to-dialogue/stream/with-timestamps](/docs/it/api-reference/text-to-dialogue/stream-with-timestamps) - Trasmette in streaming la generazione di dialoghi con allineamento a livello di carattere e informazioni sui segmenti vocali. ### Token - [POST /v1/single-use-token/{token_type}](/docs/it/api-reference/tokens/create) - Genera token monouso a durata limitata per operazioni sicure. ### API Music - [POST /v1/music/stem-separation](/docs/it/api-reference/music/separate-stems) - Separa l'audio in singoli stem (voci, batteria, basso, strumenti). Accetta il caricamento di file multipart e restituisce un archivio ZIP. ## Endpoint aggiornati ### Text to Dialogue - [Text to Dialogue con timestamp](/docs/it/api-reference/text-to-dialogue/convert-with-timestamps) - Aggiunto l'array `voice_segments` con il campo obbligatorio `dialogue_input_index` per tracciare a quale input di dialogo corrisponde ogni segmento - Migliorato lo schema di risposta con dati di allineamento a livello di carattere - [Text to Dialogue in streaming con timestamp](/docs/it/api-reference/text-to-dialogue/stream-with-timestamps) - Aggiunto il supporto streaming per `voice_segments` con allineamento a livello di carattere - Include `dialogue_input_index` nei chunk dei segmenti vocali ### Musica - Endpoint dei prompt musicali aggiornati: - Lunghezza massima del prompt aumentata dal limite precedente a 4.100 caratteri - Le righe di testo ora supportano fino a 200 caratteri per riga ### Workspace - [Ottieni risorsa del workspace](/docs/it/api-reference/workspace/resources/get) - Aggiunti `dashboard` e `dashboard_configuration` all'enum `WorkspaceResourceType` - Modifiche allo schema di risposta (compatibilità non garantita - vedi le note sulla migrazione riportate sotto) ### Fatturazione - [Ottieni abbonamento](/docs/it/api-reference/user/subscription/get) - Aggiunto il campo `next_billing_period` (obbligatorio) a `PendingSubscriptionSwitchResponseModel` - Aggiunti `subtotal_cents` e `tax_cents` (nullable) a `InvoiceResponseModel` per un dettaglio migliore della fattura ### Piattaforma Agents #### Chiamate batch - [Invia chiamate batch](/docs/it/api-reference/batch-calling/create) - Reso `agent_phone_number_id` nullable e facoltativo - Reso `phone_number` nullable e facoltativo nei modelli dei destinatari - Modifiche allo schema di risposta (compatibilità non garantita - vedi le note sulla migrazione riportate sotto) - [Ottieni stato delle chiamate batch](/docs/it/api-reference/batch-calling/get) - Resi `phone_number_id` e `phone_provider` nullable - [Annulla chiamate batch](/docs/it/api-reference/batch-calling/cancel) & [Riprova chiamate batch](/docs/it/api-reference/batch-calling/retry) - Resi nullable i campi relativi al telefono - Modifiche allo schema di risposta (compatibilità non garantita - vedi le note sulla migrazione riportate sotto) #### Destinazioni di trasferimento - Gli endpoint relativi ai trasferimenti ora supportano destinazioni di trasferimento con variabili dinamiche: - Aggiunto il tipo `PhoneNumberDynamicVariableTransferDestination` per i trasferimenti di numeri di telefono tramite variabili dinamiche - Aggiunto il tipo `SIPUriDynamicVariableTransferDestination` per i trasferimenti di URI SIP tramite variabili dinamiche - Aggiornati i discriminatori `PhoneNumberTransfer` per includere i tipi di variabili dinamiche #### Server MCP - [Crea server MCP](/docs/it/api-reference/mcp/create), [Ottieni server MCP](/docs/it/api-reference/mcp/get), [Aggiorna server MCP](/docs/it/api-reference/mcp/update) - Aggiunto il campo `tool_config_overrides` per personalizzare la configurazione per singolo strumento - Aggiunto il supporto per `request_headers` in `MCPServerConfigUpdateRequestModel` - Aggiunte le opzioni di configurazione `tool_call_sound` e `tool_call_sound_behavior` #### Strumenti - Miglioramenti allo schema degli strumenti: - `LiteralJsonSchemaProperty` ora include il flag `is_system_provided` - Gli header degli strumenti dell'agente ora supportano `ConvAIDynamicVariable` per valori header dinamici #### Integrazione Twilio - Endpoint dei numeri di telefono aggiornati: - Aggiunto il campo facoltativo `region_config` per i numeri di telefono Twilio - Aggiunto l'enum `TwilioRegionId` per la selezione della regione - Aggiunto l'enum `TwilioEdgeLocation` per la configurazione della posizione edge #### Agenti - [Ottieni agente](/docs/it/api-reference/agents/get) & [Aggiorna agente](/docs/it/api-reference/agents/update) - Modifiche allo schema di risposta (compatibilità non garantita - vedi le note sulla migrazione riportate sotto)