Vai alla navigazione

ElevenAgents, ElevenCreative ed ElevenAPI

Stiamo passando dalla percezione di un unico prodotto (“ElevenLabs”) a una struttura basata su una piattaforma con famiglie di prodotti ben definite:

  • ElevenAgents (in precedenza Piattaforma Agents)
  • ElevenCreative (in precedenza Piattaforma Creative)
  • ElevenAPI (nuova, la piattaforma per sviluppatori)

Lo vedrai già nella documentazione e nei readme degli SDK.

Server globali fuori dalla beta

Il routing globale è ora l’impostazione predefinita, anziché una funzionalità opt-in.

In precedenza, il server API ElevenLabs predefinito si trovava negli Stati Uniti, con una beta opt-in per instradare il traffico attraverso server basati nei Paesi Bassi o a Singapore. Da ora il routing globale è predefinito, quindi il server verrà scelto automaticamente in base alla vicinanza geografica per ottimizzare la latenza.

Il base URL opt-in api-global-preview.elevenlabs.io è ora deprecato; usa invece il base URL predefinito api.elevenlabs.io. Se usi gli SDK, questa è già l’impostazione predefinita.

Text to Speech

  • Normalizzatore TTS v3.1: aggiornato il normalizzatore di testo alla versione 3.1, che include maggiore accuratezza e minore latenza per la conversione text-to-speech.

Piattaforma Agents

  • Guardrail personalizzati: aggiunto il supporto per guardrail di output definiti dall’utente, che ti consentono di creare regole di filtraggio dei contenuti personalizzate oltre alla moderazione standard. Configura i guardrail con un nome, un’istruzione prompt (fino a 10.000 caratteri) e un modello di valutazione a scelta (gemini-2.5-flash-lite o gemini-2.0-flash). Quando si attiva, il guardrail termina la conversazione. Consulta il riferimento API Create agent per i dettagli di configurazione.
  • Messaggistica WhatsApp in uscita: aggiunto l’endpoint Send outbound message (POST /v1/convai/whatsapp/outbound-message) per avviare conversazioni via WhatsApp utilizzando template di messaggio. I campi obbligatori includono whatsapp_phone_number_id, whatsapp_user_id, template_name, template_language_code, template_params e agent_id.
  • Modello conversazionale Eleven v3: aggiunto eleven_v3_conversational ai modelli TTS disponibili per gli agenti, offrendo maggiore qualità vocale ed espressività nelle conversazioni degli agenti.
  • Tag audio suggeriti: aggiunto il campo suggested_audio_tags alla configurazione TTS per gli agenti che usano modelli v3. Definisci fino a 20 tag (ad esempio, “happy”, “excited”) per guidare la generazione di parlato espressivo, con descrizioni opzionali per indicare quando utilizzare ciascun tag.
  • Gestione degli errori degli strumenti: aggiunto il campo tool_error_handling_mode alle configurazioni degli strumenti webhook con le opzioni: auto (predefinita, determina la gestione in base al tipo di strumento), summarized (invia un riepilogo generato dall’LLM), passthrough (invia l’errore non elaborato) o hide (non condivide l’errore con l’agente).
  • Sanitizzazione delle variabili dinamiche: aggiunto il campo sanitize (booleano, valore predefinito false) a DynamicVariableAssignment. Se abilitato, il valore di assegnazione viene rimosso dalle risposte degli strumenti e dalle trascrizioni, ma continua a essere elaborato per l’assegnazione della variabile.
  • Selezione del modello di turno: aggiunto l’enum TurnModel con le opzioni turn_v2 e turn_v3 per selezionare la versione del modello di rilevamento dei turni.
  • Trasferimenti dei nodi workflow: aggiunto il campo is_workflow_node_transfer (booleano, valore predefinito false) allo schema AgentTransfer per identificare i trasferimenti all’interno dei nodi workflow.
  • Metadati dei branch di trasferimento: aggiunti gli schemi TransferBranchInfoTrafficSplit e TransferBranchInfoDefaultingToMain per monitorare le informazioni di routing dei branch nei trasferimenti degli agenti.
  • Test delle transizioni dei nodi workflow: aggiunto il tipo di asserzione workflow_node_transition per i test unitari con lo schema UnitTestWorkflowNodeTransitionEvaluationNodeId per convalidare le transizioni del workflow degli agenti.

Studio ElevenCreative

  • Endpoint per le tracce disattivate: aggiunto l’endpoint Get project muted tracks (GET /v1/studio/projects/{project_id}/muted-tracks) che restituisce un elenco di ID capitolo con tracce disattivate in un progetto.

Workspace

  • Tipo di posto membro Lite: aggiunto workspace_lite_member all’enum SeatType per workspace con autorizzazioni di accesso limitate.
  • Risorsa template di contenuto: aggiunto content_templates all’enum WorkspaceResourceType per condividere template di contenuto nei workspace.

Interfaccia utente

  • Scorrimento della raccolta di voci: corretto un problema che impediva lo scorrimento con la rotellina del mouse e con il tocco nel selettore di icone della raccolta di voci su macOS.

Rilasci SDK

