Como funciona

Nesta página

Você não precisa desta página para usar seu agente — mas se você é a pessoa a quem sua organização pergunta "onde os dados realmente ficam?", isto é para você.

A forma do sistema

Três partes:

  1. O dispositivo — onde o agente e seus serviços de suporte executam. Todos os dados do agente (conversas, memória, arquivos, wiki, configurações) ficam aqui. É um AI Agent Processor em sua instalação (um Physical Agent) ou uma Cloud Agent Instance na região que você escolheu (um Cloud Agent).
  2. Performance Hub — o plano de gerenciamento. Adição de agentes, controle de acesso, orçamentos, configuração de backups e atualizações são decididos aqui e entregues ao dispositivo.
  3. Serviços em nuvem que o dispositivo consome — modelos de IA (através da conta do Model Router da sua instalação), armazenamento de backup criptografado nas regiões escolhidas e entrega de notificações por push.

O princípio orientador: seus dados permanecem no dispositivo do seu agente; a nuvem fornece inteligência, backup e alcance.

Physical Agents e Cloud Agents

Ambos os tipos de agente executam o mesmo software e são gerenciados da mesma maneira no Performance Hub. A diferença é onde o dispositivo está localizado:

Physical AgentCloud Agent
Executa emUm AI Agent Processor em sua instalação (o hardware)Uma Cloud Agent Instance na região que você escolher ao adicioná-la
Adicionado porPareamento com seu número de série ou código QRInicialização a partir de Add Cloud Agent — sem pareamento
Onde os dados ficamEm hardware que você controla fisicamenteNo disco da instância na Cloud region escolhida
Conexão a partir do seu navegadorDireta (rede local) quando você está no local, caso contrário, Cloud relayCloud relay
CustoO AI Agent Processor é fornecido como parte do produtoCobrado pelo tamanho da instância e recursos provisionados
Se falharSubstitua o hardware e restaure a partir do backupRemova-o e inicie um novo Cloud Agent a partir de um backup

Os backups de um Cloud Agent vão para a mesma região do agente por padrão, portanto, seus dados permanecem em um único lugar, a menos que você escolha outras regiões de armazenamento.

Rede apenas de saída

Um Physical Agent faz apenas conexões de saída — conexões de internet comuns e criptografadas feitas a partir da sua rede. Ele nunca exige uma porta de entrada aberta, encaminhamento de porta ou alterações de firewall. Se a sua rede consegue navegar na web, o dispositivo pode fazer o seu trabalho.

É assim também que o Performance Hub alcança o dispositivo: o dispositivo se conecta a um relay do Performance Hub e mantém essa conexão segura aberta, e o gerenciamento e o acesso remoto retornam por ela. Os Cloud Agents se conectam da mesma forma. O relay ao qual o dispositivo está ancorado é exibido como Região de relay em Gerenciamento de dispositivos.

Como o seu navegador alcança o agente

Quando você abre o módulo do AI Agent, o que você vê é a própria interface web do agente, fornecida pelo dispositivo. Seu navegador se conecta pelo melhor caminho disponível, e a parte superior do módulo mostra qual é (por exemplo, Cloud relay com a cidade do relay):

O cabeçalho mostraCaminhoQuando
Direct (local network)Navegador → dispositivo, diretamente pela sua LANVocê está na mesma rede que um Physical Agent — mais rápido
Cloud relayNavegador → relay mais próximo → dispositivoVocê está remoto — o caminho normal de qualquer lugar
via Performance HubNavegador → Performance Hub → dispositivoAlternativa caso o caminho do relay esteja indisponível

O módulo os testa nessa ordem automaticamente; você nunca escolhe. Todos os três caminhos são criptografados de ponta a ponta e todos os três carregam a sua identidade do Performance Hub, para que o agente saiba sempre com quem está falando e o controle de acesso seja aplicado de forma idêntica em todos os caminhos.

