> 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 - **Evento WebSocket `agent_response_complete`**: Un nuovo [evento client `agent_response_complete`](/docs/it/eleven-agents/customization/events/client-events) viene attivato esattamente una volta quando la risposta di un agente è stata inviata completamente -- dopo il completamento della generazione LLM, delle catene di chiamate agli strumenti e della riproduzione audio. Dopo questo evento, l'agente produrrà altro output solo se l'utente fornisce un nuovo input o se un timeout del turno attiva un nuovo turno. L'evento consente ai client di rilevare in modo affidabile la fine del turno per raggruppare i messaggi, attivare la wake word o aggiornare l'interfaccia dopo il turno. Aggiunto un nuovo valore `AGENT_RESPONSE_COMPLETE` all'enum `ClientEvent` e un modello di risposta `AgentResponseCompleteClientEvent` corrispondente. - **Modalità di parlato prima dello strumento**: Aggiunto un nuovo campo `pre_tool_speech` (enum `PreToolSpeechMode`, valore predefinito `auto`) nella configurazione del server MCP e nelle sostituzioni per singolo strumento. Sostituisce il booleano `force_pre_tool_speech`, ora deprecato. Valori: `auto` decide se l'agente parla prima della chiamata allo strumento in base alla recente latenza degli strumenti, `force` chiede sempre all'agente di parlare e `off` disattiva completamente questa funzionalità. - **L'invio agli strumenti rispetta la modalità di esecuzione**: I nodi di invio degli strumenti del workflow ora rispettano correttamente il valore `execution_mode` di ogni strumento nidificato. Se uno strumento in un nodo di invio usa `POST_TOOL_SPEECH`, il workflow attende che l'audio del turno corrente sia completamente esposto prima di eseguire l'invio. - **Timeout delle risposte MCP**: Aggiunto un campo `response_timeout_secs` (intero, valore predefinito `30`, minimo `5`, massimo `120`) nella configurazione del server MCP e nelle sostituzioni per singolo strumento, che controlla il tempo massimo di attesa per il completamento di ogni chiamata allo strumento MCP. - **Contesto di attendibilità dell'agente**: Aggiunto un campo `trust_context` nelle impostazioni della piattaforma dell'agente (enum `AgentTrustContext`: `unknown` | `low` | `high`, valore predefinito `unknown`). `low` è destinato agli agenti al servizio di partecipanti esterni non attendibili, i cui output devono essere verificati e l'accesso agli strumenti limitato; `high` è destinato agli agenti al servizio del proprietario, per cui è appropriato l'accesso completo agli strumenti; `unknown` include gli agenti creati prima di questa funzionalità. - **Interruttore per l'attribuzione delle fonti**: Aggiunto un booleano `source_attribution` (valore predefinito `false`) nella configurazione della conversazione. Quando è abilitato e sono presenti contenuti della knowledge base, all'LLM viene chiesto di indicare quali fonti ha utilizzato. - **Filtro della modalità di condivisione dei test**: L'endpoint [elenca test](/docs/it/api-reference/tests/list) ora accetta un parametro query `sharing_mode` (`all` | `shared_with_me`, valore predefinito `all`) per filtrare test e cartelle mostrando solo quelli condivisi con l'utente corrente che non ha creato. - **Icone degli strumenti e metadati di esecuzione**: Aggiunti i campi `icons` (array di `Icon`) ed `execution` (`ToolExecution`) allo schema `Tool`. `Icon` include `src`, `mimeType` e `sizes` per la visualizzazione nell'interfaccia utente, mentre `ToolExecution.taskSupport` (`forbidden` | `optional` | `required`) dichiara come lo strumento partecipa alle attività. - **Valore predefinito del compilatore di procedure**: Il valore predefinito di `ProcedureCompilerMode` è cambiato da `deterministic` a `append`, mentre il valore `llm` è stato rimosso. Gli agenti esistenti che impostano esplicitamente `deterministic` non subiscono modifiche. - **Metadati di attribuzione per RAG e knowledge base**: Aggiunto `used_static_kb_document_ids` (array di stringhe) in `ConversationHistoryTranscriptCommonModel` e `ConversationHistoryTranscriptResponseModel`, e `used_chunk_ids` in `RagRetrievalInfo`, per mostrare esattamente quali documenti della knowledge base e chunk RAG hanno contribuito a ogni turno della trascrizione. - **Refactoring delle variabili dinamiche**: `dynamic_variables` e `dynamic_variable_placeholders` ora fanno riferimento agli schemi unificati `DynamicVariableValueType-Input` / `DynamicVariableValueType-Output` (in sostituzione dei precedenti schemi `DynamicVariableContainerValueType-*`), con un supporto più ampio per valori nidificati e in elenco. `DynamicVariableAssignment` ha acquisito un campo `preserve_native_type` per conservare i valori tipizzati anziché convertirli in stringhe. ### Isolamento audio - **Endpoint della cronologia**: Due nuovi endpoint espongono la cronologia dell'isolamento audio. - [Elenca la cronologia dell'isolamento audio](/docs/it/api-reference/audio-isolation/list) (`GET /v1/audio-isolation/history`) restituisce un elenco paginato di tutte le generazioni di isolamento audio. Supporta i parametri query `page_size`, `page` e `search`. - [Elimina elemento della cronologia dell'isolamento audio](/docs/it/api-reference/audio-isolation/delete) (`DELETE /v1/audio-isolation/history/{history_item_id}`) elimina un elemento specifico e i file multimediali associati. ### Speech to Text - **Keyterm in tempo reale e modalità verbatim**: Il [WebSocket Scribe in tempo reale](/docs/it/api-reference/speech-to-text/v-1-speech-to-text-realtime) ora accetta un parametro `keyterms` (array di stringhe, massimo 50 elementi fino a 20 caratteri ciascuno) per orientare il modello verso termini specifici e un booleano `no_verbatim` per rimuovere parole riempitive, false partenze e disfluenze dalle trascrizioni. Entrambi i parametri vengono restituiti nell'evento `session_started`. Disponibili con [SDK JavaScript](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0), [SDK Python](https://github.com/elevenlabs/elevenlabs-python) e SDK client per browser/Node [`@elevenlabs/client`](https://github.com/elevenlabs/packages/tree/main/packages/client). ### Release degli SDK #### SDK Python - [v2.45.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.45.0) - Rigenerazione Fern per lo schema API del 27 aprile 2026, inclusi endpoint della cronologia di isolamento audio, esecuzioni degli strumenti, `pre_tool_speech` e `response_timeout_secs` di MCP e l'evento client `agent_response_complete`. Include anche una correzione al suggerimento di installazione per notebook nel README. - [v2.44.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.44.0) - Rigenerazione Fern per lo schema API del 21 aprile 2026, con il campo `trust_context`, la modalità `pre_tool_speech`, il supporto per la trascrizione degli asset e la configurazione del timeout delle risposte MCP. #### SDK JavaScript - [v2.45.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0) - Aggiunte le opzioni `keyterms` (array di stringhe, massimo 50 keyterm fino a 20 caratteri ciascuno) e `noVerbatim` (booleano) al client Scribe in tempo reale. I `keyterms` vengono inviati come parametri query ripetuti nell'URL WebSocket per orientare la trascrizione, mentre `noVerbatim` rimuove parole riempitive e disfluenze. Entrambi i campi sono stati aggiunti anche all'interfaccia `Config` tipizzata per l'eco `session_started`. Include anche la rigenerazione Fern del 27 aprile 2026 ([#376](https://github.com/elevenlabs/elevenlabs-js/pull/376)). - [v2.44.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.44.0) - Rigenerazione Fern per lo schema API del 21 aprile 2026, con il campo `trust_context`, la modalità `pre_tool_speech` e la configurazione del timeout delle risposte MCP. #### SDK Swift - [v3.1.4](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.4) - Corretto un problema per cui il microfono locale continuava a trasmettere dopo la disconnessione di un agente (timeout del silenzio o strumento `end_call`). Ora `onAgentDisconnected` disconnette la stanza LiveKit e rimuove lo stato della conversazione, mentre `onDisconnect` viene attivato con un motivo `.agent`. `ConnectionManaging.onAgentDisconnected` ora è `async`. Rimosso il wrapper `ConversationConnectionManager` inutilizzato. #### Pacchetti - [@elevenlabs/client@1.3.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.1) - Corretto il problema per cui il suono della chiamata allo strumento dell'agente veniva interpretato come parlato dell'utente, interrompendo l'agente durante l'esecuzione dello strumento. - [@elevenlabs/client@1.3.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.0) - Aggiunto il supporto per l'endpoint [carica file della conversazione](/docs/it/api-reference/conversations/upload-file), che consente ai client di allegare file a una conversazione in corso direttamente dall'SDK client. - [@elevenlabs/react@1.2.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.1), [@elevenlabs/react@1.2.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.0) - Aggiornati a `@elevenlabs/client@1.3.1` / `@elevenlabs/client@1.3.0`, includendo la correzione del suono delle chiamate agli strumenti e il supporto per il caricamento dei file delle conversazioni. - [@elevenlabs/react-native@1.1.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.3), [@elevenlabs/react-native@1.1.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.2) - Aggiornati all'ultima versione di `@elevenlabs/client` con le stesse correzioni. - [@elevenlabs/convai-widget-core@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.6), [@elevenlabs/convai-widget-embed@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.6) - Aggiornati a `@elevenlabs/client@1.3.1` per la correzione del suono delle chiamate agli strumenti. - [@elevenlabs/convai-widget-core@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.5), [@elevenlabs/convai-widget-embed@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.5) - Aggiornati a `@elevenlabs/client@1.3.0` per il supporto del caricamento dei file delle conversazioni. ### API ## Nuovi endpoint - [Elenca la cronologia dell'isolamento audio](/docs/it/api-reference/audio-isolation/list) - `GET /v1/audio-isolation/history` - [Elimina elemento della cronologia dell'isolamento audio](/docs/it/api-reference/audio-isolation/delete) - `DELETE /v1/audio-isolation/history/{history_item_id}` - [Ottieni esecuzioni degli strumenti](/docs/it/api-reference/tools/get-executions) - `GET /v1/convai/tools/{tool_id}/executions` restituisce esecuzioni paginate per uno strumento specifico con filtri facoltativi `cursor`, `page_size`, `is_error`, `agent_id`, `branch_id`, `start_time` e `end_time` ## 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 `trust_context` (enum `AgentTrustContext`: `unknown` | `low` | `high`, valore predefinito `unknown`) in `AgentPlatformSettingsRequestModel` - Aggiunto il campo `source_attribution` (booleano, valore predefinito `false`) in `ConversationConfig` - [Aggiorna configurazione del server MCP](/docs/it/api-reference/mcp/update), [Crea server MCP](/docs/it/api-reference/mcp/create) - Aggiunto il campo `pre_tool_speech` (enum `PreToolSpeechMode`: `auto` | `force` | `off`, valore predefinito `auto`) - Aggiunto il campo `response_timeout_secs` (intero, valore predefinito `30`, minimo `5`, massimo `120`) - [Crea sostituzione della configurazione](/docs/it/api-reference/mcp/tool-configuration/create), [Aggiorna sostituzione della configurazione](/docs/it/api-reference/mcp/tool-configuration/update) - Aggiunto il campo `pre_tool_speech` (enum `PreToolSpeechMode`, nullable, facoltativo) - Aggiunto il campo `response_timeout_secs` (intero, nullable, facoltativo) - Aggiunto il campo `response_mocks` in `MCPToolConfigOverride-Input` / `MCPToolConfigOverride-Output` - Contrassegnato `force_pre_tool_speech` come deprecato; usa invece `pre_tool_speech` - [Elenca test](/docs/it/api-reference/tests/list) - Aggiunto il parametro query facoltativo `sharing_mode` (enum `TestSharingMode`: `all` | `shared_with_me`, valore predefinito `all`) - [Simula conversazione](/docs/it/api-reference/agents/simulate-conversation), [Simula conversazione in streaming](/docs/it/api-reference/agents/simulate-conversation-stream) - Refactor dei payload `dynamic_variables` e `dynamic_variable_placeholders`, che ora fanno riferimento agli schemi unificati `DynamicVariableValueType-Input` / `DynamicVariableValueType-Output` con un supporto più ampio per valori nidificati e in elenco - Schema `Tool` - Aggiunto il campo `icons` (array di `Icon`, nullable) per la visualizzazione nell'interfaccia utente - Aggiunto il campo `execution` (`ToolExecution`, nullable), incluso `taskSupport` (`forbidden` | `optional` | `required`) - Enum `ClientEvent` - Aggiunto il valore `agent_response_complete` con il nuovo modello di risposta `AgentResponseCompleteClientEvent` - Enum `ProcedureCompilerMode` - Valore predefinito modificato da `deterministic` a `append` - Rimosso il valore `llm` - `ConversationHistoryTranscriptCommonModel`, `ConversationHistoryTranscriptResponseModel` - Aggiunto il campo `used_static_kb_document_ids` (array di stringhe) - `RagRetrievalInfo` - Aggiunto il campo `used_chunk_ids` (array di stringhe) - `DynamicVariableAssignment` - Aggiunto il campo `preserve_native_type` (booleano) per conservare i valori tipizzati anziché convertirli in stringhe - Nodi del workflow - Aggiunto il campo `auto_advance_after_first_response` negli schemi dei nodi del workflow pertinenti - Documentazione della configurazione degli strumenti - Aggiunto il campo `response_body_schema` per documentare la struttura prevista della risposta ### Workspace - `GetUserSubscriptionResponseModel` - Aggiunto il campo `max_credit_limit_extension` - [Ottieni l'utilizzo del workspace per prodotto nel tempo](/docs/it/api-reference/workspace/usage/get-usage-by-product-over-time) - Convalida della richiesta più rigorosa: i valori minimi di `start_time` e `end_time` sono stati aumentati a `2020-01-01`, con descrizioni aggiunte per entrambi i campi. Il riepilogo dell'endpoint è stato rinominato in `Get Workspace Usage`. ### Altro - Nuovo enum condiviso `Currency` con valori `eur`, `inr`, `usd`, che sostituisce le stringhe di valuta inline in diversi schemi. - I nuovi schemi `AssetTranscription` e `AssetTranscriptionData` estendono i modelli degli asset con il supporto alla trascrizione. - I nuovi `PendingBlocksMetadataModel` e `PendingExternalAudiosMetadataModel` forniscono metadati più ricchi sulle attività in attesa. - Aggiunto il nuovo valore `InVPC` agli enum relativi alle fonti. - I `keyterms` della trascrizione ora hanno restrizioni esplicite sulla lunghezza nella specifica. - Aggiunti i nuovi schemi `MemoryEntrySearchResult`, `ConversationSource` e `ManualSource`.