> 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. ### Risorse per sviluppatori - **Canale YouTube ElevenLabs Devs**: È ora disponibile un nuovo [canale YouTube](https://www.youtube.com/@elevenlabsdevs) dedicato agli sviluppatori, con tutorial, guide alle API e approfondimenti tecnici per aiutarti a sfruttare al meglio la piattaforma ElevenLabs. ### ElevenAgents - **Override del nodo iniziale del workflow**: Ora puoi avviare le conversazioni da un nodo specifico del workflow passando `starting_workflow_node_id` nei [dati client per l'avvio della conversazione](/docs/it/api-reference/agents/create). Questa funzionalità è controllata da un campo di opt-in `enable_starting_workflow_node_id_from_client` nelle impostazioni di override della piattaforma dell'agente. Quando è abilitata, i client possono specificare da quale nodo iniziare una conversazione, utile per la memoria dell'agente e per casi d'uso WebSocket a più lungo termine. Se il nodo specificato non esiste, la conversazione torna al punto di ingresso predefinito. - **Configurazione LLM per l'analisi post-chiamata**: Le impostazioni della piattaforma dell'agente ora includono un campo `analysis_llm` (predefinito: `gemini-2.5-flash`) che imposta l'LLM predefinito per l'analisi post-chiamata, inclusi i criteri di valutazione e la raccolta dati. Le singole proprietà della raccolta dati possono sovrascrivere questo valore predefinito con un campo `llm` per elemento tramite il nuovo schema `AnalysisProperty`, offrendo un controllo granulare sul modello che elabora ciascun elemento di analisi. - **Nuove opzioni LLM**: Aggiunto `gpt-5.4` all'elenco dei provider LLM disponibili per la configurazione dell'agente. Aggiunto `xhigh` all'enum `LLMReasoningEffort` per il ragionamento esteso sui modelli supportati. - **Valore letterale null nelle espressioni del workflow**: Le espressioni condizionali del workflow ora supportano confronti con null tramite il nuovo tipo `ASTNullNode`, consentendo branch come "if variable is null" nella logica del workflow. - **Ottieni segreto per ID**: Un nuovo endpoint [ottieni segreto](/docs/it/api-reference/workspace/secrets/get) (`GET /v1/convai/secrets/{secret_id}`) recupera un singolo segreto del workspace tramite il suo ID. L'endpoint [elenca segreti](/docs/it/api-reference/workspace/secrets/list) ora accetta anche un parametro query `search` per filtrare i segreti in base al prefisso del nome. - **Numeri di telefono ricercabili nelle chiamate batch**: Il modulo delle chiamate batch nella dashboard ora include un selettore di numeri di telefono ricercabile, rendendo più semplice trovare il numero in uscita corretto durante la configurazione delle chiamate batch. ### Speech to Text - **Rilevamento dei ruoli dei partecipanti**: L'endpoint [converti voce in testo](/docs/it/api-reference/speech-to-text/convert) ora accetta un parametro `detect_speaker_roles` (booleano, predefinito `false`). Se abilitato insieme a `diarize=true`, le etichette dei partecipanti vengono restituite come `agent` e `customer` anziché `speaker_0`, `speaker_1`. Non può essere usato con `use_multi_channel=true`. L'utilizzo comporta un supplemento del 10% sul costo base della trascrizione. ### Text to Dialogue - **Indicazioni sul limite di caratteri in input**: Gli endpoint [text to dialogue](/docs/it/api-reference/text-to-dialogue/convert) ora documentano un limite consigliato di 2.000 caratteri complessivi per tutti i valori `inputs[].text` per richiesta. Le richieste più lunghe potrebbero terminare in anticipo nelle risposte in streaming o restituire un errore di validazione. ### Workspace - **Endpoint di analisi dell'utilizzo**: Un nuovo endpoint [utilizzo per prodotto nel tempo](/docs/it/api-reference/workspace/usage/get-usage-by-product-over-time) (`POST /v1/workspace/analytics/query/usage-by-product-over-time`) restituisce l'utilizzo dei crediti suddiviso per tipo di prodotto nel tempo. I risultati vengono restituiti in una struttura tabellare con `interval_seconds`, dimensioni `group_by` e `filters` configurabili. Il precedente endpoint `GET /v1/usage/character-stats` è stato deprecato a favore di questo nuovo endpoint. ### Rilasci SDK #### Pacchetti - [@elevenlabs/client@1.2.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.2.1) - Risolta la disponibilità all'avvio della conversazione, in modo che `onConnect` venga eseguito dopo che la sessione è contrassegnata come connessa e React ha sincronizzato `conversationRef`. Esposto e inoltrato anche `onConversationCreated` per i consumer che necessitano dell'istanza `Conversation` creata prima di `onConnect`. - [@elevenlabs/react@1.1.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.1.1) - Risolta la disponibilità all'avvio della conversazione ed esposto il callback `onConversationCreated`, in linea con le modifiche di `@elevenlabs/client@1.2.1`. - [@elevenlabs/react-native@1.1.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.1), [@elevenlabs/convai-widget-core@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.4), [@elevenlabs/convai-widget-embed@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.4) - Aggiornati a `@elevenlabs/client@1.2.1` con le correzioni per l'avvio della conversazione. ### API ## Nuovi endpoint - [Ottieni segreto](/docs/it/api-reference/workspace/secrets/get) - `GET /v1/convai/secrets/{secret_id}` - `POST /v1/workspace/analytics/query/usage-by-product-over-time` - Ottieni l'utilizzo dei crediti del workspace per prodotto nel tempo ## Endpoint deprecati - `GET /v1/usage/character-stats` - Deprecato a favore di `POST /v1/workspace/analytics/query/usage-by-product-over-time` - Tutti gli endpoint per la modifica delle risorse di doppiaggio (`POST /v1/dubbing/resource/{dubbing_id}/language`, `POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment`, `PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}` e altri) sono ora deprecati ## Endpoint aggiornati ### ElevenAgents - [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get), [Aggiorna agente](/docs/it/api-reference/agents/update) - Aggiunto il campo `analysis_llm` (enum LLM, predefinito: `gemini-2.5-flash`) a `AgentPlatformSettings` per configurare il modello predefinito di analisi post-chiamata - Le proprietà della raccolta dati ora usano lo schema `AnalysisProperty` con un campo di override `llm` facoltativo per elemento - [Simula conversazione](/docs/it/api-reference/agents/simulate-conversation) - Aggiunto il campo `starting_workflow_node_id` (stringa, nullable) ai dati client per l'avvio della conversazione - Aggiunto il campo `enable_starting_workflow_node_id_from_client` (booleano, predefinito `false`) a `ConversationInitiationClientDataConfig` - [Invia chiamate batch](/docs/it/api-reference/batch-calling/create) - Aggiunto il campo `external_link` (stringa, nullable) ai record delle chiamate batch - [Elenca segreti](/docs/it/api-reference/workspace/secrets/list) - Aggiunto il parametro query facoltativo `search` (stringa) per filtrare i segreti in base al prefisso del nome - Enum `LLM` - Aggiunti `gpt-5.4`, `gpt-5.4-2026-03-05` - Enum `LLMReasoningEffort` - Aggiunto `xhigh` - Espressioni del workflow (`ASTNode`) - Aggiunti il valore discriminatore `null_literal` e lo schema `ASTNullNode` per i confronti con null - Parametri array dei tool (`ArrayJsonSchemaProperty`) - Aggiunto il campo `dynamic_variable` (stringa, facoltativo) per popolare gli array da variabili dinamiche al runtime - Aggiunto il campo `constant_value` (array, nullable) per impostare valori costanti degli array - Il campo `items` non è più obbligatorio (ha uno schema predefinito) - Override della configurazione dei tool MCP - La risposta ora usa lo schema `MCPToolConfigOverride-Output` (separazione input/output) ### Speech to Text - [Converti voce in testo](/docs/it/api-reference/speech-to-text/convert) - Aggiunto il campo `detect_speaker_roles` (booleano, predefinito `false`) per il rilevamento dei ruoli agente/cliente dei partecipanti ### Text to Dialogue - [Converti testo in dialogo](/docs/it/api-reference/text-to-dialogue/convert), [Trasmetti testo in dialogo](/docs/it/api-reference/text-to-dialogue/stream) - Aggiornata la descrizione di `inputs` con la raccomandazione di 2.000 caratteri per richiesta - Rimosso il campo `avatar_context` dal body della richiesta ### Text to Speech - I campi dei preset di qualità negli endpoint TTS e dialogo ora fanno riferimento allo schema enum `QualityPresetType`. Il valore `highest` è stato rimosso dai preset di qualità del dialogo; usa invece `ultra`. ### Altro - `AudioNativeResponse` - Rimosso il campo `transcription` dalla risposta - `UserResponseModel` - Aggiornamento dello schema retrocompatibile