Vai alla navigazione

Registro delle modifiche

March 23, 2026

ElevenAgents

  • API delle variabili d’ambiente: Nuovi endpoint per le variabili d’ambiente per gestire la configurazione a livello di workspace, a cui gli agenti possono fare riferimento in runtime tramite il templating {{system_env__<label>}}. Supporta variabili di tipo stringa, secret e connessione di autenticazione, con override dei valori per ambiente. Gli endpoint includono creazione, elenco, recupero e aggiornamento.

  • Gestione delle connessioni di autenticazione: Nuova API per le connessioni di autenticazione a livello di workspace, per gestire le credenziali usate dagli strumenti e dalle integrazioni degli agenti. Supporta più metodi di autenticazione, tra cui credenziali client OAuth2, JWT, autenticazione basic, bearer token, header personalizzati e flussi OAuth2 authorization code gestiti dalle integrazioni. Gli endpoint includono operazioni di creazione, elenco ed eliminazione.

  • Aggiornamento degli URL della knowledge base: Nuovo endpoint di aggiornamento (POST /v1/convai/knowledge-base/{documentation_id}/refresh) per recuperare di nuovo e aggiornare i contenuti dei documenti della knowledge base provenienti da URL. I documenti della knowledge base ora supportano anche la configurazione della sincronizzazione automatica con i campi enable_auto_sync, auto_remove e auto_sync_info.

  • Nuovo tentativo del guardrail con feedback: I guardrail personalizzati e per i contenuti ora supportano azioni di attivazione configurabili con le opzioni EndCallTriggerAction e RetryTriggerAction. Se impostato per riprovare, l’agente rigenera la risposta con feedback di sistema inserito, fino a 3 tentativi. I placeholder disponibili includono {{trigger_reason}} e {{agent_message}} per indicazioni contestuali sul nuovo tentativo.

  • Variabile di sistema per la cronologia della conversazione: Aggiunta una nuova variabile dinamica system__conversation_history che fornisce in runtime una cronologia della conversazione valutata in modo lazy e serializzata in JSON. È utile per passare il contesto completo della conversazione a strumenti, webhook o passaggi a sotto-agenti.

  • Tipo di contenuto dello strumento webhook: Gli strumenti server ora supportano un tipo di contenuto configurabile per i parametri del body dei webhook, consentendoti di scegliere tra i formati application/json e application/x-www-form-urlencoded. Il formato con codifica URL è utile per l’integrazione con sistemi legacy, endpoint per token OAuth e processori di pagamento.

  • Messaggi WhatsApp in uscita: L’integrazione WhatsApp è stata aggiornata con una nuova finestra di dialogo per i messaggi in uscita nella dashboard, che consente agli agenti di inviare messaggi in uscita oltre a effettuare chiamate tramite il canale WhatsApp.

  • Filtri per gli elenchi di agenti e risorse: Gli endpoint elenca agenti, elenca documenti della knowledge base ed elenca strumenti ora supportano un parametro query created_by_user_id (usa @me per l’utente corrente). I precedenti parametri show_only_owned_agents e show_only_owned_documents sono deprecati.

  • Espressioni condizionali dei workflow: Aggiunto un nuovo nodo AST conditional_operator allo schema delle espressioni dei workflow, che abilita la logica di diramazione nelle definizioni dei workflow degli agenti.

Musica

  • Music Marketplace: Nuova documentazione di Music Marketplace dedicata al marketplace per la concessione di licenze di musica generata dall’IA, inclusi tipi di utilizzo, compensi per i creator e dettagli sulle licenze.

Rilasci degli SDK

SDK Python

  • v2.40.0 - Aggiunto il supporto del parametro environment per le conversazioni ElevenAgents, che abilita connessioni degli agenti specifiche per ambiente. Rigenerazione di Fern per corrispondere allo schema API più recente, incluse variabili d’ambiente, connessioni di autenticazione, aggiornamento della knowledge base e azioni di attivazione dei guardrail.

