> 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, ElevenCreative ed ElevenAPI

Stiamo passando dalla percezione di un unico prodotto (“ElevenLabs”) a una struttura basata su una piattaforma con famiglie di prodotti ben definite:

- ElevenAgents (in precedenza Piattaforma Agents)
- ElevenCreative (in precedenza Piattaforma Creative)
- ElevenAPI (nuova, la piattaforma per sviluppatori)

Lo vedrai già nella documentazione e nei readme degli SDK.

### Server globali fuori dalla beta

Il routing globale è ora l'impostazione predefinita, anziché una funzionalità opt-in.

In precedenza, il server API ElevenLabs predefinito si trovava negli Stati Uniti, con una beta opt-in per instradare il traffico attraverso server basati nei Paesi Bassi o a Singapore. Da ora il routing globale è predefinito, quindi il server verrà scelto automaticamente in base alla vicinanza geografica per ottimizzare la latenza.

Il base URL opt-in `api-global-preview.elevenlabs.io` è ora deprecato; usa invece il base URL predefinito `api.elevenlabs.io`. Se usi gli SDK, questa è già l'impostazione predefinita.

### Text to Speech

- **Normalizzatore TTS v3.1**: aggiornato il normalizzatore di testo alla versione 3.1, che include maggiore accuratezza e minore latenza per la conversione text-to-speech.

### Piattaforma Agents

- **Guardrail personalizzati**: aggiunto il supporto per guardrail di output definiti dall'utente, che ti consentono di creare regole di filtraggio dei contenuti personalizzate oltre alla moderazione standard. Configura i guardrail con un nome, un'istruzione prompt (fino a 10.000 caratteri) e un modello di valutazione a scelta (`gemini-2.5-flash-lite` o `gemini-2.0-flash`). Quando si attiva, il guardrail termina la conversazione. Consulta il [riferimento API Create agent](/docs/it/api-reference/agents/create#request.body.conversation_config.safety.guardrails.custom) per i dettagli di configurazione.
- **Messaggistica WhatsApp in uscita**: aggiunto l'endpoint [Send outbound message](/docs/it/api-reference/whats-app/outbound-message) (`POST /v1/convai/whatsapp/outbound-message`) per avviare conversazioni via WhatsApp utilizzando template di messaggio. I campi obbligatori includono `whatsapp_phone_number_id`, `whatsapp_user_id`, `template_name`, `template_language_code`, `template_params` e `agent_id`.
- **Modello conversazionale Eleven v3**: aggiunto `eleven_v3_conversational` ai modelli TTS disponibili per gli agenti, offrendo maggiore qualità vocale ed espressività nelle conversazioni degli agenti.
- **Tag audio suggeriti**: aggiunto il campo `suggested_audio_tags` alla configurazione TTS per gli agenti che usano modelli v3. Definisci fino a 20 tag (ad esempio, "happy", "excited") per guidare la generazione di parlato espressivo, con descrizioni opzionali per indicare quando utilizzare ciascun tag.
- **Gestione degli errori degli strumenti**: aggiunto il campo `tool_error_handling_mode` alle configurazioni degli strumenti webhook con le opzioni: `auto` (predefinita, determina la gestione in base al tipo di strumento), `summarized` (invia un riepilogo generato dall'LLM), `passthrough` (invia l'errore non elaborato) o `hide` (non condivide l'errore con l'agente).
- **Sanitizzazione delle variabili dinamiche**: aggiunto il campo `sanitize` (booleano, valore predefinito `false`) a `DynamicVariableAssignment`. Se abilitato, il valore di assegnazione viene rimosso dalle risposte degli strumenti e dalle trascrizioni, ma continua a essere elaborato per l'assegnazione della variabile.
- **Selezione del modello di turno**: aggiunto l'enum `TurnModel` con le opzioni `turn_v2` e `turn_v3` per selezionare la versione del modello di rilevamento dei turni.
- **Trasferimenti dei nodi workflow**: aggiunto il campo `is_workflow_node_transfer` (booleano, valore predefinito `false`) allo schema `AgentTransfer` per identificare i trasferimenti all'interno dei nodi workflow.
- **Metadati dei branch di trasferimento**: aggiunti gli schemi `TransferBranchInfoTrafficSplit` e `TransferBranchInfoDefaultingToMain` per monitorare le informazioni di routing dei branch nei trasferimenti degli agenti.
- **Test delle transizioni dei nodi workflow**: aggiunto il tipo di asserzione `workflow_node_transition` per i test unitari con lo schema `UnitTestWorkflowNodeTransitionEvaluationNodeId` per convalidare le transizioni del workflow degli agenti.

### Studio ElevenCreative

- **Endpoint per le tracce disattivate**: aggiunto l'endpoint [Get project muted tracks](/docs/it/api-reference/studio/get-muted-tracks) (`GET /v1/studio/projects/{project_id}/muted-tracks`) che restituisce un elenco di ID capitolo con tracce disattivate in un progetto.

### Workspace

- **Tipo di posto membro Lite**: aggiunto `workspace_lite_member` all'enum `SeatType` per workspace con autorizzazioni di accesso limitate.
- **Risorsa template di contenuto**: aggiunto `content_templates` all'enum `WorkspaceResourceType` per condividere template di contenuto nei workspace.

### Interfaccia utente

- **Scorrimento della raccolta di voci**: corretto un problema che impediva lo scorrimento con la rotellina del mouse e con il tocco nel selettore di icone della raccolta di voci su macOS.

### Rilasci SDK

#### SDK Python

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.35.0) - Aggiunti guardrail personalizzati, messaggistica WhatsApp in uscita, modalità di gestione degli errori degli strumenti, sanitizzazione delle variabili dinamiche, selezione del modello di turno e supporto per il modello conversazionale Eleven v3

