> 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 - **Le procedure strutturate vengono compilate al salvataggio e alla pubblicazione**: [Aggiorna agente](/docs/it/api-reference/agents/update) e [Crea bozza di agente](/docs/it/api-reference/agents/drafts/create) ora compilano e convalidano automaticamente le [procedure strutturate](/docs/it/eleven-agents/customization/procedures/structured-procedures). Le integrazioni non devono più chiamare l'endpoint di compilazione né aggiornare manualmente il workflow generato. Le procedure non valide restituiscono errori per singola procedura come `400 procedure_validation_failed`. Gli agenti senza procedure strutturate non sono interessati. - **L'endpoint di compilazione delle procedure è legacy**: [Compila procedure](/docs/it/api-reference/agents/procedures/compile) è contrassegnato come legacy e non deve essere usato dalle nuove integrazioni. Rimane disponibile per i chiamanti esistenti. - **Proposte di merge**: le proposte di merge sono disponibili in alpha. I team possono aprire una proposta per un branch di agente, esaminare le modifiche alla configurazione e i risultati dei test, lasciare commenti o decisioni di approvazione e unire le modifiche approvate in un branch di destinazione. Consulta [Proposte di merge](/docs/it/eleven-agents/operate/merge-proposals). ### Rilasci SDK #### SDK JavaScript - [v2.71.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.71.0) - Aggiunti client per le proposte di merge degli agenti, la cronologia dei deployment, l'annullamento delle invocazioni di test e la duplicazione di Speech Engine. La release aggiunge inoltre priorità e ordinamento dei ticket di triage, limiti di esportazione delle chiamate batch, `gpt-6.1-sol`, `claude-sonnet-5-5`, modelli vocali per agenti Eleven v4 e tipi di configurazione correnti degli agenti. #### SDK Python - [v2.71.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.71.0) - Aggiunti client per le proposte di merge degli agenti, la cronologia dei deployment, l'annullamento delle invocazioni di test e la duplicazione di Speech Engine. La release aggiunge inoltre priorità e ordinamento dei ticket di triage, limiti di esportazione delle chiamate batch, `gpt-6.1-sol`, `claude-sonnet-5-5`, modelli vocali per agenti Eleven v4 e tipi di configurazione correnti degli agenti. #### SDK Swift - [v3.4.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.4.0) - Le variabili dinamiche ora preservano i tipi JSON nativi quando vengono inviate nei dati di avvio della conversazione. #### Pacchetti - [@elevenlabs/client@1.26.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.26.0), [@elevenlabs/react@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.16.0), [@elevenlabs/react-native@1.2.28](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.28) e [@elevenlabs/types@0.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.24.0) - Aggiunta la modifica delle trascrizioni Speech to Text in tempo reale tramite `transcriptEdit`, l'evento `edited_transcript` e il callback React `onEditedTranscript`. React ora inoltra `filterBackgroundAudio` alle sessioni in tempo reale. Il client esporta inoltre `MessagePayload` e usa ID risposta stabili per evitare risposte duplicate degli agenti. - [@elevenlabs/convai-widget-core@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.3) e [@elevenlabs/convai-widget-embed@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.3) - Aggiunte anteprime delle immagini e link per il download degli allegati ai messaggi degli agenti, incluse le risposte contenenti solo allegati. Gli ID risposta stabili evitano risposte duplicate e le conversazioni solo testuali ora usano un controllo di arresto con un tooltip **Termina chat**. ### API ## Nuovi endpoint ### ElevenAgents - [Crea una proposta di merge](/docs/it/api-reference/agents/merge-proposals/create) - `POST /v1/convai/agents/{agent_id}/merge-proposals` - Crea una proposta con i campi obbligatori `source_branch_id`, `target_branch_id` e `title`, oltre a una descrizione facoltativa, ID revisori e ID ticket di triage. - [Elenca proposte di merge](/docs/it/api-reference/agents/merge-proposals/list) - `GET /v1/convai/agents/{agent_id}/merge-proposals` - Elenca le proposte con filtri per stato, branch di origine, branch di destinazione e testo, oltre alla paginazione tramite cursore. - [Ottieni una proposta di merge](/docs/it/api-reference/agents/merge-proposals/get) - `GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Recupera una proposta e i dettagli relativi a revisione, commenti ed esito. - [Aggiorna una proposta di merge](/docs/it/api-reference/agents/merge-proposals/update) - `PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Aggiorna titolo, descrizione o revisori richiesti, oppure chiudila senza eseguire il merge. - [Esamina una proposta di merge](/docs/it/api-reference/agents/merge-proposals/submit-review) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews` - Invia una decisione `approved` o `changes_requested` con un commento facoltativo. - [Commenta una proposta di merge](/docs/it/api-reference/agents/merge-proposals/add-comment) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments` - Aggiungi un commento Markdown fino a 4.096 caratteri. - [Unisci una proposta di merge](/docs/it/api-reference/agents/merge-proposals/merge) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge` - Unisci il branch di origine e controlla facoltativamente la risoluzione forzata dei conflitti e l'archiviazione del branch di origine. - [Elenca deployment degli agenti](/docs/it/api-reference/agents/deployments/list) - `GET /v1/convai/agents/{agent_id}/deployments` - Elenca le suddivisioni del traffico correnti e cronologiche dei branch con paginazione basata sulle pagine. - [Annulla un'invocazione di test](/docs/it/api-reference/tests/test-invocations/cancel) - `POST /v1/convai/test-invocations/{test_invocation_id}/cancel` - Annulla un'invocazione di test in esecuzione. ### Speech Engine - [Duplica uno Speech Engine](/docs/it/api-reference/speech-engine/duplicate) - `POST /v1/speech-engine/{speech_engine_id}/duplicate` - Duplica uno Speech Engine e assegna facoltativamente alla copia un nuovo `name`. ## Endpoint aggiornati ### ElevenAgents - [Crea agente](/docs/it/api-reference/agents/create), [Ottieni agente](/docs/it/api-reference/agents/get) e [Aggiorna agente](/docs/it/api-reference/agents/update) - Aggiunti `gpt-6.1-sol` e `claude-sonnet-5-5` all'enum `LLM`. - Aggiunti `eleven_v4` e `eleven_v4_turbo` alle opzioni del modello TTS conversazionale. Il valore predefinito è passato da `eleven_flash_v2` a `eleven_v4_turbo`. - I trasferimenti degli agenti e i nodi degli agenti workflow autonomi aggiungono `preserve_voice_settings` facoltativo (booleano, valore predefinito `false`) per mantenere la voce di base, il modello TTS e le impostazioni vocali dopo un trasferimento. - Le configurazioni dello strumento per saltare il turno aggiungono `wait_timeout_secs` facoltativo (numero, valore predefinito `-1`). Il valore `-1` mantiene l'agente in silenzio finché il chiamante non parla. - Le configurazioni webhook post-chiamata aggiungono `exclude_transcript` facoltativo (booleano, valore predefinito `false`) per omettere le trascrizioni turno per turno dai webhook di trascrizione JSON. - Le configurazioni di redazione della cronologia delle conversazioni aggiungono `excluded_data_collection_ids` facoltativo (array di stringhe, massimo 50) per mantenere i valori estratti selezionati mentre vengono oscurate le relative motivazioni. - `response_timeout_secs` dello strumento client ora accetta `-1` per attendere indefinitamente quando `expects_response` è abilitato. - [Elenca ticket](/docs/it/api-reference/triage-tickets/list) - Aggiunto `priorities` facoltativo (array) con valori `low`, `medium`, `high` e `urgent`. - Aggiunto `sort_by` con valori `created_at` e `priority`; il valore predefinito è `created_at`. - Le risposte dei ticket ora richiedono `title`, `priority` nullable e un array `priority_changes`. Le richieste di creazione e aggiornamento dei ticket possono impostare `priority` e lo stato del ticket aggiunge `cancelled`. - [Elenca strumenti](/docs/it/api-reference/tools/list) - Aggiunto `used_by_agent_id` facoltativo e nullable (stringa) per restituire gli strumenti a cui fa riferimento il branch principale di un agente. - [Esporta risultati delle chiamate batch](/docs/it/api-reference/batch-calling/export) - Aggiunto `limit` facoltativo e nullable (intero, minimo `1`) per esportare solo i primi destinatari come anteprima di colonna. - [Elenca invocazioni di test](/docs/it/api-reference/tests/test-invocations/list) e [Ottieni invocazione di test](/docs/it/api-reference/tests/test-invocations/get) - I riepiloghi delle invocazioni di test aggiungono `cancelled_count` obbligatorio (intero) e `cancelled` facoltativo (booleano, valore predefinito `false`). - Lo stato dell'esecuzione di test aggiunge `cancelled`. - [Ottieni dettagli della conversazione](/docs/it/api-reference/conversations/get) - Le voci della trascrizione aggiungono `platform_event` facoltativo e nullable con valori `user_turn_timeout` e `skip_turn_wait_elapsed`. - [Ottieni metadati della versione dell'agente](/docs/it/api-reference/agents/versions/get) - Aggiunto `merged_authors` facoltativo e nullable, un array che descrive le persone che hanno pubblicato modifiche unite nel branch principale. - [Ottieni job di crawling](/docs/it/api-reference/knowledge-base/get-crawl-job) - Rimosso il campo di risposta deprecato `max_depth`.