SDK JavaScript

  • v2.40.0 - Aggiunto il tipo di evento WebSocket multimodal_message per le conversazioni ElevenAgents in tempo reale. Rigenerazione di Fern per corrispondere allo schema API più recente, incluse variabili d’ambiente, connessioni di autenticazione, aggiornamento della knowledge base e azioni di attivazione dei guardrail.

SDK iOS

  • v3.1.1 - Aggiunto il supporto del parametro environment per le connessioni degli agenti specifiche per ambiente. Corretto un errore di build visionOS aumentando il requisito della piattaforma a v2.

Pacchetti

Release Candidate dei pacchetti v1.0.0

È ora disponibile la prima release candidate della v1.0.0 degli SDK client ElevenAgents. Si tratta di una release principale con modifiche incompatibili che migliorano la superficie dell’API, aggiungono hook React granulari per migliori prestazioni di rendering e unificano l’SDK React Native con l’SDK React.

Per provare la release candidate:

npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next

È disponibile una skill elevenlabs:sdk-migration per aiutare gli assistenti di coding IA a migrare automaticamente la tua codebase alle nuove API. Aggiungila al tuo progetto Claude Code, Cursor o Windsurf per ricevere supporto guidato alla migrazione.

Modifiche principali nella v1.0.0:

  • @elevenlabs/client: Conversation ora è un oggetto namespace e un alias di tipo per TextConversation | VoiceConversation anziché una classe. Le classi Input e Output sono sostituite dalle interfacce InputController e OutputController, con nuovi metodi pratici sull’istanza della conversazione (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() e changeOutputDevice() ora restituiscono void.
  • @elevenlabs/react: useConversation ora richiede un antenato ConversationProvider. Nuovi hook granulari per un re-rendering dettagliato: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Nuovo hook useConversationClientTool() per registrare dinamicamente strumenti client dai componenti React con completa sicurezza dei tipi.
  • @elevenlabs/react-native: Riscrittura completa dell’API che sostituisce ElevenLabsProvider e useConversation con ConversationProvider e gli stessi hook granulari di @elevenlabs/react. I polyfill WebRTC e la configurazione nativa di AudioSession vengono applicati automaticamente all’importazione.

Consulta le note di rilascio complete e le guide alla migrazione:

API

Nuovi endpoint

ElevenAgents

  • Crea variabile d’ambiente - POST /v1/convai/environment-variables - Crea una nuova variabile d’ambiente di tipo stringa, secret o connessione di autenticazione
  • Elenca variabili d’ambiente - GET /v1/convai/environment-variables - Elenca tutte le variabili d’ambiente nel workspace
  • Recupera variabile d’ambiente - GET /v1/convai/environment-variables/{env_var_id} - Recupera una variabile d’ambiente specifica
  • Aggiorna variabile d’ambiente - PATCH /v1/convai/environment-variables/{env_var_id} - Aggiorna una variabile d’ambiente, inclusa la rimozione dei valori per ambiente tramite null
  • Aggiorna il contenuto del documento URL - POST /v1/convai/knowledge-base/{documentation_id}/refresh - Recupera di nuovo il contenuto dei documenti della knowledge base provenienti da URL

Workspace

  • POST /v1/workspace/auth-connections - Crea una connessione di autenticazione del workspace con supporto per metodi OAuth2, JWT, basic, bearer, header personalizzati e gestiti dalle integrazioni
  • GET /v1/workspace/auth-connections - Elenca tutte le connessioni di autenticazione del workspace con informazioni sulle dipendenze (strumenti, server MCP, connessioni di integrazione)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Elimina una connessione di autenticazione del workspace

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Elenca i criteri di valutazione
  • POST /v1/speech-to-text/evaluation/eval-criteria - Crea un criterio di valutazione
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Recupera un criterio di valutazione specifico
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Aggiorna un criterio di valutazione
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Elimina un criterio di valutazione
  • POST /v1/speech-to-text/evaluation/evaluations - Avvia una valutazione
  • GET /v1/speech-to-text/evaluation/evaluations - Elenca le valutazioni
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Recupera una valutazione specifica
  • GET /v1/speech-to-text/evaluation/human-agents - Elenca gli agenti umani
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Recupera un agente umano
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Elimina un agente umano
  • GET /v1/speech-to-text/evaluation/analytics - Recupera le analisi delle valutazioni
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Recupera le analisi per un criterio specifico
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Recupera le analisi per un agente umano specifico

Endpoint aggiornati

ElevenAgents

  • Recupera URL firmato, Recupera token di conversazione

    • Aggiunto il parametro query environment (stringa, facoltativo) per la risoluzione specifica per ambiente

  • Elenca agenti

    • Aggiunto il parametro query created_by_user_id (stringa, facoltativo, supporta @me)
    • Deprecato show_only_owned_agents a favore di created_by_user_id

  • Elenca documenti della knowledge base

    • Aggiunto il parametro query created_by_user_id (stringa, facoltativo, supporta @me)
    • Deprecato show_only_owned_documents a favore di created_by_user_id

  • Elenca strumenti

    • Aggiunto il parametro query created_by_user_id (stringa, facoltativo, supporta @me)
    • Deprecato show_only_owned_documents a favore di created_by_user_id

  • Recupera chunk della knowledge base

    • Aggiunto il parametro query embedding_model (stringa, facoltativo) per specificare il modello di embedding per il recupero dei chunk

  • Crea agente, Aggiorna agente, Crea bozza

    • Aggiunto il supporto per guardrail_trigger_action con gli schemi EndCallTriggerAction e RetryTriggerAction
    • Aggiunto il nodo AST conditional_operator alle definizioni delle espressioni dei workflow
    • Gli schemi degli agenti ora supportano ConvAIEnvVarLocator e EnvironmentAuthConnectionLocator per fare riferimento alle variabili d’ambiente nelle configurazioni degli strumenti

  • Chiamata in uscita SIP trunk

    • Schema della richiesta aggiornato per includere nuovi campi correlati all’ambiente

  • Simula conversazione, Stream di simulazione della conversazione

    • Aggiunto il campo simulation_environment allo schema della richiesta

Modifiche agli schemi

Nuovi schemi

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modelli di variabili d’ambiente che supportano i tipi stringa, secret e connessione di autenticazione
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Locator per fare riferimento alle variabili d’ambiente nelle configurazioni degli strumenti e dei server MCP
  • EndCallTriggerAction, RetryTriggerAction - Schemi di azione di attivazione dei guardrail per i comportamenti di fine chiamata e nuovo tentativo con feedback
  • ConditionalOperator - Nuovo nodo AST per le espressioni condizionali nei workflow degli agenti
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Schemi per la gestione delle connessioni di autenticazione del workspace con supporto per metodi OAuth2, JWT, basic, bearer, header personalizzati, WhatsApp e gestiti dalle integrazioni
  • SpeechToTextEvaluation* - Suite di schemi per criteri di valutazione Speech to Text, valutazioni, agenti umani e analisi

Schemi modificati

  • MCPServerConfig, MCPServerConfigOutput - Aggiunto il supporto per riferimenti ConvAIEnvVarLocator nella configurazione del server
  • CustomGuardrailConfig - Aggiunto il campo trigger_action per configurare il comportamento di fine chiamata o nuovo tentativo
  • Contributor - Aggiunti i campi facoltativi bio (stringa) e profile_id (stringa)
  • ASTLLMNode - Aggiunto il campo value_schema; il campo prompt è deprecato a favore di value_schema
  • TelephonyDirection - Ristrutturato come enum condiviso a cui fanno riferimento più modelli di conversazione e telefonia