Registro delle modifiche

ElevenAgents

• Evento WebSocket agent_response_complete: Un nuovo evento client agent_response_complete 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 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 (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 (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 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, SDK Python e SDK client per browser/Node @elevenlabs/client.

Release degli SDK

SDK Python

• 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 - 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 - 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).
• 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 - 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 - 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 - Aggiunto il supporto per l’endpoint carica file della conversazione, che consente ai client di allegare file a una conversazione in corso direttamente dall’SDK client.
• @elevenlabs/react@1.2.1, @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, @elevenlabs/react-native@1.1.2 - Aggiornati all’ultima versione di @elevenlabs/client con le stesse correzioni.
• @elevenlabs/convai-widget-core@0.11.6, @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, @elevenlabs/convai-widget-embed@0.11.5 - Aggiornati a @elevenlabs/client@1.3.0 per il supporto del caricamento dei file delle conversazioni.

API