> 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

- **Endpoint per gli utenti delle conversazioni**: aggiunto l'endpoint [Ottieni utenti delle conversazioni](/docs/it/api-reference/users/list) (`GET /v1/convai/users`) per elencare gli utenti che hanno avuto conversazioni con i tuoi agenti. Supporta la paginazione e il filtro per agente, intervallo di tempo e altri criteri.
- **Versionamento degli agenti**: recupera configurazioni specifiche degli agenti per versione usando i nuovi parametri query `version_id` e `branch_id` nell'endpoint [Ottieni agente](/docs/it/api-reference/agents/get). L'endpoint [Aggiorna agente](/docs/it/api-reference/agents/update) ora accetta anche un parametro `branch_id` per aggiornamenti specifici del branch.
- **Strumento per cercare nella documentazione**: aggiunto `search_documentation` come nuovo strumento di sistema integrato per RAG (generazione aumentata dal recupero). Configura il recupero da più fonti con gli schemi `MultiSourceConfigJson`, `SourceConfigJson` e `SourceRetrievalConfig`. Supporta strategie di unione configurabili tramite l'enum `MergingStrategy`.
- **Supporto per strumenti MCP**: aggiunto `mcp` come nuovo tipo di strumento insieme agli strumenti webhook, client e di sistema. Configura gli strumenti MCP usando il nuovo schema `MCPToolConfig` nelle definizioni degli strumenti dell'agente.
- **Guardrail dei contenuti**: aggiunti guardrail per la moderazione dei contenuti a `GuardrailsV1` con soglie configurabili per diverse categorie di contenuti: sessuale, violenza, molestie, autolesionismo, linguaggio volgare, religione/politica e contenuti medici/legali. Usa i nuovi schemi `ContentGuardrail` e `ContentConfig`.
- **Modalità espressiva**: aggiunto il campo `expressive_mode` (booleano) agli schemi di configurazione dell'agente per suggerire automaticamente al tuo agente di sfruttare al meglio il nuovo modello conversazionale v3.
- **Cifre post-selezione**: i trasferimenti di numero di telefono ora supportano `post_dial_digits` per inviare toni DTMF dopo la connessione. Configurabili come valori statici o variabili dinamiche.
- **Tipi di test degli agenti**: i test degli agenti ora supportano tre tipi di test distinti con schemi dedicati: `llm` (valutazione della risposta), `tool` (verifica della chiamata dello strumento) e `simulation` (simulazione completa della conversazione). I test di simulazione includono i campi di configurazione `simulation_scenario` e `simulation_max_turns`.

### Dizionari di pronuncia

- **Regole nella risposta API**: l'endpoint [Ottieni dizionario di pronuncia](/docs/it/api-reference/pronunciation-dictionaries/get) ora restituisce un array `rules` contenente tutti i dettagli delle regole. La risposta usa il nuovo schema `GetPronunciationDictionaryWithRulesResponseModel` con `PronunciationDictionaryAliasRuleResponseModel` e `PronunciationDictionaryPhonemeRuleResponseModel` per i tipi di regole.

### Knowledge Base

- **Eliminazione delle cartelle**: l'endpoint [Elimina documento della knowledge base](/docs/it/api-reference/knowledge-base/delete) ora supporta l'eliminazione delle cartelle oltre ai documenti. Quando elimini cartelle, imposta `force=true` per abilitare l'eliminazione ricorsiva di tutti i documenti e le sottocartelle contenuti.

### Rilasci SDK

#### SDK Python

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.36.0) - Aggiunti l'endpoint per gli utenti delle conversazioni, il versionamento degli agenti, lo strumento per cercare nella documentazione, il supporto per gli strumenti MCP, i guardrail dei contenuti e i tipi di test degli agenti

#### SDK JavaScript

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.36.0) - Aggiunte firme `convert` sovraccariche a `speechToText.convert()` per una migliore inferenza dei tipi in base ai parametri della richiesta (accedi a `.text`, `.transcripts` o ai campi webhook senza restringere manualmente il tipo), aggiunti l'endpoint per gli utenti delle conversazioni, il versionamento degli agenti, lo strumento per cercare nella documentazione, il supporto per gli strumenti MCP, i guardrail dei contenuti e i tipi di test degli agenti

#### Pacchetti widget

