> 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. ### Piattaforma Agents - **Branch e deployment degli agenti**: aggiunto un sistema completo di controllo delle versioni per gli agenti, che consente ai team di creare branch, iterare sulle configurazioni degli agenti in isolamento e unire le modifiche quando sono pronte. I nuovi endpoint includono `POST /v1/convai/agents/{agent_id}/branches` per creare branch, `POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge` per unirli e `POST /v1/convai/agents/{agent_id}/deployments` per creare deployment. È inoltre possibile creare ed eliminare bozze tramite i nuovi endpoint delle bozze. Per i dettagli, consulta la documentazione su [Branch](/docs/it/api-reference/agents/branches/list) e [Deployment](/docs/it/api-reference/agents/deployments/create). - **Gestione degli account WhatsApp**: aggiunti gli endpoint `PATCH` e `DELETE` per gli account WhatsApp Business, che ti consentono di aggiornare e rimuovere dagli agenti gli account WhatsApp connessi. - **Nome dell'agente nella conversazione**: l'endpoint [Ottieni conversazione](/docs/it/api-reference/conversations/get) ora restituisce `agent_name` nella risposta, per identificare più facilmente l'agente che ha gestito una conversazione. - **Monitoraggio del tipo di errore**: aggiunto il campo `error_type` ai modelli degli eventi di conversazione per migliorare il debug e la categorizzazione degli errori. ### Knowledge Base - **Gestione delle cartelle**: aggiunto il supporto per organizzare i documenti della knowledge base in cartelle. I nuovi endpoint includono [Crea cartella](/docs/it/api-reference/knowledge-base/create-folder) per creare cartelle, [Sposta documento](/docs/it/api-reference/knowledge-base/move-document) per spostare singoli documenti e [Spostamento in blocco](/docs/it/api-reference/knowledge-base/bulk-move) per spostare più documenti contemporaneamente. ### Strumenti - **Elenco degli strumenti migliorato**: l'endpoint [Ottieni strumenti](/docs/it/api-reference/tools/list) ora supporta il filtraggio e la paginazione con nuovi parametri query, tra cui `search`, `page_size`, `types`, `sort_by`, `sort_direction` e `cursor`. La risposta ora include i campi `next_cursor` e `has_more` per la paginazione. ### Musica - **Miglioramenti ai metadati dei brani**: aggiunti i campi `bpm` e `time_signature` ai metadati dei brani per informazioni più dettagliate sull'analisi audio. ### ElevenCreative Studio - **Modelli di stile per i sottotitoli**: aggiunto il campo `caption_style_template_overrides` ai modelli di progetto, che consente di personalizzare lo stile dei sottotitoli per ogni modello. - **Tipo di progetto di doppiaggio video**: aggiunto `dub_video` all'enum del tipo di creazione del progetto. - **Metadati di pubblicazione**: aggiunto il timestamp `last_updated_from_project_unix` ai metadati di pubblicazione e del progetto. ### Workspace - **Gestione del tipo di posto**: introdotto il nuovo enum `SeatType` con i campi `seat_type` e `workspace_seat_type`, deprecando i precedenti campi `workspace_permission` e `workspace_role`. - **Autorizzazione per l'analisi del workspace**: aggiunto `workspace_analytics_full_read` all'enum `PermissionType` per un controllo granulare dell'accesso ai dati di analisi. ### Rilasci SDK #### SDK Python - [v2.32.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.32.0) - Aggiunti endpoint per branch, deployment e bozze degli agenti, gestione delle cartelle della knowledge base, elenco degli strumenti migliorato con filtraggio e paginazione e gestione del tipo di posto #### SDK JavaScript - [v2.33.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.33.0) - Aggiunti endpoint per branch, deployment e bozze degli agenti, gestione delle cartelle della knowledge base, elenco degli strumenti migliorato con filtraggio e paginazione e gestione del tipo di posto ### API ## Nuovi endpoint - [Elenca i branch dell'agente](/docs/it/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches` - Elenca tutti i branch di un agente - [Crea branch dell'agente](/docs/it/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Crea un nuovo branch per un agente - [Ottieni branch dell'agente](/docs/it/api-reference/agents/branches/get) - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}` - Ottieni un branch specifico - [Aggiorna branch dell'agente](/docs/it/api-reference/agents/branches/update) - `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}` - Aggiorna la configurazione del branch - [Unisci branch dell'agente](/docs/it/api-reference/agents/branches/merge) - `POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge` - Unisci un branch in un branch di destinazione - [Crea deployment](/docs/it/api-reference/agents/deployments/create) - `POST /v1/convai/agents/{agent_id}/deployments` - Crea o aggiorna i deployment degli agenti - [Crea bozza](/docs/it/api-reference/agents/drafts/create) - `POST /v1/convai/agents/{agent_id}/drafts` - Crea una bozza dell'agente - [Elimina bozza](/docs/it/api-reference/agents/drafts/delete) - `DELETE /v1/convai/agents/{agent_id}/drafts` - Elimina una bozza dell'agente - [Crea cartella](/docs/it/api-reference/knowledge-base/create-folder) - `POST /v1/convai/knowledge-base/folder` - Crea una cartella per raggruppare i documenti - [Sposta documento](/docs/it/api-reference/knowledge-base/move-document) - `POST /v1/convai/knowledge-base/{document_id}/move` - Sposta un documento in una cartella - [Spostamento in blocco](/docs/it/api-reference/knowledge-base/bulk-move) - `POST /v1/convai/knowledge-base/bulk-move` - Sposta più documenti in una cartella ## Endpoint aggiornati ### Piattaforma Agents - [Ottieni strumenti](/docs/it/api-reference/tools/list) - Aggiunto il parametro query `search` (stringa, facoltativo) per filtrare gli strumenti in base al prefisso del nome - Aggiunto il parametro query `page_size` (intero, facoltativo, massimo 100, valore predefinito 30) - Aggiunto il parametro query `show_only_owned_documents` (booleano, facoltativo, valore predefinito false) - Aggiunto il parametro query `types` (array, facoltativo) per filtrare in base al tipo di strumento - Aggiunto il parametro query `sort_by` (enum, facoltativo) per ordinare i risultati - Aggiunto il parametro query `sort_direction` (enum, facoltativo) per l'ordine di ordinamento - Aggiunto il parametro query `cursor` (stringa, facoltativo) per la paginazione - La risposta ora include i campi `next_cursor` (stringa) e `has_more` (booleano, obbligatorio) - [Crea agente](/docs/it/api-reference/agents/create) - Schema della richiesta aggiornato con supporto per i branch - [Ottieni conversazione](/docs/it/api-reference/conversations/get) - Aggiunto `agent_name` (stringa, facoltativo) al modello di risposta - [Crea bozza dell'agente](/docs/it/api-reference/agents/drafts/create) - Il campo `tags` ora è facoltativo ed è stato rimosso dai campi obbligatori ### Dizionari di pronuncia - [Aggiungi regole](/docs/it/api-reference/pronunciation-dictionaries/rules/add) - Descrizione aggiornata per chiarire che le regole con valori `string_to_replace` duplicati verranno sostituite ### Workspace - [Aggiungi invito al workspace](/docs/it/api-reference/workspace/invites/create), [Aggiungi membro al workspace](/docs/it/api-reference/workspace/invites/create) - Aggiunto il campo `seat_type` (enum, facoltativo) - Deprecati i campi `workspace_permission` e `workspace_role` a favore di `seat_type` ### ElevenCreative Studio - [Crea progetto](/docs/it/api-reference/studio/add-project) - Aggiunto il campo `create_publishing_read` (booleano, facoltativo) - Aggiunto `dub_video` all'enum del tipo di progetto - [Ottieni progetto](/docs/it/api-reference/studio/get-project), [Aggiorna progetto](/docs/it/api-reference/studio/edit-project) - Aggiunto `caption_style_template_overrides` (oggetto, facoltativo) per lo stile personalizzato dei sottotitoli ## Modifiche allo schema ### Nuovi schemi - `AgentBranch`, `AgentBranchInput`, `AgentBranchOutput` - Configurazione dei branch per gli agenti - `AgentDeployment`, `AgentDeploymentInput` - Configurazione dei deployment per gli agenti - `AgentVersion` - Informazioni sulla versione dell'agente - `BranchProtectionStatus` - Impostazioni di protezione dei branch - `SeatType` - Enum per i tipi di posto del workspace - `ToolSortBy` - Enum per le opzioni di ordinamento degli strumenti - `ToolTypeFilter` - Enum per filtrare gli strumenti per tipo - `CaptionStyleModel` - Configurazione dello stile dei sottotitoli ### Schemi modificati - `ToolsResponseModel` - Aggiunti i campi `next_cursor` e `has_more` per la paginazione - `SongMetadata` - Aggiunti i campi `bpm` (numero) e `time_signature` (stringa) - `GetConversationResponseModel` - Aggiunto il campo `agent_name` - `PermissionType` - Aggiunto il valore enum `workspace_analytics_full_read` - `ProjectCreationType` - Aggiunto il valore enum `dub_video` - Più modelli di eventi - Aggiunto il campo `error_type` per la categorizzazione degli errori