#### SDK JavaScript

- [v2.35.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.35.0) - Aggiunti guardrail personalizzati, messaggistica WhatsApp in uscita, modalità di gestione degli errori degli strumenti, sanitizzazione delle variabili dinamiche, selezione del modello di turno e supporto per il modello conversazionale Eleven v3

#### SDK React e Client

- [@elevenlabs/react-native@0.5.10](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@0.5.10) - Corretta l'attivazione delle conversazioni di solo testo
- [@elevenlabs/react@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.0) - Ridotta la durata dei chunk audio da 250 ms a 100 ms per una latenza inferiore nelle conversazioni degli agenti
- [@elevenlabs/client@0.14.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.14.0) - Ridotta la durata dei chunk audio da 250 ms a 100 ms per una latenza inferiore, normalizzata la gestione dell'opzione `textOnly` tra il livello superiore e l'oggetto degli override
- [@elevenlabs/types@0.5.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.5.0) - Aggiunti tipi per il supporto dei dati di allineamento audio

### API

<Accordion title="Visualizza le modifiche API">

## Nuovi endpoint

- [Invia un messaggio in uscita tramite WhatsApp](/docs/it/api-reference/whats-app/outbound-message) - `POST /v1/convai/whatsapp/outbound-message` - Invia un messaggio in uscita tramite WhatsApp usando template di messaggio
- [Ottieni le tracce disattivate del progetto](/docs/it/api-reference/studio/get-muted-tracks) - `GET /v1/studio/projects/{project_id}/muted-tracks` - Restituisce gli ID dei capitoli con tracce disattivate

## Endpoint aggiornati

### Piattaforma Agents

- [Create agent](/docs/it/api-reference/agents/create), [Update agent](/docs/it/api-reference/agents/update), [Get agent](/docs/it/api-reference/agents/get)
  - Aggiunto il campo `custom` allo schema `GuardrailsV1` per la configurazione di guardrail personalizzati
  - Aggiunto il campo `alignment` allo schema `GuardrailsV1` per i guardrail di allineamento
  - Aggiunto il campo `suggested_audio_tags` alla configurazione conversazionale TTS (array di `SuggestedAudioTag`, max 20 elementi)
  - Aggiunto `eleven_v3_conversational` all'enum `TTSConversationalModel`
