Registro delle modifiche

Nuovi endpoint

• Ricerca testuale nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/text-search - Esegue una ricerca full-text o fuzzy nei messaggi delle trascrizioni delle conversazioni
• Ricerca intelligente nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/smart-search - Esegue una ricerca semantica nei messaggi delle conversazioni usando embedding
• Elenca gli LLM disponibili - GET /v1/convai/llm/list - Recupera gli LLM disponibili con informazioni sulla deprecazione, capacità e limiti di contesto
• Carica file nella conversazione - POST /v1/convai/conversations/{conversation_id}/files - Carica file nel contesto di una conversazione
• Elimina file della conversazione - DELETE /v1/convai/conversations/{conversation_id}/files/{file_id} - Rimuove un file caricato da una conversazione

Endpoint rimossi

Sono stati rimossi i seguenti endpoint legacy per la generazione di voci:

• GET /v1/voice-generation/generate-voice/parameters - Parametri per la generazione di voci
• POST /v1/voice-generation/generate-voice - Genera una voce casuale
• POST /v1/voice-generation/create-voice - Crea una voce generata in precedenza

Usa invece gli endpoint Voice Design e Voice Remix.

Endpoint aggiornati

ElevenAgents

• Crea agente, Aggiorna agente, Ottieni agente

  • Aggiunto il campo coaching_settings per la configurazione dell’addestramento dell’agente
  • Aggiunto conversation_history_redaction in platform_settings.privacy con tipi di entità configurabili
  • Aggiunti i nuovi guardrail focus e prompt_injection in platform_settings.guardrails
  • Rimosso il guardrail alignment da platform_settings.guardrails
  • Aggiunto qwen3_embedding_4b come opzione del modello di embedding nella configurazione RAG
  • Aggiornate le descrizioni dei campi numerici per rendere più chiari intervalli e valori predefiniti

• Crea server MCP, Aggiorna server MCP, Ottieni server MCP

  • Aggiunto il campo auth_connection (facoltativo) per abilitare OAuth e metodi di autenticazione avanzati
  • Aggiunto il campo secret_token all’endpoint PATCH per la retrocompatibilità
  • La connessione di autenticazione ha la precedenza su secret_token quando vengono forniti entrambi

• Crea configurazione strumento MCP, Aggiorna configurazione strumento MCP, Ottieni configurazione strumento MCP

  • Aggiunto il campo input_overrides: permette di sovrascrivere i parametri di input dello strumento con costanti, variabili dinamiche o valori generati dall’LLM

• Crea indice RAG, Elimina indice RAG

  • Aggiunto qwen3_embedding_4b all’enum embedding_model

• Ottieni conversazioni

  • Deprecato il parametro query search (usa invece i nuovi endpoint di ricerca dedicati)

• Ottieni conversazione

  • Aggiunto il campo hiding_reason per indicare perché una conversazione potrebbe essere nascosta
  • Estese le voci delle trascrizioni delle conversazioni per supportare metadati file_input con il nuovo tipo ChatSourceMedium (audio, testo, immagine, file)

• Simula conversazione, Stream della simulazione di conversazione

  • Aggiornati tutti i campi di configurazione annidati con descrizioni e intervalli di convalida migliorati

• Ottieni branch dell’agente, Aggiorna branch dell’agente

  • Aggiornata la descrizione del campo current_live_percentage per maggiore chiarezza

• Ottieni impostazioni di ElevenAgents, Aggiorna impostazioni di ElevenAgents

  • Aggiornato il campo rag_retention_period_days con una descrizione migliorata

Workspace

• Aggiorna webhook

  • Aggiunto il campo retry_enabled (booleano, facoltativo): abilita nuovi tentativi automatici per errori transitori (5xx, 429, timeout)

• Ottieni risorsa del workspace, Condividi risorsa del workspace, Rimuovi condivisione della risorsa del workspace

  • Aggiunto songs all’enum resource_type per supportare la condivisione di musica nel workspace

• Ottieni utente

  • Aggiunto il campo obbligatorio seat_type con valori enum: workspace_admin, workspace_member, workspace_lite_member

Musica

• Genera musica, Genera musica dettagliata, Trasmetti musica in streaming
  • Chiarita la descrizione del parametro seed: seed casuale per l’inizializzazione della generazione di musica. Fornire lo stesso seed con parametri identici aiuta a ottenere risultati più coerenti, ma la riproducibilità esatta non è garantita e gli output possono cambiare con gli aggiornamenti del sistema. Non può essere usato con il parametro prompt.

Text to Voice

• Crea anteprime vocali, Progetta voce, Remixa voce
  • Aggiornata la descrizione del parametro loudness: controlla il livello del volume della voce generata. -1 è il più basso, 1 è il più alto, 0 corrisponde approssimativamente a -24 LUFS
  • Aggiornata la descrizione del parametro guidance_scale: controlla quanto l’IA segue fedelmente il prompt. I numeri più bassi lasciano all’IA maggiore libertà creativa, mentre quelli più alti la costringono ad attenersi maggiormente al prompt. Numeri elevati possono rendere la voce artificiale o robotica. Prompt più lunghi e dettagliati funzionano meglio con una guidance scale più bassa.
  • Aggiornata la descrizione del parametro quality per la creazione di anteprime vocali

Voci

• Ottieni voci, Ottieni impostazioni vocali, Ottieni impostazioni vocali predefinite, Modifica impostazioni vocali
  • Aggiornata la descrizione del parametro style: determina l’esagerazione dello stile della voce. Cerca di amplificare lo stile del parlante originale. Consuma risorse computazionali aggiuntive e potrebbe aumentare la latenza se impostato su un valore diverso da 0
  • Aggiornata la descrizione del parametro speed: regola la velocità della voce. 1.0 è il valore predefinito, valori inferiori a 1.0 rallentano il parlato, valori superiori a 1.0 lo accelerano