> 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

- **Rebase dei branch**: aggiunto `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` per eseguire il rebase di un branch sull'ultima versione di main, mantenendo le modifiche specifiche del branch. I modelli parent delle versioni dell'agente aggiungono il campo facoltativo `rebased_from_version_id` (string) per tracciare la versione di origine dopo un rebase.
- **Filtraggio delle conversazioni per prodotto**: [Elenca le conversazioni](/docs/it/api-reference/conversations/list) e [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) aggiungono il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`) per filtrare i risultati per prodotto. I modelli delle conversazioni introducono `ConversationProduct` per questa distinzione.
- **Filtraggio della terminazione delle conversazioni**: [Elenca le conversazioni](/docs/it/api-reference/conversations/list) aggiunge il parametro query facoltativo `termination_reasons` (array di stringhe) per filtrare le conversazioni in base a come sono terminate.
- **Rilevamento degli argomenti per agente**: le impostazioni della piattaforma di [Crea agente](/docs/it/api-reference/agents/create) e [Aggiorna agente](/docs/it/api-reference/agents/update) aggiungono `topic_discovery` (`TopicDiscoverySettings`) facoltativo per configurare il rilevamento degli argomenti per singolo agente.
- **Configurazione dell'audio di sottofondo**: i modelli di configurazione della piattaforma dell'agente e delle conversazioni aggiungono `background_sound` (`BackgroundSoundConfig`) facoltativo per l'audio ambientale durante le conversazioni.
- **Termini da ignorare per l'interruzione del turno**: gli schemi di configurazione dei turni aggiungono `interruption_ignore_terms` facoltativo (array di stringhe) per disattivare il rilevamento del turno per frasi specifiche.
- **Randomizzazione dei riempitivi per soft timeout**: la configurazione del soft timeout aggiunge `randomize_fillers` facoltativo (boolean) per mescolare i messaggi riempitivi tra i soft timeout. I campi di override del messaggio di soft timeout e del prompt LLM ora supportano le variabili dinamiche.
- **Identificatori utente nelle trascrizioni**: i modelli dei messaggi della trascrizione aggiungono `user_identifier` facoltativo (string) nei messaggi scritti dall'utente.
- **Condizioni di successo delle simulazioni**: gli schemi dei test di simulazione dell'agente aggiungono `success_conditions` facoltativo (array, fino a 30 elementi). Il campo legacy `success_condition` è deprecato a favore della forma array.
- **Limite di ripetizione dei test dell'agente**: [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) aumenta il valore massimo di `repeat_count` da 20 a 50.
- **Valori consentiti dinamici nello schema degli strumenti**: le proprietà dello schema JSON degli strumenti di ElevenAgents aggiungono `allowed_values_dynamic_variable` facoltativo (string) per le selezioni di valori LLM verificate dal server e provenienti da variabili dinamiche.
- **Documentazione URL firmato del widget**: [Ottieni widget](/docs/it/api-reference/widget/get) aggiorna la documentazione di `conversation_signature` con un riferimento a `/v1/convai/conversation/get_signed_url`.

### Musica

- **Formati di output di qualità superiore**: [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Trasmetti musica in streaming](/docs/it/api-reference/music/stream) aggiungono `mp3_48000_240` e `mp3_48000_320` ai valori `output_format` supportati. Quando `output_format` è `auto`, i modelli v2 ora usano per impostazione predefinita `mp3_48000_192` anziché `mp3_48000_128`.
- **Chiarimento del flag sulla durata delle sezioni**: `respect_sections_durations` si applica solo con `composition_plan` su `music_v1`. Su `music_v2`, le durate delle sezioni vengono sempre applicate e questo flag viene ignorato.
- **Suddivisione dello schema del piano di composizione**: il campo `composition_plan` della richiesta musicale usa un'unione `oneOf` di `MusicPrompt` e `CompositionPlan`. Il primo viene usato per i piani di composizione `music_v1`, il secondo per `music_v2`.

### Doppiaggio

- **Filtri dell'elenco progetti**: [Elenca i doppiaggi](/docs/it/api-reference/dubbing/list) aggiunge i parametri query array facoltativi `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources` per elenchi filtrati. Il parametro `order_by` ora accetta `name` oltre a `created_at`.

### Workspace

- **Motivi di blocco e disattivazione**: i modelli del workspace e della chiave API aggiungono `LockReason` e i campi facoltativi `disable_reason`. Le impostazioni dei gruppi del workspace aggiungono `scim_frozen` facoltativo (boolean) per lo stato di blocco gestito da SCIM.

### ElevenCreative Studio

- **Animazioni delle didascalie**: le enum delle animazioni di entrata e uscita delle didascalie di Studio aggiungono `pop`, `slide_up` e `slide_down`.

### Rilasci SDK

#### SDK JavaScript

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.54.0) - Rigenerato dallo schema OpenAPI più recente con supporto client per il rebase dei branch, filtri `conversation_product_type` e `termination_reasons` per l'elenco e la ricerca testuale delle conversazioni, filtri multivalore per l'elenco dei doppiaggi, tipi `output_format` specifici per la musica, impostazioni di rilevamento degli argomenti e rimozione dei tipi esportati relativi al coaching.
- [v2.53.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.1) - Ripristinati i valori facoltativi nei record `DynamicVariablesConfig` che erano stati erroneamente limitati in v2.53.0.

#### SDK Python

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.54.0) - Rigenerato dallo schema OpenAPI più recente con supporto client per il rebase dei branch, filtri per l'elenco e la ricerca testuale delle conversazioni, filtri multivalore per l'elenco dei doppiaggi, aggiornamenti del formato di output musicale, impostazioni di rilevamento degli argomenti e rimozione dei tipi esportati relativi al coaching. `ElevenLabs` e `AsyncElevenLabs` ora accettano il pass-through di `headers` e `follow_redirects` al client di base.

#### Pacchetti

- [@elevenlabs/client@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.0) - Aggiunto il supporto per `overrides.asr.keywords` nel client del browser, così da poter inviare il biasing delle parole chiave ASR per singola conversazione tramite `conversation_initiation_client_data`.
- [@elevenlabs/react@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.0) - Esposto `includeLanguageDetection` per le sessioni Scribe in tempo reale, incluso il supporto di React `useScribe` per richiedere e leggere i metadati della lingua rilevata.
- [@elevenlabs/react-native@1.2.9](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.9), [@elevenlabs/types@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.15.0), [@elevenlabs/convai-widget-core@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.4) e [@elevenlabs/convai-widget-embed@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.4) - Allineamento delle dipendenze a `@elevenlabs/client@1.12.0` e `@elevenlabs/types@0.15.0`.
- [@elevenlabs/client@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.1) - Esposto l'helper per il caricamento dei file dall'entrypoint interno di Unity.
- [@elevenlabs/react@1.7.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.1), [@elevenlabs/react-native@1.2.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.10), [@elevenlabs/convai-widget-core@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.5) e [@elevenlabs/convai-widget-embed@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.5) - Allineamento delle dipendenze a `@elevenlabs/client@1.12.1`.

#### Server MCP

- [v0.10.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.10.0) - Aggiunti il modello e gli endpoint Music v2, annotazioni degli strumenti MCP per tutti i 24 strumenti, supporto per Python 3.14, residenza dei dati a Singapore, alias abbreviati per la residenza UE/IN, gestione della chiusura graduale per le disconnessioni del client e correzioni per la creazione delle anteprime vocali e la risoluzione del path della directory di output.

### API

<Accordion title="Visualizza le modifiche API">

## Nuovi endpoint

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` - Esegue il rebase di un branch sull'ultima versione di main, mantenendo le modifiche specifiche del branch