- [Create tool](/docs/it/api-reference/tools/create), [Update tool](/docs/it/api-reference/tools/update)
  - Aggiunto il campo `tool_error_handling_mode` a `ApiIntegrationWebhookToolConfig` (enum: `auto`, `summarized`, `passthrough`, `hide`, valore predefinito `auto`)
  - Aggiunto il campo `sanitize` a `DynamicVariableAssignment` (booleano, valore predefinito `false`)

### Workspace

- [Get resource](/docs/it/api-reference/workspace/resources/get)
  - Aggiunto `content_templates` all'enum `WorkspaceResourceType`
- [Add workspace invite](/docs/it/api-reference/workspace/invites/create), [Add workspace member](/docs/it/api-reference/workspace/invites/create)
  - Aggiunto `workspace_lite_member` all'enum `SeatType`

## Modifiche agli schemi

### Nuovi schemi

- `CustomGuardrail-Input`, `CustomGuardrail-Output` - Contenitore per la configurazione di guardrail personalizzati
- `CustomGuardrailsConfig` - Contenitore di configurazione per l'elenco di guardrail personalizzati
- `CustomGuardrailConfig` - Singolo guardrail personalizzato con `name` (stringa, obbligatorio), `prompt` (stringa, obbligatorio, max 10.000 caratteri), `model` (enum: `gemini-2.5-flash-lite`, `gemini-2.0-flash`, obbligatorio) e `is_enabled` (booleano, valore predefinito `false`)
- `ToolErrorHandlingMode` - Enum per la gestione degli errori degli strumenti: `auto`, `summarized`, `passthrough`, `hide`
- `TurnModel` - Enum per la versione del modello di rilevamento dei turni: `turn_v2`, `turn_v3`
- `SuggestedAudioTag` - Configurazione del tag audio con `tag` (stringa, obbligatorio, max 30 caratteri) e `description` (stringa, opzionale, max 200 caratteri)
- `TransferBranchInfoTrafficSplit` - Informazioni sul branch per trasferimenti con suddivisione del traffico, con `branch_id` e `traffic_percentage`
- `TransferBranchInfoDefaultingToMain` - Informazioni sul branch per trasferimenti con fallback al principale, con `branch_id`
- `UnitTestWorkflowNodeTransitionEvaluationNodeId` - Configurazione del test di transizione del nodo workflow con `agent_id` e `target_node_id`
- `ProjectMutedTracksResponseModel` - Modello di risposta con array `chapter_ids`
- `WhatsAppOutboundMessageResponse` - Risposta per l'endpoint dei messaggi WhatsApp in uscita
- `WhatsAppTemplateHeaderComponentParams`, `WhatsAppTemplateBodyComponentParams`, `WhatsAppTemplateButtonComponentParams` - Schemi dei parametri template per i messaggi WhatsApp
- `ConversationHistoryTranscriptSystemToolResultCommonModel-Input`, `ConversationHistoryTranscriptSystemToolResultCommonModel-Output` - Modelli di risultati degli strumenti di sistema separati per le varianti input/output

### Schemi modificati

- `GuardrailsV1-Input`, `GuardrailsV1-Output` - Aggiunti i campi `custom` (CustomGuardrail) e `alignment` (AlignmentGuardrail)
- `TTSConversationalConfig-Input`, `TTSConversationalConfig-Output` - Aggiunto il campo `suggested_audio_tags`
- `TTSConversationalModel` - Aggiunto il valore enum `eleven_v3_conversational`
- `ApiIntegrationWebhookToolConfig-Input`, `ApiIntegrationWebhookToolConfig-Output` - Aggiunto il campo `tool_error_handling_mode` (obbligatorio)
- `DynamicVariableAssignment` - Aggiunto il campo `sanitize` (booleano, valore predefinito `false`)
- `AgentTransfer` - Aggiunto il campo `is_workflow_node_transfer` (booleano, valore predefinito `false`)
- `SeatType` - Aggiunto il valore enum `workspace_lite_member`
- `WorkspaceResourceType` - Aggiunto il valore enum `content_templates`

### Schemi rimossi

- `AgentBan` - Rimosso schema non utilizzato
- `BanReasonType` - Rimosso enum non utilizzato
- `DubbingReleaseChannel` - Rimosso enum non utilizzato

</Accordion>