SDK Python

  • v2.35.0 - Aggiunti guardrail personalizzati, messaggistica WhatsApp in uscita, modalità di gestione degli errori degli strumenti, sanitizzazione delle variabili dinamiche, selezione del modello di turno e supporto per il modello conversazionale Eleven v3

SDK JavaScript

  • v2.35.0 - Aggiunti guardrail personalizzati, messaggistica WhatsApp in uscita, modalità di gestione degli errori degli strumenti, sanitizzazione delle variabili dinamiche, selezione del modello di turno e supporto per il modello conversazionale Eleven v3

SDK React e Client

  • @elevenlabs/react-native@0.5.10 - Corretta l’attivazione delle conversazioni di solo testo
  • @elevenlabs/react@0.14.0 - Ridotta la durata dei chunk audio da 250 ms a 100 ms per una latenza inferiore nelle conversazioni degli agenti
  • @elevenlabs/client@0.14.0 - Ridotta la durata dei chunk audio da 250 ms a 100 ms per una latenza inferiore, normalizzata la gestione dell’opzione textOnly tra il livello superiore e l’oggetto degli override
  • @elevenlabs/types@0.5.0 - Aggiunti tipi per il supporto dei dati di allineamento audio

API

Nuovi endpoint

Endpoint aggiornati

Piattaforma Agents

  • Create agent, Update agent, Get agent
    • Aggiunto il campo custom allo schema GuardrailsV1 per la configurazione di guardrail personalizzati
    • Aggiunto il campo alignment allo schema GuardrailsV1 per i guardrail di allineamento
    • Aggiunto il campo suggested_audio_tags alla configurazione conversazionale TTS (array di SuggestedAudioTag, max 20 elementi)
    • Aggiunto eleven_v3_conversational all’enum TTSConversationalModel
  • Create tool, Update tool
    • Aggiunto il campo tool_error_handling_mode a ApiIntegrationWebhookToolConfig (enum: auto, summarized, passthrough, hide, valore predefinito auto)
    • Aggiunto il campo sanitize a DynamicVariableAssignment (booleano, valore predefinito false)

Workspace

Modifiche agli schemi

Nuovi schemi

  • CustomGuardrail-Input, CustomGuardrail-Output - Contenitore per la configurazione di guardrail personalizzati
  • CustomGuardrailsConfig - Contenitore di configurazione per l’elenco di guardrail personalizzati
  • CustomGuardrailConfig - Singolo guardrail personalizzato con name (stringa, obbligatorio), prompt (stringa, obbligatorio, max 10.000 caratteri), model (enum: gemini-2.5-flash-lite, gemini-2.0-flash, obbligatorio) e is_enabled (booleano, valore predefinito false)
  • ToolErrorHandlingMode - Enum per la gestione degli errori degli strumenti: auto, summarized, passthrough, hide
  • TurnModel - Enum per la versione del modello di rilevamento dei turni: turn_v2, turn_v3
  • SuggestedAudioTag - Configurazione del tag audio con tag (stringa, obbligatorio, max 30 caratteri) e description (stringa, opzionale, max 200 caratteri)
  • TransferBranchInfoTrafficSplit - Informazioni sul branch per trasferimenti con suddivisione del traffico, con branch_id e traffic_percentage
  • TransferBranchInfoDefaultingToMain - Informazioni sul branch per trasferimenti con fallback al principale, con branch_id
  • UnitTestWorkflowNodeTransitionEvaluationNodeId - Configurazione del test di transizione del nodo workflow con agent_id e target_node_id
  • ProjectMutedTracksResponseModel - Modello di risposta con array chapter_ids
  • WhatsAppOutboundMessageResponse - Risposta per l’endpoint dei messaggi WhatsApp in uscita
  • WhatsAppTemplateHeaderComponentParams, WhatsAppTemplateBodyComponentParams, WhatsAppTemplateButtonComponentParams - Schemi dei parametri template per i messaggi WhatsApp
  • ConversationHistoryTranscriptSystemToolResultCommonModel-Input, ConversationHistoryTranscriptSystemToolResultCommonModel-Output - Modelli di risultati degli strumenti di sistema separati per le varianti input/output

Schemi modificati

  • GuardrailsV1-Input, GuardrailsV1-Output - Aggiunti i campi custom (CustomGuardrail) e alignment (AlignmentGuardrail)
  • TTSConversationalConfig-Input, TTSConversationalConfig-Output - Aggiunto il campo suggested_audio_tags
  • TTSConversationalModel - Aggiunto il valore enum eleven_v3_conversational
  • ApiIntegrationWebhookToolConfig-Input, ApiIntegrationWebhookToolConfig-Output - Aggiunto il campo tool_error_handling_mode (obbligatorio)
  • DynamicVariableAssignment - Aggiunto il campo sanitize (booleano, valore predefinito false)
  • AgentTransfer - Aggiunto il campo is_workflow_node_transfer (booleano, valore predefinito false)
  • SeatType - Aggiunto il valore enum workspace_lite_member
  • WorkspaceResourceType - Aggiunto il valore enum content_templates

Schemi rimossi

  • AgentBan - Rimosso schema non utilizzato
  • BanReasonType - Rimosso enum non utilizzato
  • DubbingReleaseChannel - Rimosso enum non utilizzato