> 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 - **La pagina Utenti è ora generalmente disponibile**: La pagina [elenca utenti](/docs/it/api-reference/users/list), che raggruppa le conversazioni in base a un identificatore utente, è ora disponibile per tutti i workspace. Puoi così visualizzare in un'unica schermata tutti gli utenti che hanno interagito con i tuoi agenti, la cronologia delle loro conversazioni e i loro recapiti. - **Header SIP in entrata come variabili dinamiche**: Gli header SIP `X-` personalizzati delle chiamate SIP trunking in entrata vengono ora esposti automaticamente come variabili dinamiche nelle conversazioni ElevenAgents. Qualsiasi header SIP personalizzato (ad es. `X-Contact-ID`, `X-Campaign-ID`) passato dal chiamante è disponibile nel prompt dell'agente tramite `{{sip_contact_id}}`, `{{sip_campaign_id}}` ecc. Queste variabili sono visibili anche nella cronologia della conversazione nella scheda Chiamata telefonica. Gli header riservati come `X-Call-ID` e `X-Caller-ID` continuano a essere associati a `system__call_sid` e `system__caller_id` e non vengono sovrascritti. - **Filtro delle conversazioni in base all'esito dello strumento**: Gli endpoint [elenca conversazioni](/docs/it/api-reference/conversations/list) e [ricerca testuale nelle conversazioni](/docs/it/api-reference/conversations/messages/text-search) ora accettano i parametri query `tool_names_successful` e `tool_names_errored` (array di stringhe) per filtrare le conversazioni in base agli strumenti che hanno avuto esito positivo o restituito errori durante la chiamata. - **Miglioramenti all'elenco degli utenti**: L'endpoint [elenca utenti](/docs/it/api-reference/users/list) ora supporta un parametro query `sort_by` che accetta `last_contact_unix_secs` (predefinito) o `conversation_count`, e un parametro query `branch_id` per filtrare gli utenti in base al branch dell'agente. - **Eliminazione forzata degli strumenti**: L'endpoint [elimina strumento](/docs/it/api-reference/tools/delete) ora accetta un parametro query `force` (booleano, predefinito `false`). Se impostato su `true`, lo strumento viene eliminato anche se è usato dagli agenti e viene rimosso automaticamente da tutti gli agenti e i branch dipendenti. - **Conservazione degli embedding delle conversazioni**: La risposta di [impostazioni di ElevenAgents](/docs/it/api-reference/workspace/get) ora include `conversation_embedding_retention_days`, che controlla per quanto tempo vengono conservati gli embedding delle conversazioni (massimo 365 giorni). Un valore `null` utilizza il valore predefinito del sistema di 30 giorni. - **Guardrail della soglia dei contenuti**: Aggiunto lo schema `ContentThresholdGuardrail`, che fornisce un guardrail configurabile basato su soglia con un flag `is_enabled` e un valore `threshold` per la moderazione dei contenuti. ### Workspace - **Ottieni tutti i gruppi del workspace**: Il nuovo endpoint [GET /v1/workspace/groups](/docs/it/api-reference/workspace/groups/list) restituisce tutti i gruppi nel workspace, inclusi nome, ID, membri, autorizzazioni, limite di utilizzo e numero di caratteri di ciascun gruppo. - **Tipo di posto negli inviti in blocco al workspace**: L'endpoint [invita più utenti](/docs/it/api-reference/workspace/invites/create-batch) ora accetta un campo facoltativo `seat_type` per specificare il tipo di posto (ad es. `workspace_member`, `workspace_admin`) per tutti gli utenti invitati in un'operazione in blocco. - **Miglioramenti dell'affidabilità SSO su mobile**: Risolta una regressione per cui l'accesso SSO su mobile rimaneva bloccato su "Authenticating..." dopo che un utente aveva effettuato il logout e tentava di accedere di nuovo. Risolto anche il cambio di workspace per gli utenti SSO su mobile che accedono tramite provider SAML o OIDC. ### Musica - **Controllo della durata delle sezioni**: L'endpoint [genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) ora supporta `respect_sections_durations` (booleano), che controlla se il modello rispetta la durata specificata per ogni sezione nel piano di composizione. ### ElevenCreative Studio - **Indicatore di contenuti visivi del capitolo**: I modelli di risposta dei capitoli ora includono un campo booleano `has_visual_content` che indica se il capitolo contiene contenuti visivi. - **Stili di ombreggiatura e contorno del testo**: Lo stile del testo in ElevenCreative Studio ora supporta le opzioni `text_shadow` e `text_outline` tramite i nuovi schemi `StudioTextStyleShadowModel` e `StudioTextStyleOutlineModel`, consentendo una personalizzazione visiva del testo più ricca nei progetti ElevenCreative Studio. - **Tipo di attività clip per la generazione di media**: L'enum `PendingClipTask.type` ora include il valore `media_generation`, ampliando la categorizzazione delle attività clip per includere i workflow di generazione di media. ### Release degli SDK #### SDK Python - [v2.39.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.0) - Aggiunto il supporto per il tipo di evento WebSocket `multimodal_message` nelle conversazioni in tempo reale di ElevenAgents. - [v2.39.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.1) - Rigenerazione di Fern per allinearsi all'ultimo schema API. #### SDK JavaScript - [v2.39.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.39.0) - Rigenerazione di Fern per allinearsi all'ultimo schema API. #### SDK iOS - [v3.1.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.0) - Vari miglioramenti all'SDK Swift di ElevenAgents: - Gli errori del server vengono ora segnalati tramite il callback `onError`, rendendo la gestione degli errori più coerente. - Aggiunta la gestione dello stato dell'agente basata sugli eventi per un'osservazione dello stato più chiara. - Ora è supportato il silenziamento software insieme al rilevamento vocale, per un controllo dell'audio più granulare. - Migliorato il codebase per usare Swift Concurrency ovunque. - Risolto un crash che si verificava all'avvio nelle build di release iOS. - Aggiornato il branding per riflettere il rebranding di ElevenAgents. #### Pacchetti - [@elevenlabs/client@0.15.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.1) - Aggiunto il ricampionamento dell'audio in uscita quando non è possibile ottenere dal sistema la frequenza di campionamento richiesta, migliorando la compatibilità tra dispositivi. - [@elevenlabs/react@0.14.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.2) - Aggiornato per dipendere da `@elevenlabs/client@0.15.1`. - [@elevenlabs/convai-widget-core@0.10.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.3) - Aggiornato per dipendere da `@elevenlabs/client@0.15.1`. ### API ## Nuovi endpoint - [Ottieni tutti i gruppi del workspace](/docs/it/api-reference/workspace/groups/list) - `GET /v1/workspace/groups` - Restituisce tutti i gruppi nel workspace con membri, autorizzazioni e limiti di utilizzo. ## Endpoint aggiornati ### ElevenAgents - [Elenca conversazioni](/docs/it/api-reference/conversations/list) - Aggiunto il parametro query `tool_names_successful` (array di stringhe, facoltativo) per filtrare le conversazioni in cui gli strumenti specificati hanno effettuato chiamate riuscite - Aggiunto il parametro query `tool_names_errored` (array di stringhe, facoltativo) per filtrare le conversazioni in cui gli strumenti specificati hanno restituito errori - [Ricerca testuale nelle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - Aggiunto il parametro query `tool_names_successful` (array di stringhe, facoltativo) - Aggiunto il parametro query `tool_names_errored` (array di stringhe, facoltativo) - [Elenca utenti](/docs/it/api-reference/users/list) - Aggiunto il parametro query `sort_by` (stringa, facoltativo) che accetta `last_contact_unix_secs` (predefinito) o `conversation_count` - Aggiunto il parametro query `branch_id` (stringa, facoltativo) per filtrare gli utenti in base al branch dell'agente - [Elimina strumento](/docs/it/api-reference/tools/delete) - Aggiunto il parametro query `force` (booleano, facoltativo, predefinito `false`) per eliminare uno strumento indipendentemente dalle dipendenze degli agenti, rimuovendolo automaticamente da tutti gli agenti e i branch dipendenti - [Ottieni impostazioni di ElevenAgents](/docs/it/api-reference/workspace/get), [Aggiorna impostazioni di ElevenAgents](/docs/it/api-reference/workspace/update) - Aggiunto il campo `conversation_embedding_retention_days` (intero, facoltativo, massimo 365) per configurare per quanto tempo vengono conservati gli embedding delle conversazioni ### Workspace - [Invita più utenti](/docs/it/api-reference/workspace/invites/create-batch) - Aggiunto il campo `seat_type` (stringa, facoltativo) per specificare il tipo di posto per tutti gli utenti invitati ### Musica - [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) - Aggiunto il campo `respect_sections_durations` (booleano, facoltativo) per controllare se il modello rispetta le durate per sezione nel piano di composizione ### ElevenCreative Studio - [Ottieni capitolo](/docs/it/api-reference/studio/get-chapter), [Aggiungi capitolo](/docs/it/api-reference/studio/add-chapter), [Aggiorna capitolo](/docs/it/api-reference/studio/update-chapter) - Aggiunto il campo `has_visual_content` (booleano) ai modelli di risposta dei capitoli ## Modifiche agli schemi ### Nuovi schemi - `ContentThresholdGuardrail` - Guardrail dei contenuti basato su soglia con i campi `is_enabled` (booleano) e `threshold` (numero, predefinito `0.3`) - `AgentPromptChangeToolConfig` - Configurazione dello strumento di sistema per modifiche dinamiche al prompt dell'agente - `StudioTextStyleShadowModel` - Stile dell'ombreggiatura del testo per ElevenCreative Studio - `StudioTextStyleOutlineModel` - Stile del contorno del testo per ElevenCreative Studio - `UsersSortBy` - Enum per le opzioni di ordinamento dell'elenco degli utenti: `last_contact_unix_secs`, `conversation_count` - `VideoAnalysis`, `VideoAnalysisResult`, `VideoKeyMoment`, `VideoSegment`, `VideoSubject`, `VideoTranscription`, `VideoTranscriptionWord` - Schemi dei risultati dell'analisi video per l'elaborazione delle clip ### Schemi modificati - `ConversationHistorySIPTrunkingPhoneCallModel` - Aggiunto il campo `sip_header_dynamic_variables` per gli header X- personalizzati SIP in entrata - `PendingClipTask` - Aggiunto `media_generation` all'enum `type`