## Endpoint aggiornati

### ElevenAgents

- [Elenca le conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Aggiunto il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`)
  - Aggiunto il parametro query facoltativo `termination_reasons` (array di stringhe)
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Aggiunto il parametro query facoltativo `conversation_product_type` (`agents` | `speech_engine`)
- [Ottieni widget](/docs/it/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget`
  - Aggiornata la documentazione di `conversation_signature` con un riferimento a `/v1/convai/conversation/get_signed_url`
- [Esegui test sull'agente](/docs/it/api-reference/tests/run-tests) - `POST /v1/convai/agents/{agent_id}/run-tests`
  - Aumentato il valore massimo di `repeat_count` da 20 a 50

### Doppiaggio

- [Elenca i doppiaggi](/docs/it/api-reference/dubbing/list) - `GET /v1/dubbing`
  - Aggiunti i parametri query facoltativi `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources`
  - `order_by` ora accetta `name` oltre a `created_at`

### Musica

- [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Trasmetti musica in streaming](/docs/it/api-reference/music/stream)
  - Aggiunti `mp3_48000_240` e `mp3_48000_320` ai valori `output_format` supportati
  - Il formato di output `auto` seleziona `mp3_48000_192` per i modelli v2 (in precedenza `mp3_48000_128`)

## Modifiche agli schemi

### ElevenAgents

- Branch e versioni degli agenti
  - Aggiunto `rebased_from_version_id` facoltativo nei modelli parent delle versioni dell'agente
- Configurazione della piattaforma e delle conversazioni
  - Aggiunto `topic_discovery` facoltativo (`TopicDiscoverySettings`) nei modelli di richiesta e risposta delle impostazioni della piattaforma
  - Aggiunto `background_sound` facoltativo (`BackgroundSoundConfig`)
- Configurazione di turni e timeout
  - Aggiunto `interruption_ignore_terms` facoltativo (array di stringhe) negli schemi di configurazione dei turni
  - Aggiunto `randomize_fillers` facoltativo (boolean) nella configurazione del soft timeout
- Trascrizioni e simulazioni
  - Aggiunto `user_identifier` facoltativo (string) nei messaggi utente delle trascrizioni
  - Aggiunto `success_conditions` facoltativo (array, massimo 30); `success_condition` deprecato
- Proprietà dello schema JSON degli strumenti
  - Aggiunto `allowed_values_dynamic_variable` facoltativo (string)

### Musica

- Piani di composizione
  - Il campo della richiesta `composition_plan` usa `oneOf` (`MusicPrompt` | `CompositionPlan`)
  - Chiarito il comportamento di `respect_sections_durations` per `music_v1` rispetto a `music_v2`

### Workspace

- Aggiunta l'enum `LockReason` e i campi facoltativi `disable_reason`
- Aggiunto `scim_frozen` facoltativo (boolean) nelle impostazioni dei gruppi del workspace

### ElevenCreative Studio

- Le enum delle animazioni delle didascalie aggiungono `pop`, `slide_up` e `slide_down`

## Schemi rimossi

### ElevenAgents

- Rimossi gli schemi delle impostazioni relativi al coaching (`CoachedAgentSettings`, `CoachingAgentSettings`, `NoCoachingSettings`)

</Accordion>