- [@elevenlabs/convai-widget-core@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.9.0) - Aggiunti la visualizzazione dello stato di utilizzo degli strumenti dell'agente e un nuovo badge di stato per le chiamate di strumenti di lunga durata, corretta la rimozione dei tag di emozione, corretto l'invio di valutazioni e feedback per l'incorporamento del widget tramite URL firmato
- [@elevenlabs/convai-widget-embed@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.9.0) - Aggiunti la visualizzazione dello stato di utilizzo degli strumenti dell'agente e un nuovo badge di stato per le chiamate di strumenti di lunga durata, corretta la rimozione dei tag di emozione

### API

<Accordion title="Visualizza modifiche API">

## Nuovi endpoint

- [Ottieni utenti delle conversazioni](/docs/it/api-reference/users/list) - `GET /v1/convai/users` - Elenca gli utenti che hanno avuto conversazioni con i tuoi agenti

## Endpoint aggiornati

### ElevenAgents

- [Ottieni agente](/docs/it/api-reference/agents/get)
  - Aggiunto il parametro query `version_id` (stringa, facoltativo) per recuperare una versione specifica dell'agente
  - Aggiunto il parametro query `branch_id` (stringa, facoltativo) per recuperare da un branch specifico
- [Aggiorna agente](/docs/it/api-reference/agents/update)
  - Aggiunto il parametro query `branch_id` (stringa, facoltativo) per aggiornamenti specifici del branch
- [Crea agente](/docs/it/api-reference/agents/create)
  - Aggiunto `search_documentation` agli strumenti di sistema con configurazione RAG da più fonti
  - Aggiunto il tipo di strumento `mcp` al discriminatore degli strumenti
  - Aggiunto il campo `content` a `GuardrailsV1` per i guardrail di moderazione dei contenuti
  - Aggiunto il campo `expressive_mode` (booleano) alla configurazione dell'agente
- [Crea test agente](/docs/it/api-reference/tests/create), [Aggiorna test agente](/docs/it/api-reference/tests/update), [Ottieni test agente](/docs/it/api-reference/tests/get)
  - Modificati in schemi union discriminati con campo `type` (`llm`, `tool`, `simulation`)
  - Aggiunti i campi `simulation_scenario` e `simulation_max_turns` per i test di simulazione

### Dizionari di pronuncia

- [Ottieni dizionario di pronuncia](/docs/it/api-reference/pronunciation-dictionaries/get)
  - Schema di risposta modificato in `GetPronunciationDictionaryWithRulesResponseModel` con array `rules`

### Knowledge Base

- [Elimina documento della knowledge base](/docs/it/api-reference/knowledge-base/delete)
  - Aggiornata la descrizione del parametro `force` per includere l'eliminazione delle cartelle con comportamento ricorsivo

## Modifiche agli schemi

### Nuovi schemi

- `GetPronunciationDictionaryWithRulesResponseModel` - Modello di risposta con array di regole incorporato
- `PronunciationDictionaryAliasRuleResponseModel` - Regola alias con `string_to_replace` e `alias`
- `PronunciationDictionaryPhonemeRuleResponseModel` - Regola fonema con `string_to_replace`, `phoneme` e `alphabet`
- `MultiSourceConfigJson` - Configurazione RAG da più fonti
- `SourceConfigJson` - Configurazione di una singola fonte per RAG
- `SourceRetrievalConfig` - Configurazione del recupero per fonti RAG
- `MergingStrategy` - Enum per le strategie di unione dei risultati RAG
- `MCPToolConfig` - Configurazione per gli strumenti MCP
- `ContentGuardrail-Input`, `ContentGuardrail-Output` - Configurazione dei guardrail per la moderazione dei contenuti
- `ContentConfig` - Configurazione delle soglie per categoria di contenuti
- `TestType` - Enum con valori `llm`, `tool`, `simulation`
- `CreateAgentTestResponseModel` - Risposta per la creazione di test
- `LLMResponseTest*`, `ToolCallTest*`, `SimulationTest*` - Schemi di test per tipo che sostituiscono i modelli legacy `Create/Get/UpdateUnitTest*`

### Schemi modificati

- `GuardrailsV1-Input`, `GuardrailsV1-Output` - Aggiunto il campo `content` per i guardrail dei contenuti
- `AgentConfig` - Aggiunto il campo `expressive_mode` (booleano)
- `PhoneNumberTransferConfig` - Aggiunto il campo `post_dial_digits` (stringa o variabile dinamica)
- `DistributionTerritories` - Vincolo sugli elementi allentato per consentire stringhe di territorio arbitrarie

</Accordion>