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

# Modelos em tempo real

## Visão geral

Um modelo em tempo real é um modelo da ElevenLabs desenvolvido para conversas por voz de baixa latência, disponível para agentes de voz.

Todos os agentes de voz têm um **Modo de voz**: **Personalizado** ou **Em tempo real**. No modo Personalizado, você escolhe o LLM, o modelo de TTS e as configurações de ASR, conforme descrito em [Modelos](/docs/pt/eleven-agents/customization/llm). No modo Em tempo real, você escolhe um modelo em tempo real, e a ElevenLabs gerencia essas configurações para você.

Há dois modelos em tempo real disponíveis:

| Modelo                      | Valor de `realtime_model` | Descrição                                                                                                             |
| --------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Eleven Realtime v1 Mini** | `eleven_realtime_v1_mini` | O modelo em tempo real padrão. Menor latência e custo.                                                                |
| **Eleven Realtime v1 Max**  | `eleven_realtime_v1_max`  | Raciocina antes de responder, para instruções complexas e uso de ferramentas em várias etapas. Custa mais que o Mini. |

O prompt do sistema, a voz, as ferramentas, a base de conhecimento e as configurações de turno do agente funcionam da mesma forma nos dois modos.

> **Tip**
>
> Vem de outra API em tempo real, como SpaceXAI ou OpenAI? A [API em tempo real](/docs/pt/eleven-agents/guides/openai-realtime-compatibility) é uma forma mais rápida de experimentar
> modelos em tempo real: aponte seu cliente existente para a ElevenLabs e mantenha os eventos que você já usa.

> **Note**
>
> Os modelos em tempo real estão sendo lançados gradualmente. Se a configuração **Modo de voz** não aparecer na
> aba **Agente** do seu agente, os modelos em tempo real ainda não estarão disponíveis para seu workspace, e a API
> rejeitará `realtime_model` com o erro `Realtime models are not available for this workspace.`

## Como escolher um modo de voz

Mantenha o agente no modo Personalizado se alguma das situações abaixo se aplicar:

