> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # 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](/docs/it/eleven-agents/customization/llm). In modalità Realtime, scegli un modello Realtime e ElevenLabs gestisce queste impostazioni per te. Sono disponibili due modelli Realtime: | Modello | Valore di `realtime_model` | Descrizione | | --------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------ | | **Eleven Realtime v1 Mini** | `eleven_realtime_v1_mini` | Il modello Realtime predefinito. Latenza e costo minimi. | | **Eleven Realtime v1 Max** | `eleven_realtime_v1_max` | Ragiona 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à. > **Tip** > > Arrivi da un'altra API realtime, come SpaceXAI o OpenAI? La [Realtime API](/docs/it/eleven-agents/guides/openai-realtime-compatibility) è un modo più rapido per provare i > modelli Realtime: punta il client esistente a ElevenLabs e mantieni gli eventi che usi già. > **Note** > > 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](/docs/it/eleven-agents/customization/llm/custom-llm), Amazon Bedrock o [Speech Engine](/docs/it/eleven-api/guides/cookbooks/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](#managed-settings). * 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](/docs/it/eleven-agents/customization/privacy/zrm) o [HIPAA](/docs/it/eleven-agents/legal/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](#limitations) e [Conformità normativa e residenza dei dati](#compliance-and-data-residency). ## Configurazione #### Aggiorna dal dashboard #### Apri la scheda Agente Apri il tuo agente nel dashboard e vai alla scheda **Agente**. #### Imposta la modalità vocale Imposta **Modalità vocale** su **Realtime**. L'agente passa a Eleven Realtime v1 Mini. #### Scegli un modello Per usare invece Eleven Realtime v1 Max, selezionalo dall'elenco **Modello**. #### Pubblica Pubblica le modifiche. La pubblicazione non riesce se l'agente non rispetta una delle regole in [Limitazioni](#limitations). 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. #### Aggiorna tramite CLI #### Scarica la configurazione dell'agente ```bash elevenlabs agents pull --agent "" ``` #### Modifica \`agent_configs/\.json\` Imposta `conversation_config.realtime_model`: ```json { "conversation_config": { "realtime_model": "eleven_realtime_v1_mini" } } ``` Per disattivare Realtime, imposta `realtime_model` su `null`. #### Invia le modifiche ```bash elevenlabs agents push --agent "" ``` #### Aggiorna tramite API ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "realtime_model": "eleven_realtime_v1_mini", }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { realtimeModel: "eleven_realtime_v1_mini", }, }); ``` Per disattivare Realtime, imposta `realtime_model` su `None` in Python o `realtimeModel` su `null` in TypeScript. ## 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. | Impostazione | Campo in `conversation_config` | | --------------------------------- | ----------------------------------------- | | LLM | `agent.prompt.llm` | | Livello di ragionamento | `agent.prompt.reasoning_effort` | | Budget di ragionamento | `agent.prompt.thinking_budget` | | Chiamate parallele agli strumenti | `agent.prompt.enable_parallel_tool_calls` | | Timeout della cascata | `agent.prompt.cascade_timeout_seconds` | | Modello TTS | `tts.model_id` | | Modalità espressiva | `tts.expressive_mode` | | Provider ASR | `asr.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](#limitations). 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](/docs/it/eleven-agents/customization/voice/multi-voice-support) * le [lingue](/docs/it/eleven-agents/customization/voice/customization/language) * la temperatura * gli [strumenti](/docs/it/eleven-agents/customization/tools) e la [knowledge base](/docs/it/eleven-agents/customization/knowledge-base) * le impostazioni del [flusso di conversazione](/docs/it/eleven-agents/customization/conversation-flow), 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](/docs/it/eleven-agents/customization/llm/llm-cascading). 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](/docs/it/eleven-api/guides/cookbooks/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](#managed-settings) 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](/docs/it/eleven-agents/customization/tools/system-tools/agent-transfer) conversazioni solo ad altri agenti in modalità Realtime e riceverle solo da questi. Sono supportati i trasferimenti tra agenti Mini e Max. > **Warning** > > 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](/docs/it/eleven-agents/customization/privacy/zrm), [HIPAA](/docs/it/eleven-agents/legal/hipaa) e [residenza dei dati](/docs/it/overview/administration/data-residency) degli altri modelli. La disponibilità varia tra Mini e Max: | Ambiente | Eleven Realtime v1 Mini | Eleven Realtime v1 Max | | ------------------------------ | ----------------------- | --------------------------------------- | | Stati Uniti | Disponibile | Disponibile | | Residenza dei dati nell'UE | Disponibile | Disponibile | | Residenza dei dati in India | Disponibile | Non disponibile | | Residenza dei dati a Singapore | Disponibile | Non disponibile | | Zero Retention Mode e HIPAA | Non disponibile | Disponibile 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](https://elevenlabs.io/pricing) per le tariffe aggiornate. ## Risorse correlate * [Modelli](/docs/it/eleven-agents/customization/llm) * [Cascata LLM](/docs/it/eleven-agents/customization/llm/llm-cascading) * [Trasferimento dell'agente](/docs/it/eleven-agents/customization/tools/system-tools/agent-transfer) * [Zero Retention Mode](/docs/it/eleven-agents/customization/privacy/zrm) * [Conformità HIPAA](/docs/it/eleven-agents/legal/hipaa)