> 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

- **API delle variabili d'ambiente**: Nuovi endpoint per le [variabili d'ambiente](/docs/it/eleven-agents/integrate/environment-variables) 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](/docs/it/api-reference/environment-variables/create), [elenco](/docs/it/api-reference/environment-variables/list), [recupero](/docs/it/api-reference/environment-variables/get) e [aggiornamento](/docs/it/api-reference/environment-variables/update).

- **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](/docs/it/api-reference/knowledge-base/refresh) (`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](/docs/it/eleven-agents/best-practices/guardrails) 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](/docs/it/eleven-agents/customization/tools/server-tools) 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](/docs/it/eleven-agents/whatsapp) 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](/docs/it/api-reference/agents/list), [elenca documenti della knowledge base](/docs/it/api-reference/knowledge-base/list) ed [elenca strumenti](/docs/it/api-reference/tools/list) 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](/docs/it/overview/capabilities/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](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/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

- [@elevenlabs/types@0.6.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.1) - Aggiunto il tipo di evento WebSocket `multimodal_message` per le conversazioni ElevenAgents in tempo reale.
- [@elevenlabs/client@0.15.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.2) - Aggiunto il supporto per l'evento WebSocket `multimodal_message`.
- [@elevenlabs/react@0.14.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.3) - Aggiunto il supporto per l'evento WebSocket `multimodal_message`.
- [@elevenlabs/convai-widget-core@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.4), [@elevenlabs/convai-widget-core@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.5) - Aggiornato a `@elevenlabs/client@0.15.2`.
- [@elevenlabs/convai-widget-embed@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.4), [@elevenlabs/convai-widget-embed@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.5) - Aggiornato a `@elevenlabs/client@0.15.2`.

#### 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:

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

È disponibile una skill [`elevenlabs:sdk-migration`](https://github.com/elevenlabs/packages/blob/main/.agents/skills/elevenlabs%3Asdk-migration/SKILL.md) 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:

- [@elevenlabs/client@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0-rc.1)
- [@elevenlabs/react@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0-rc.1)
- [@elevenlabs/react-native@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0-rc.1)
- [@elevenlabs/types@0.7.0-rc.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.7.0-rc.0)

### API

<Accordion title="Visualizza le modifiche all'API">

## Nuovi endpoint

### ElevenAgents

- [Crea variabile d'ambiente](/docs/it/api-reference/environment-variables/create) - `POST /v1/convai/environment-variables` - Crea una nuova variabile d'ambiente di tipo stringa, secret o connessione di autenticazione
- [Elenca variabili d'ambiente](/docs/it/api-reference/environment-variables/list) - `GET /v1/convai/environment-variables` - Elenca tutte le variabili d'ambiente nel workspace
- [Recupera variabile d'ambiente](/docs/it/api-reference/environment-variables/get) - `GET /v1/convai/environment-variables/{env_var_id}` - Recupera una variabile d'ambiente specifica
- [Aggiorna variabile d'ambiente](/docs/it/api-reference/environment-variables/update) - `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](/docs/it/api-reference/knowledge-base/refresh) - `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](/docs/it/api-reference/conversations/get-signed-url), [Recupera token di conversazione](/docs/it/api-reference/conversations/get-webrtc-token)

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

- [Elenca agenti](/docs/it/api-reference/agents/list)

  - 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](/docs/it/api-reference/knowledge-base/list)

  - 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](/docs/it/api-reference/tools/list)

  - 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](/docs/it/api-reference/knowledge-base/get-chunk)

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

- [Crea agente](/docs/it/api-reference/agents/create), [Aggiorna agente](/docs/it/api-reference/agents/update), [Crea bozza](/docs/it/api-reference/agents/drafts/create)

  - 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](/docs/it/api-reference/sip-trunk/outbound-call)

  - Schema della richiesta aggiornato per includere nuovi campi correlati all'ambiente

- [Simula conversazione](/docs/it/api-reference/agents/simulate-conversation), [Stream di simulazione della conversazione](/docs/it/api-reference/agents/simulate-conversation-stream)

  - 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

</Accordion>