Vai alla navigazione

Modelli Realtime

Usa i modelli ElevenLabs progettati per agenti vocali a bassa latenza.

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:

ModelloValore di realtime_modelDescrizione
Eleven Realtime v1 Minieleven_realtime_v1_miniIl modello Realtime predefinito. Latenza e costo minimi.
Eleven Realtime v1 Maxeleven_realtime_v1_maxRagiona prima di rispondere, per istruzioni complesse e uso di strumenti in più passaggi. Costa più di Mini.

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

1

Apri la scheda Agente

Apri il tuo agente nel dashboard e vai alla scheda Agente.

2

Imposta la modalità vocale

Imposta Modalità vocale su Realtime. L’agente passa a Eleven Realtime v1 Mini.

3

Scegli un modello

Per usare invece Eleven Realtime v1 Max, selezionalo dall’elenco Modello.

4

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.

ImpostazioneCampo in conversation_config
LLMagent.prompt.llm
Livello di ragionamentoagent.prompt.reasoning_effort
Budget di ragionamentoagent.prompt.thinking_budget
Chiamate parallele agli strumentiagent.prompt.enable_parallel_tool_calls
Timeout della cascataagent.prompt.cascade_timeout_seconds
Modello TTStts.model_id
Modalità espressivatts.expressive_mode
Provider ASRasr.provider

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 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:

AmbienteEleven Realtime v1 MiniEleven Realtime v1 Max
Stati UnitiDisponibileDisponibile
Residenza dei dati nell’UEDisponibileDisponibile
Residenza dei dati in IndiaDisponibileNon disponibile
Residenza dei dati a SingaporeDisponibileNon disponibile
Zero Retention Mode e HIPAANon disponibileDisponibile negli Stati Uniti e nell’UE

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.

Risorse correlate