* O agente usa um [LLM personalizado](/docs/pt/eleven-agents/customization/llm/custom-llm), Amazon Bedrock ou [Speech Engine](/docs/pt/eleven-api/guides/cookbooks/speech-engine).
* O agente precisa de um LLM ou modelo de TTS específico.
* Nós de workflow substituem o LLM, o modelo de TTS ou outra [configuração gerenciada](#managed-settings).
* O agente transfere para ou recebe transferências de agentes no modo Personalizado.
* O agente é somente de texto. Os modelos em tempo real são desenvolvidos para conversas por voz.

Caso contrário, comece com o Eleven Realtime v1 Mini. Em vez disso, escolha o Eleven Realtime v1 Max quando:

* O agente segue instruções longas ou complexas, ou depende de chamadas de ferramentas em várias etapas, e as respostas do Mini não são boas o suficiente.
* O agente precisa estar em conformidade com o [Modo de Retenção Zero](/docs/pt/eleven-agents/customization/privacy/zrm) ou a [HIPAA](/docs/pt/eleven-agents/legal/hipaa) nos EUA ou na UE. O Mini não está disponível em nenhum dos dois casos.

O Max não está disponível nos ambientes de residência de dados da Índia e de Singapura, e precisa de um limite de tokens de pelo menos 1.024, ou sem limite. Consulte [Limitações](#limitations) e [Conformidade e residência de dados](#compliance-and-data-residency).

## Configuração

#### Atualizar pelo dashboard

#### Abra a aba Agente

Abra seu agente no dashboard e acesse a aba **Agente**.

#### Defina o modo de voz

Defina **Modo de voz** como **Em tempo real**. O agente muda para o Eleven Realtime v1 Mini.

#### Escolha um modelo

Para usar o Eleven Realtime v1 Max, selecione-o na lista **Modelo**.

#### Publicar

Publique suas alterações. A publicação falhará se o agente violar uma das regras em [Limitações](#limitations).

Para desativar o modo Em tempo real, defina **Modo de voz** como **Personalizado** e publique. O agente volta a usar as configurações de LLM, modelo de TTS e ASR armazenadas nele.

#### Atualizar pela CLI

#### Baixe a configuração do agente

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Edite \`agent_configs/\<agent-name>.json\`

Defina `conversation_config.realtime_model`:

```json
{
  "conversation_config": {
    "realtime_model": "eleven_realtime_v1_mini"
  }
}
```

Para desativar o modo Em tempo real, defina `realtime_model` como `null`.

#### Envie suas alterações

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Atualizar pela 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",
  },
});
```

Para desativar o modo Em tempo real, defina `realtime_model` como `None` em Python ou `realtimeModel` como `null` em TypeScript.

## Configurações gerenciadas

Enquanto um modelo em tempo real estiver definido, a ElevenLabs gerenciará as configurações a seguir, e o agente ignorará os valores armazenados para elas. Os valores armazenados voltarão a ser usados quando você mudar para Personalizado.

| Configuração                      | Campo em `conversation_config`            |
| --------------------------------- | ----------------------------------------- |
| LLM                               | `agent.prompt.llm`                        |
| Esforço de raciocínio             | `agent.prompt.reasoning_effort`           |
| Orçamento de raciocínio           | `agent.prompt.thinking_budget`            |
| Chamadas paralelas de ferramentas | `agent.prompt.enable_parallel_tool_calls` |
| Tempo limite em cascata           | `agent.prompt.cascade_timeout_seconds`    |
| Modelo de TTS                     | `tts.model_id`                            |
| Modo expressivo                   | `tts.expressive_mode`                     |
| Provedor de ASR                   | `asr.provider`                            |

O limite de tokens (`agent.prompt.max_tokens`) mantém seu valor armazenado, mas os nós de workflow não podem substituí-lo, e o Eleven Realtime v1 Max exige um valor mínimo. Consulte [Limitações](#limitations).

Para alterar qualquer uma dessas configurações, mude o agente para Personalizado.

## Configurações que ainda se aplicam

Todas as outras configurações do agente funcionam como no modo Personalizado, incluindo:

* o prompt do sistema e a primeira mensagem
* a voz, incluindo [suporte a várias vozes](/docs/pt/eleven-agents/customization/voice/multi-voice-support)
* [idiomas](/docs/pt/eleven-agents/customization/voice/customization/language)
* temperatura
* [ferramentas](/docs/pt/eleven-agents/customization/tools) e a [base de conhecimento](/docs/pt/eleven-agents/customization/knowledge-base)
* configurações de [fluxo de conversa](/docs/pt/eleven-agents/customization/conversation-flow), como iniciativa de turno, tempos limite e interrupções

O dashboard oculta as configurações de LLM, incluindo a temperatura, enquanto o agente está no modo Em tempo real. Use a CLI ou a API para alterar a temperatura em um agente em tempo real.

Se o modelo em tempo real não responder a tempo ou retornar um erro, o agente recorrerá a LLMs de backup, conforme descrito em [LLM em cascata](/docs/pt/eleven-agents/customization/llm/llm-cascading). O modelo em tempo real define quanto tempo o agente espera antes de recorrer a um backup.

## Limitações

A ElevenLabs verifica estas regras quando você publica o agente. Um rascunho que violar uma delas ainda será salvo, mas a publicação falhará com um erro que indica a configuração a ser alterada.

* **Apenas agentes do ElevenAgents**: agentes criados em outros produtos da ElevenLabs, como o [Speech Engine](/docs/pt/eleven-api/guides/cookbooks/speech-engine), não podem usar um modelo em tempo real.
* **Sem LLM personalizado**: o modo Em tempo real não está disponível enquanto o LLM do agente for um LLM personalizado ou o Amazon Bedrock. Selecione um LLM integrado no modo Personalizado antes de mudar.
* **Sem substituições de configurações gerenciadas em workflows**: um nó de workflow não pode substituir nenhuma [configuração gerenciada](#managed-settings) nem o limite de tokens. Remova a substituição ou mantenha o agente no modo Personalizado.
* **Limite de tokens para o Max**: o Eleven Realtime v1 Max precisa de um limite de tokens de 1.024 ou mais, ou sem limite.
* **Transferências entre modos**: um agente no modo Em tempo real só pode [transferir](/docs/pt/eleven-agents/customization/tools/system-tools/agent-transfer) para e receber transferências de outros agentes no modo Em tempo real. Transferências entre agentes Mini e Max são compatíveis.

> **Warning**
>
> A publicação verifica apenas as transferências feitas pelo agente publicado. Uma transferência para um agente em tempo real
> a partir de um agente no modo Personalizado só é identificada quando o agente no modo Personalizado for publicado novamente; até lá,
> a transferência é rejeitada durante a conversa e o agente atual permanece na chamada.

Os erros de transferência exibem `Transfers between default and Realtime model modes are not supported.`, em que "default" significa o modo Personalizado.

## Conformidade e residência de dados

Os modelos em tempo real seguem as mesmas regras de [Modo de Retenção Zero](/docs/pt/eleven-agents/customization/privacy/zrm), [HIPAA](/docs/pt/eleven-agents/legal/hipaa) e [residência de dados](/docs/pt/overview/administration/data-residency) que outros modelos. A disponibilidade varia entre Mini e Max:

| Ambiente                         | Eleven Realtime v1 Mini | Eleven Realtime v1 Max     |
| -------------------------------- | ----------------------- | -------------------------- |
| EUA                              | Disponível              | Disponível                 |
| Residência de dados na UE        | Disponível              | Disponível                 |
| Residência de dados na Índia     | Disponível              | Não disponível             |
| Residência de dados em Singapura | Disponível              | Não disponível             |
| Modo de Retenção Zero e HIPAA    | Não disponível          | Disponível nos EUA e na UE |

O Modo de Retenção Zero se aplica independentemente de ser imposto no workspace ou ativado no agente.

Se um modelo em tempo real não estiver disponível nas configurações de conformidade ou residência de dados do agente, a ElevenLabs o rejeitará com um erro que indica o modelo. Escolha o outro modelo em tempo real ou mude para Personalizado.

## Preços

Um agente em tempo real é cobrado pela tarifa padrão por minuto do ElevenAgents, mais os tokens de entrada, entrada em cache e saída nas tarifas do modelo em tempo real. O Eleven Realtime v1 Max custa mais por token que o Eleven Realtime v1 Mini. Consulte os [preços da ElevenLabs](https://elevenlabs.io/pricing) para ver as tarifas atuais.

## Recursos relacionados

* [Modelos](/docs/pt/eleven-agents/customization/llm)
* [LLM em cascata](/docs/pt/eleven-agents/customization/llm/llm-cascading)
* [Transferência de agente](/docs/pt/eleven-agents/customization/tools/system-tools/agent-transfer)
* [Modo de Retenção Zero](/docs/pt/eleven-agents/customization/privacy/zrm)
* [Conformidade com a HIPAA](/docs/pt/eleven-agents/legal/hipaa)