Modelli Realtime
Panoramica
Un modello Realtime è un modello ElevenLabs progettato per conversazioni vocali a bassa latenza, disponibile per gli agenti vocali.
Ogni agente vocale ha una Modalità vocale: Personalizzata o Realtime. In modalità Personalizzata, scegli tu l’LLM, il modello TTS e le impostazioni ASR, come descritto in Modelli. In modalità Realtime, scegli un modello Realtime e ElevenLabs gestisce queste impostazioni per te.
Sono disponibili due modelli Realtime:
Il prompt di sistema, la voce, gli strumenti, la knowledge base e le impostazioni dei turni dell’agente funzionano allo stesso modo in entrambe le modalità.
Arrivi da un’altra API realtime, come SpaceXAI o OpenAI? La Realtime API è un modo più rapido per provare i modelli Realtime: punta il client esistente a ElevenLabs e mantieni gli eventi che usi già.
I modelli Realtime vengono distribuiti gradualmente. Se l’impostazione Modalità vocale non appare nella
scheda Agente del tuo agente, i modelli Realtime non sono ancora disponibili per il tuo workspace e l’API
rifiuta realtime_model con l’errore Realtime models are not available for this workspace.
Scegliere una modalità vocale
Mantieni l’agente in modalità Personalizzata se si applica una delle seguenti condizioni:
- L’agente usa un LLM personalizzato, Amazon Bedrock o Speech Engine.
- L’agente richiede un LLM o un modello TTS specifico.
- I nodi del workflow sovrascrivono l’LLM, il modello TTS o un’altra impostazione gestita.
- L’agente trasferisce conversazioni ad agenti in modalità Personalizzata o le riceve da tali agenti.
- L’agente è solo testuale. I modelli Realtime sono progettati per conversazioni vocali.
Altrimenti, inizia con Eleven Realtime v1 Mini. Scegli invece Eleven Realtime v1 Max quando:
- L’agente segue istruzioni lunghe o complesse, oppure si basa su chiamate agli strumenti in più passaggi, e le risposte di Mini non sono sufficienti.
- L’agente deve rispettare Zero Retention Mode o HIPAA negli Stati Uniti o nell’UE. Mini non è disponibile per nessuno dei due.
Max non è disponibile negli ambienti di residenza dei dati in India e Singapore e richiede un limite di token di almeno 1.024, o nessun limite. Consulta Limitazioni e Conformità normativa e residenza dei dati.
Configurazione
Aggiorna dal dashboard
Aggiorna tramite CLI
Aggiorna tramite API
Imposta la modalità vocale
Imposta Modalità vocale su Realtime. L’agente passa a Eleven Realtime v1 Mini.
Pubblica
Pubblica le modifiche. La pubblicazione non riesce se l’agente non rispetta una delle regole in Limitazioni.
Per disattivare Realtime, imposta Modalità vocale su Personalizzata e pubblica. L’agente torna alle impostazioni LLM, del modello TTS e ASR memorizzate al suo interno.
Impostazioni gestite
Quando è impostato un modello Realtime, ElevenLabs gestisce le seguenti impostazioni e l’agente ignora i valori memorizzati per esse. I valori memorizzati tornano in uso quando passi a Personalizzata.
Il limite di token (agent.prompt.max_tokens) mantiene il valore memorizzato, ma i nodi del workflow non possono sovrascriverlo e Eleven Realtime v1 Max richiede un valore minimo. Consulta Limitazioni.
Per modificare una di queste impostazioni, passa l’agente a Personalizzata.
Impostazioni ancora applicabili
Tutte le altre impostazioni dell’agente funzionano come in modalità Personalizzata, tra cui:
- il prompt di sistema e il primo messaggio
- la voce, incluso il supporto multivoce
- le lingue
- la temperatura
- gli strumenti e la knowledge base
- le impostazioni del flusso di conversazione, come propensione al turno, timeout e interruzioni
Il dashboard nasconde le impostazioni LLM, inclusa la temperatura, quando l’agente è in modalità Realtime. Usa la CLI o l’API per modificare la temperatura di un agente Realtime.
Se il modello Realtime non risponde in tempo o restituisce un errore, l’agente passa agli LLM di backup come descritto in Cascata LLM. Il modello Realtime determina quanto tempo l’agente attende prima di passare al backup.
Limitazioni
ElevenLabs verifica queste regole quando pubblichi l’agente. Una bozza che ne viola una viene comunque salvata, ma la pubblicazione non riesce e viene visualizzato un errore che indica l’impostazione da modificare.
- Solo agenti ElevenAgents: gli agenti creati tramite altri prodotti ElevenLabs, come Speech Engine, non possono usare un modello Realtime.
- Nessun LLM personalizzato: la modalità Realtime non è disponibile quando l’LLM dell’agente è un LLM personalizzato o Amazon Bedrock. Seleziona un LLM integrato in modalità Personalizzata prima di passare a Realtime.
- Nessuna sovrascrittura delle impostazioni gestite nel workflow: un nodo del workflow non può sovrascrivere alcuna impostazione gestita né il limite di token. Rimuovi la sovrascrittura oppure mantieni l’agente in modalità Personalizzata.
- Limite di token per Max: Eleven Realtime v1 Max richiede un limite di token pari o superiore a 1.024, oppure nessun limite.
- Trasferimenti tra modalità: un agente in modalità Realtime può trasferire conversazioni solo ad altri agenti in modalità Realtime e riceverle solo da questi. Sono supportati i trasferimenti tra agenti Mini e Max.
La pubblicazione verifica solo i trasferimenti effettuati dall’agente pubblicato. Un trasferimento verso un agente Realtime da un agente in modalità Personalizzata viene rilevato solo alla successiva pubblicazione dell’agente in modalità Personalizzata; fino ad allora, il trasferimento viene rifiutato durante la conversazione e l’agente corrente rimane nella chiamata.
Gli errori di trasferimento riportano Transfers between default and Realtime model modes are not supported., dove “default” indica la modalità Personalizzata.
Conformità normativa e residenza dei dati
I modelli Realtime seguono le stesse regole di Zero Retention Mode, HIPAA e residenza dei dati degli altri modelli. La disponibilità varia tra Mini e Max:
Zero Retention Mode si applica sia quando è imposto sul workspace sia quando è abilitato sull’agente.
Se un modello Realtime non è disponibile in base alle impostazioni di conformità normativa o residenza dei dati dell’agente, ElevenLabs lo rifiuta con un errore che indica il modello. Scegli l’altro modello Realtime oppure passa a Personalizzata.
Prezzi
A un agente Realtime viene addebitata la tariffa standard al minuto di ElevenAgents, oltre ai token di input, input memorizzato nella cache e output alle tariffe del modello Realtime. Eleven Realtime v1 Max costa più per token di Eleven Realtime v1 Mini. Consulta i prezzi di ElevenLabs per le tariffe aggiornate.