As sessões com o dispositivo usam credenciais de curta duração emitidas pelo Performance Hub quando você abre o módulo — não há senhas permanentes para o dispositivo, e o acesso revogado no Performance Hub entra em vigor quando a sessão curta atual expira ou a página é recarregada.

Como o agente obtém modelos de IA

A inteligência do agente vem de modelos de IA fornecidos por meio da conta do Model Router da sua instalação. No dispositivo, um pequeno serviço de proxy fica entre o agente e a nuvem:

  • O agente vem pré-configurado com uma seleção de modelo auto — o Performance Hub direciona cada solicitação para um modelo adequado, e as melhorias são lançadas sem que você precise reconfigurar nada.
  • O dispositivo se autentica com credenciais de curta duração emitidas pelo Performance Hub. Não há nenhuma chave de API de longa duração armazenada no dispositivo — nada que continuaria útil caso o hardware fosse roubado.
  • Cada solicitação é medida em relação à chave de gastos do próprio agente, que é a forma como Budgets & limits são aplicados — de forma centralizada, no lado do Performance Hub, e não com base na confiança.

Como o agente acessa os dados do Performance Hub

O acesso do agente aos seus dados comerciais funciona da mesma maneira, via MCP (Model Context Protocol):

  • As chamadas de MCP do agente vão para o Performance Hub pela mesma conexão segura, autenticadas com as mesmas credenciais de curta duração.
  • No lado do Performance Hub, o dispositivo atua como uma conta de serviço cujos escopo e capacidades são exatamente aqueles que você concedeu em Conectando-se ao Performance Hub. Cada chamada é autorizada centralmente com base nessa concessão.
  • Alterar ou revogar a concessão entra em vigor em instantes — o dispositivo não possui credenciais independentes para os seus dados.

Como os backups fluem

Um serviço de backup no dispositivo tira capturas instantâneas criptografadas a cada hora e as envia diretamente para o armazenamento em nuvem nas regiões escolhidas — criptografadas no dispositivo antes do envio, com a chave de criptografia mantida pelo Performance Hub para a sua instalação (nunca armazenada no backup em si). Os backups são incrementais e deduplicados, portanto, a frequência horária permanece leve. Detalhes em Backups.

Como as atualizações funcionam

O dispositivo executa uma pilha de software gerenciada, atualizada como um todo:

  • As novas versões são enviadas para o dispositivo automaticamente, mas retidas até que você clique em Atualizar agora ou Agendar um horário — o dispositivo nunca é reiniciado sozinho sem aviso prévio.
  • As atualizações substituem o software, não os dados: o estado do agente reside em uma área de dados persistente que é mantida em cada atualização.
  • Se você nunca tocar no banner, o dispositivo simplesmente continuará executando a versão atual. Dito isso, recomendamos manter os dispositivos na versão mais recente — cada atualização é rigorosamente testada antes de ser lançada, e manter-se atualizado garante que você sempre tenha os recursos e correções mais recentes.

Se a internet cair

  • Você na instalação, com um Physical Agent: o caminho Direct (local network) continua funcionando — você ainda pode abrir e usar o agente pela sua LAN, embora ele não possa chamar modelos de IA (portanto, não consegue processar novas solicitações) até que a conectividade retorne.
  • Backups e notificações entram na fila e são retomados quando a conexão é restabelecida.
  • Gerenciamento do Performance Hub (painel lateral, configurações, atualizações) precisa do dispositivo on-line e se reconecta automaticamente.

Se o hardware falhar

Os backups são a solução: os pontos de restauração na nuvem continuam navegáveis e passíveis de download mesmo com o dispositivo inoperante, e Replace this device configura uma nova unidade a partir do backup mais recente da antiga — perdendo tipicamente no máximo uma hora de estado. Um Cloud Agent pode ser inicializado da mesma maneira, com Restaurar de um backup ao adicioná-lo. Consulte Restauração e recuperação.