> 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.
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### CLI di ElevenLabs
La [CLI di ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) è ora disponibile. Ogni operazione dell'API di ElevenLabs è disponibile come sottocomando, con output JSON, tabella, YAML e CSV, paginazione automatica e completamento della shell.
La CLI offre anche workflow di configurazione locale per ElevenAgents. Archivia le configurazioni di agenti, strumenti e test come file, sincronizzale con i comandi push e pull, gestisci i branch, esegui test, installa componenti dell'interfaccia utente di ElevenLabs e seleziona una regione di residenza dei dati.
Installa la CLI, autentica l'accesso e gestisci gli agenti come codice.
### Procedure
Le procedure sono ora generalmente disponibili in ElevenAgents. Una procedura contiene istruzioni specifiche per un'attività e un trigger che determina quando applicarle. Durante una conversazione, l'agente carica la procedura pertinente, consentendo a un unico agente di gestire attività distinte senza inserire ogni istruzione nel relativo system prompt.
Usa procedure in formato libero quando l'agente può adattare la formulazione o l'ordine delle istruzioni. Usa procedure strutturate quando i passaggi devono essere eseguiti in un ordine definito. Entrambi i tipi possono essere usati insieme ai workflow sullo stesso agente.
Scopri quando usare le procedure e come si confrontano con prompt e workflow.
Scrivi istruzioni in linguaggio naturale che l'agente può adattare alla conversazione.
Definisci passaggi tipizzati che l'agente segue in un ordine coerente.
### ElevenAgents
- **Ticket di triage delle conversazioni**: aggiunte API per creare ticket sul rendimento degli agenti, creare ticket manuali di follow-up, elencare i ticket, assegnare membri del workspace, aggiornare stato e assegnatario e aggiungere commenti a livello di ticket o di turno.
- **Osservabilità delle conversazioni**: i client realtime possono ricevere un evento `context_usage` dopo ogni turno dell'agente completato. L'evento riporta il modello, il numero di token del prompt e il limite di contesto del modello.
### Release degli SDK
#### SDK JavaScript
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Aggiunti client e tipi per i ticket di triage delle conversazioni e i riepiloghi leggeri delle conversazioni. Le API delle conversazioni aggiungono filtri per procedura, chiamata di strumento non valida e ordinamento; le API delle procedure aggiungono la selezione della versione dell'agente; le API degli argomenti aggiungono controlli sui dettagli della valutazione e l'ordinamento per frustrazione. La release aggiunge anche la frequenza di aggiornamento della knowledge base, l'ambiente di test e i campi di integrazione degli avvisi, oltre ai tipi di messaggio per il doppiaggio realtime.
#### SDK Python
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Aggiunti client e tipi per i ticket di triage delle conversazioni e i riepiloghi leggeri delle conversazioni. Le API delle conversazioni aggiungono filtri per procedura, chiamata di strumento non valida e ordinamento; le API delle procedure aggiungono la selezione della versione dell'agente; le API degli argomenti aggiungono controlli sui dettagli della valutazione e l'ordinamento per frustrazione. La release aggiunge anche la frequenza di aggiornamento della knowledge base, l'ambiente di test e i campi di integrazione degli avvisi, e preserva i campi multipart ripetuti per `keyterms` di Speech to Text e `webhook_ids` di Dubbing.
#### SDK Swift
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Aggiunti il parsing tipizzato degli errori del client, la gestione di `expects_response` e risultati degli strumenti type-safe. L'avvio di WebRTC è ora pronto quando l'agente si unisce, invece di attendere la sottoscrizione della traccia audio. La release migliora inoltre la gestione degli URL, sopprime il rumore degli eventi sconosciuti e rimuove l'allocazione del thread realtime dall'elaborazione del silenziamento software.
#### Pacchetti
- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) e [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - L'acquisizione dell'output WebRTC usa ora path AudioWorklet self-hosted con policy di sicurezza dei contenuti rigorose. La cache dei worklet include la sorgente richiesta, impedendo che un precedente URL inline sostituisca un path self-hosted. Gli errori di configurazione di React Native ora rimandano a `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) e [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Aggiunto `webRtc.iceTransportPolicy` opzionale. Impostalo su `relay` per limitare i candidati ICE WebRTC ai relay TURN nelle reti che bloccano il traffico UDP diretto.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) e [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Aggiunti il callback `onContextUsage` e il tipo `ContextUsageEvent`. React espone il callback tramite `useConversation`. React Native ora effettua la risoluzione tramite la condizione di export del pacchetto anziché tramite il rilevamento delle variabili globali del browser.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) e [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Aggiunti contenuti avanzati nel primo messaggio con risposte ai pulsanti attribuite, `onExternalAgentDisconnected` e `onMCPToolApprovalRequest`. WebRTC ora usa il dispositivo di input selezionato, mantiene lo stato di silenziamento quando cambi microfono e non completa la configurazione se non è possibile inviare i dati di avvio. Il widget aggiunge lo stato della coda di concorrenza, la selezione opzionale della lingua nel trigger compresso e il rendering del primo messaggio per gli agenti che supportano sia testo sia voce.
### API
## Nuovi endpoint
### ElevenAgents
- Aggiunti nove endpoint per i ticket di triage delle conversazioni:
- [Crea ticket di conversazione](/docs/it/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. La richiesta richiede `conversation_id` (stringa) e accetta `qa_comment` (stringa nullable, 1–10.000 caratteri) e fino a 200 commenti sui turni.
- [Elenca ticket](/docs/it/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, con paginazione tramite cursore.
- [Crea ticket manuale](/docs/it/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. La richiesta richiede `qa_comment` (stringa, 1–10.000 caratteri).
- [Elenca utenti assegnabili](/docs/it/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. La risposta elenca i membri del workspace che non sono account di servizio e indica se ciascun membro ha accesso all'agente.
- [Ottieni ticket](/docs/it/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Aggiorna ticket](/docs/it/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. La richiesta accetta `status` facoltativo e `assignee_user_id` nullable.
- [Elimina ticket](/docs/it/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Aggiungi commento](/docs/it/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. La richiesta richiede `comment` (stringa, 1–10.000 caratteri).
- [Aggiungi commento al turno](/docs/it/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. La richiesta richiede `turn_index` con indice a base zero (intero) e `comment` (stringa, 1–10.000 caratteri).
## Endpoint aggiornati
### ElevenAgents
- [Ottieni URL firmato](/docs/it/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Aggiunto `debug_events_request` facoltativo (booleano, valore predefinito `false`). Gli eventi di debug richiedono l'accesso editor all'agente.
- [Ottieni token WebRTC](/docs/it/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Aggiunto `debug_events_request` facoltativo (booleano, valore predefinito `false`). Il percorso legacy `GET /v1/convai/conversation/get_signed_url` accetta lo stesso parametro.
- [Elenca conversazioni](/docs/it/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Aggiunto `triggered_procedure_ids` facoltativo (array di stringhe nullable, massimo 50) per trovare le conversazioni in cui è stata eseguita una qualsiasi procedura specificata.
- Aggiunto `include_invalid_tool_calls` facoltativo (booleano, valore predefinito `false`) per includere le chiamate di strumenti che non sono state eseguite.
- Aggiunto `sort_direction` facoltativo (`asc` o `desc`, valore predefinito `desc`) per l'ora di inizio della chiamata.
- [Ricerca testuale nei messaggi delle conversazioni](/docs/it/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Aggiunto `triggered_procedure_ids` facoltativo (array di stringhe nullable, massimo 50).
- Aggiunto `include_invalid_tool_calls` facoltativo (booleano, valore predefinito `false`).
- [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Aggiunto `include_evaluation_criteria` facoltativo (booleano, valore predefinito `true`).
- Aggiunto `frustration` a `sort_by`.
- Le risposte degli argomenti aggiungono `success_rate` nullable (numero), mentre la risposta complessiva aggiunge `aggregated_run_count` (intero, valore predefinito `0`).
- `from_unix_secs` viene arrotondato per difetto all'inizio del relativo giorno UTC. Un intervallo delimitato aggrega le esecuzioni di rilevamento giornaliere completate; omettendo entrambi i limiti viene restituita l'esecuzione più recente.
- [Elenca procedure](/docs/it/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) e [Ottieni procedura](/docs/it/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Aggiunto `agent_version_id` facoltativo nullable (stringa) per recuperare procedure da una versione specifica dell'agente.
- [Crea test](/docs/it/api-reference/tests/create) e [Aggiorna test](/docs/it/api-reference/tests/update)
- Aggiunto `environment` facoltativo nullable (stringa) agli schemi di test unitari di risposta, simulazione e chiamata di strumento. Il valore seleziona URL, header e connessioni di autenticazione specifici dell'ambiente; il valore predefinito è `production`.
- [Crea documento da URL](/docs/it/api-reference/knowledge-base/create-from-url), [Crea job di crawling](/docs/it/api-reference/knowledge-base/create-crawl-job) e [Crea cartella](/docs/it/api-reference/knowledge-base/create-folder)
- Aggiunto `minimum_frequency_days` facoltativo nullable (intero, 1–180) per la sincronizzazione automatica. Il valore predefinito è `7` e ha la precedenza una frequenza più rigorosa della cartella principale.
### Musica
- [Elenca Finetune musicali](/docs/it/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Aumentato il valore massimo di `page_size` da 100 a 150. Il valore predefinito rimane 50.
## Modifiche allo schema
### ElevenAgents
- Le richieste di aggiornamento degli agenti aggiungono `procedures` facoltativo nullable (`object`). Ogni valore richiede `procedure_id` e `version_id` (stringhe). Un oggetto vuoto rimuove tutte le procedure.
- La configurazione di avvio della conversazione aggiunge `enable_procedure_ids_from_client` (booleano, valore predefinito `false`). I dati di avvio aggiungono `procedure_ids` facoltativo nullable (array di stringhe); un array vuoto disabilita tutte le procedure per l'agente iniziale.
- `ClientEvent` aggiunge `context_usage`.
- Gli override del soft timeout aggiungono `additional_soft_timeout_messages` facoltativo nullable (array di stringhe).
- I valori costanti nei modelli di override dell'analisi e dello schema ora accettano `null`.
- I valori predefiniti della configurazione del widget per `mic_muting_enabled` e `transcript_enabled` sono cambiati da `false` a `true`. Impostali esplicitamente su `false` per mantenere il comportamento precedente.
### Workspace
- Le risposte di [Ottieni utente](/docs/it/api-reference/user/get) hanno rimosso `xi_api_key` da `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` ora accetta ID di ruolo personalizzati come chiavi, anziché limitare le chiavi a `admin`, `editor`, `commenter` e `viewer`.
- Le risposte di pubblicazione diretta aggiungono `restricted_to_user_email_domains` facoltativo nullable (array di stringhe).
- Le risposte al cambio di abbonamento in attesa aggiungono `go` a `next_tier`.