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-liteogemini-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 includonowhatsapp_phone_number_id,whatsapp_user_id,template_name,template_language_code,template_paramseagent_id. - Modello conversazionale Eleven v3: aggiunto
eleven_v3_conversationalai modelli TTS disponibili per gli agenti, offrendo maggiore qualità vocale ed espressività nelle conversazioni degli agenti. - Tag audio suggeriti: aggiunto il campo
suggested_audio_tagsalla 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_modealle 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) ohide(non condivide l’errore con l’agente). - Sanitizzazione delle variabili dinamiche: aggiunto il campo
sanitize(booleano, valore predefinitofalse) aDynamicVariableAssignment. 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
TurnModelcon le opzioniturn_v2eturn_v3per selezionare la versione del modello di rilevamento dei turni. - Trasferimenti dei nodi workflow: aggiunto il campo
is_workflow_node_transfer(booleano, valore predefinitofalse) allo schemaAgentTransferper identificare i trasferimenti all’interno dei nodi workflow. - Metadati dei branch di trasferimento: aggiunti gli schemi
TransferBranchInfoTrafficSpliteTransferBranchInfoDefaultingToMainper monitorare le informazioni di routing dei branch nei trasferimenti degli agenti. - Test delle transizioni dei nodi workflow: aggiunto il tipo di asserzione
workflow_node_transitionper i test unitari con lo schemaUnitTestWorkflowNodeTransitionEvaluationNodeIdper 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_memberall’enumSeatTypeper workspace con autorizzazioni di accesso limitate. - Risorsa template di contenuto: aggiunto
content_templatesall’enumWorkspaceResourceTypeper 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
textOnlytra il livello superiore e l’oggetto degli override - @elevenlabs/types@0.5.0 - Aggiunti tipi per il supporto dei dati di allineamento audio
API
Visualizza le modifiche API
Nuovi endpoint
- Invia un messaggio in uscita tramite WhatsApp -
POST /v1/convai/whatsapp/outbound-message- Invia un messaggio in uscita tramite WhatsApp usando template di messaggio - Ottieni le tracce disattivate del progetto -
GET /v1/studio/projects/{project_id}/muted-tracks- Restituisce gli ID dei capitoli con tracce disattivate
Endpoint aggiornati
Piattaforma Agents
- Create agent, Update agent, Get agent
- Aggiunto il campo
customallo schemaGuardrailsV1per la configurazione di guardrail personalizzati - Aggiunto il campo
alignmentallo schemaGuardrailsV1per i guardrail di allineamento - Aggiunto il campo
suggested_audio_tagsalla configurazione conversazionale TTS (array diSuggestedAudioTag, max 20 elementi) - Aggiunto
eleven_v3_conversationalall’enumTTSConversationalModel
- Aggiunto il campo
- Create tool, Update tool
- Aggiunto il campo
tool_error_handling_modeaApiIntegrationWebhookToolConfig(enum:auto,summarized,passthrough,hide, valore predefinitoauto) - Aggiunto il campo
sanitizeaDynamicVariableAssignment(booleano, valore predefinitofalse)
- Aggiunto il campo
Workspace
- Get resource
- Aggiunto
content_templatesall’enumWorkspaceResourceType
- Aggiunto
- Add workspace invite, Add workspace member
- Aggiunto
workspace_lite_memberall’enumSeatType
- Aggiunto
Modifiche agli schemi
Nuovi schemi
CustomGuardrail-Input,CustomGuardrail-Output- Contenitore per la configurazione di guardrail personalizzatiCustomGuardrailsConfig- Contenitore di configurazione per l’elenco di guardrail personalizzatiCustomGuardrailConfig- Singolo guardrail personalizzato conname(stringa, obbligatorio),prompt(stringa, obbligatorio, max 10.000 caratteri),model(enum:gemini-2.5-flash-lite,gemini-2.0-flash, obbligatorio) eis_enabled(booleano, valore predefinitofalse)ToolErrorHandlingMode- Enum per la gestione degli errori degli strumenti:auto,summarized,passthrough,hideTurnModel- Enum per la versione del modello di rilevamento dei turni:turn_v2,turn_v3SuggestedAudioTag- Configurazione del tag audio contag(stringa, obbligatorio, max 30 caratteri) edescription(stringa, opzionale, max 200 caratteri)TransferBranchInfoTrafficSplit- Informazioni sul branch per trasferimenti con suddivisione del traffico, conbranch_idetraffic_percentageTransferBranchInfoDefaultingToMain- Informazioni sul branch per trasferimenti con fallback al principale, conbranch_idUnitTestWorkflowNodeTransitionEvaluationNodeId- Configurazione del test di transizione del nodo workflow conagent_idetarget_node_idProjectMutedTracksResponseModel- Modello di risposta con arraychapter_idsWhatsAppOutboundMessageResponse- Risposta per l’endpoint dei messaggi WhatsApp in uscitaWhatsAppTemplateHeaderComponentParams,WhatsAppTemplateBodyComponentParams,WhatsAppTemplateButtonComponentParams- Schemi dei parametri template per i messaggi WhatsAppConversationHistoryTranscriptSystemToolResultCommonModel-Input,ConversationHistoryTranscriptSystemToolResultCommonModel-Output- Modelli di risultati degli strumenti di sistema separati per le varianti input/output
Schemi modificati
GuardrailsV1-Input,GuardrailsV1-Output- Aggiunti i campicustom(CustomGuardrail) ealignment(AlignmentGuardrail)TTSConversationalConfig-Input,TTSConversationalConfig-Output- Aggiunto il camposuggested_audio_tagsTTSConversationalModel- Aggiunto il valore enumeleven_v3_conversationalApiIntegrationWebhookToolConfig-Input,ApiIntegrationWebhookToolConfig-Output- Aggiunto il campotool_error_handling_mode(obbligatorio)DynamicVariableAssignment- Aggiunto il camposanitize(booleano, valore predefinitofalse)AgentTransfer- Aggiunto il campois_workflow_node_transfer(booleano, valore predefinitofalse)SeatType- Aggiunto il valore enumworkspace_lite_memberWorkspaceResourceType- Aggiunto il valore enumcontent_templates
Schemi rimossi
AgentBan- Rimosso schema non utilizzatoBanReasonType- Rimosso enum non utilizzatoDubbingReleaseChannel- Rimosso enum non utilizzato