Gerenciamento de dispositivos

Nesta página

Tudo sobre o dispositivo por trás do seu agente — um AI Agent Processor para um Physical Agent ou uma instância de Cloud Agent para um Cloud Agent — é gerenciado na parte superior do módulo AI Agent e na gaveta Device management.

O seletor de agentes e a barra de métricas

A parte superior do módulo está sempre visível:

  • O seletor de agentes à esquerda lista todos os agentes na Instalação com um ponto de status (verde quando On-line), sua localização, um ícone de nuvem para Cloud Agents e um ícone de cadeado para agentes que você não pode abrir. Escolha um agente para alternar para ele ou escolha Add Agent para adicionar outro — consulte Getting started.
  • Ao lado dele, o status de conexão mostra como seu navegador está alcançando o agente: Direct (local network), Cloud relay com a cidade do relay ou via Performance Hub. Consulte How it works.
  • A barra de métricas exibe chips compactos para CPU, Memory, disco, temperatura e tempo de atividade (uptime), além de um chip de VPN quando o agente possui uma conexão VPN. Os chips ficam âmbar em 75% e vermelhos em 90% (temperatura: 75 °C e 85 °C), para que os problemas fiquem visíveis rapidamente. Até que um novo agente esteja on-line, você verá "As métricas aparecerão assim que o agente estiver on-line."
  • Os botões à direita abrem Connected Apps, a Skill Library e a gaveta Device management.

Quando o agente detecta um problema com seu dispositivo, um banner de integridade aparece abaixo da barra de métricas, com a opção View report para abrir a seção Device diagnostics. Consulte Troubleshooting.

A gaveta Device management

A gaveta possui seis abas — Overview, Budgets & limits, Backups, Published Apps, VPN e Configuration — além de um cabeçalho que está sempre visível:

  • O nome do dispositivo, com seu ID de dispositivo exclusivo logo abaixo.
  • Indicadores de status: On-line ou Off-line, Tunnel connected ou Tunnel down, a conexão VPN quando houver uma e um horário de Last seen.
  • Botões Close e Save changes na parte inferior. A maioria das configurações só é aplicada após você clicar em Save changes.

A aba VPN aparece assim que o suporte a VPN é ativado (consulte a aba VPN).

Aba Overview

Aba Overview do Device management com métricas em tempo real, armazenamento, conexão e detalhes de software para o Front Office AgentAba Overview do Device management com métricas em tempo real, armazenamento, conexão e detalhes de software para o Front Office Agent

Figura 1: A aba Overview para um Physical Agent — métricas em tempo real, armazenamento, conexão e software

Métricas em tempo real

Leituras em tempo real do dispositivo, atualizadas automaticamente:

MétricaObservações
CPU usageBarra de porcentagem
MemoryMemória usada e total, com Swap e Available RAM abaixo
CPU temperatureO AI Agent Processor não possui ventoinha; leituras quentes sob carga são normais
UptimeTempo desde a última inicialização do dispositivo, por exemplo, 19d 0h

Enquanto o dispositivo estiver off-line, você verá *"As métricas ficam indisponíveis enquanto o dispositivo estiver off-line."*j

Armazenamento

  • Your data — quanto do espaço utilizável do dispositivo os dados do seu agente ocupam (usado e disponível).
  • System (OS + reserved) — espaço usado pelo sistema operacional do dispositivo.
  • Device total — a capacidade total do dispositivo.

Tudo em Your data também é protegido por backups em nuvem.

Conexão

LinhaSignificado
Relay regionA região do relay em nuvem à qual o dispositivo está ancorado (por exemplo, syd)
Public IPO endereço de internet apresentado pelo dispositivo (Physical Agents)
Local IPO endereço do dispositivo na sua rede local (Physical Agents)
NetworkComo o dispositivo está conectado — Ethernet ou Wi‑Fi (Physical Agents)
Wi-Fi networkExibido quando um Physical Agent está no Wi‑Fi
Cloud regionOnde um Cloud Agent é executado, por exemplo, Sydney, Austrália

Software

  • Agent version, Host OS e a versão do software do dispositivo — o software em execução no dispositivo.
  • Status da atualização:
    • "The agent is up to date." — nada a fazer.
    • "A new update is available." com um link Update now.
    • "An update is being applied. The agent will restart shortly." — enquanto uma atualização é instalada.

Identidade

  • Deployment — exibido para Cloud Agents.
  • Location — onde você registrou o dispositivo como instalado.
  • Model — o modelo de hardware (consulte O hardware).
  • Serial number — corresponde à etiqueta no dispositivo.
  • Facility — a instalação à qual o agente pertence.
  • Compliance details — abre a janela de conformidade do AI Agent Processor.

Agentes em Nuvem

A aba Visão geral (Overview) de um Cloud Agent possui as mesmas seções, com os detalhes relevantes para uma instância em nuvem: a Cloud region em que ele é executado e seu tamanho em Connection, e Cloud como seu deployment e localização em Identity.

Visão geral do Device Management para o Retail Ops Cloud Agent mostrando sua região de nuvem e tamanhoVisão geral do Device Management para o Retail Ops Cloud Agent mostrando sua região de nuvem e tamanho

Figura 2: A aba Visão geral (Overview) para um Cloud Agent — região da nuvem e tamanho em Connection

Atualizações de software

As atualizações são entregues automaticamente ao dispositivo, mas você decide quando elas serão aplicadas — o dispositivo mantém sua versão atual até que você atualize agora ou agende um horário.

Quando uma nova versão estiver disponível, um selo compacto Update available aparecerá na barra na parte superior do módulo, com os botões Schedule e Update now.

Pílula de atualização disponível na parte superior do módulo, com os botões Schedule e Update nowPílula de atualização disponível na parte superior do módulo, com os botões Schedule e Update now

Figura 3: O selo de atualização disponível

  • Update now inicia a atualização imediatamente. O agente é reiniciado brevemente durante a aplicação; você verá mensagens de fase (Downloading update…, Installing update…, Restarting AI Agent…) com uma barra de progresso.
  • Schedule abre a janela Schedule update.

Caixa de diálogo de agendamento de atualização com Hoje às 2:00, Amanhã às 2:00 e um horário personalizadoCaixa de diálogo de agendamento de atualização com Hoje às 2:00, Amanhã às 2:00 e um horário personalizado

Figura 4: Agendamento de uma atualização — uma predefinição de um clique ou um horário personalizado

Para agendar uma atualização:

  1. Clique em Schedule no selo Update available.
  2. Escolha Tonight at 2:00 AM ou Tomorrow at 2:00 AM, ou selecione uma data no calendário e um horário em Install at (escolha Custom time… para um horário que não esteja na lista).
  3. Clique em Schedule update.

A janela observa: "Times are in your local timezone. The install may start up to 5 minutes after the scheduled time." Uma atualização agendada passa a ser exibida como Update scheduled for na data e hora definidas, com Cancel schedule e Update now disponíveis a qualquer momento antes da execução.

Os dados do seu agente não são afetados pelas atualizações — conversas, memory, arquivos e habilidades persistem entre as versões.

Bloqueio de atualizações

Em Configuration → Actions, você pode selecionar Lock updates — "The device will hold its current release and skip automatic updates until unlocked. Continue?" Use esta opção caso precise que o dispositivo permaneça exatamente como está (por exemplo, durante um período comercial importante). Unlock updates retoma o comportamento normal.

Aba Configuração

Guia de configuração com nome do dispositivo, local, reinicialização agendada e notificações do navegadorGuia de configuração com nome do dispositivo, local, reinicialização agendada e notificações do navegador

Figura 5: A parte superior da aba Configuração — configurações do dispositivo e Notificações do navegador

Configurações do dispositivo

ConfiguraçãoObservações
Device nameO nome exibido em todo lugar — no seletor de agentes, Notificações e confirmações
Device location"Onde o dispositivo físico está instalado na sua instalação." Texto livre com sugestões; até 64 caracteres
Scheduled rebootDisabled (padrão), Daily, Weekly ou Monthly. "Reboots run at 2am local time on the device."
Browser notificationsIndica se este navegador recebe uma notificação quando o agente conclui uma solicitação. Exibe Enabled in this browser, Not enabled ou Blocked in this browser com How to unblock. Consulte Notificações

Uma reinicialização periódica é opcional — o dispositivo foi projetado para operação contínua —, mas uma reinicialização semanal ou mensal é uma medida de higiene razoável, caso prefira.

A aba Configuração também contém Access Control (consulte Access control), MCP access (consulte Connecting to Performance Hub), Cloud backup (consulte Backups) e VPN support (abaixo).

Ações

"As ações remotas são enviadas para o dispositivo por meio do seu túnel seguro." Cada ação solicita confirmação antes de ser executada e exibe "Comando enviado para o dispositivo." em caso de sucesso.

AçãoO que ela faz
Reiniciar dispositivo"O AI Agent será reiniciado e ficará indisponível brevemente. Continuar?"
Bloquear atualizaçõesMantém a versão atual do software (consulte acima)
Desbloquear atualizaçõesRetoma a aplicação das atualizações disponíveis
Mover para outra instalaçãoRequisita o registro do dispositivo em uma instalação diferente na sua organização

Como mover um dispositivo: escolha a Instalação de destino e clique em Mover dispositivo. A caixa de diálogo avisa — "O histórico de backup e a chave de gastos de IA permanecem na instalação atual. Um novo histórico de backup e uma nova chave de gastos (com os budgets padrão) serão iniciados na nova instalação." O dispositivo em si, seu nome, suas configurações e sua configuração de acesso mudam com ele; o histórico de backup permanece disponível na instalação original.

Substituir ou remover este dispositivo

A parte inferior da aba Configuração, Replace or remove this device, gerencia o ciclo de vida do dispositivo:

  • Replace this device — substitua um hardware com falha por um novo AI Agent Processor que assume o nome, as configurações, o acesso e o histórico de backup deste dispositivo. Consulte Restauração e recuperação.
  • Remove & reset device — remova o dispositivo da instalação e redefina-o para a tela de pareamento, com a opção de escolher o que acontece com seus backups. Consulte Restauração e recuperação.
  • Para um Cloud Agent, Delete this cloud agent — *"Remove a instância do Cloud Agent e o registro desta instalação. Os backups em nuvem são mantidos como uma fonte de restauração."*ing

Aba VPN

Uma VPN permite que o agente acesse sistemas dentro de uma rede corporativa ou em nuvem — um servidor de reservas local na matriz, um banco de dados de estoque em um armazém ou uma ferramenta de relatórios interna. Ative o Suporte a VPN na aba Configuração: "Conceda ao agente uma conexão OpenVPN sempre ativa com uma rede corporativa ou em nuvem. A VPN é visível apenas para o agente e suas cargas de trabalho — nada mais no dispositivo pode usá-la. Ativar essa opção adiciona uma aba VPN onde você importa perfis e gerencia conexões." Clique em Save changes e a aba VPN será exibida.

Aba VPN com a conexão de rede da matriz e a área para importar um perfil VPNAba VPN com a conexão de rede da matriz e a área para importar um perfil VPN

Figura 6: A aba VPN — importe um perfil e, em seguida, gerencie sua conexão

Para adicionar uma conexão:

  1. Em Import a VPN profile, arraste e solte seus arquivos OpenVPN na área ou clique nela para procurar. A área aceita perfis .ovpn e .conf com seus certificados e chaves, além de exportações de perfil de clientes VPN comuns (pastas compactadas em zip primeiro). Um arquivo compactado com vários perfis importa todos eles.
  2. Se o perfil exigir credenciais, clique em Editar na conexão e adicione o Nome de usuário e a Senha / PIN, ou a Senha da chave privada para uma chave criptografada.
  3. Clique em Conectar. O status é atualizado à medida que o dispositivo envia relatórios, aproximadamente a cada 30 segundos.

As conexões permanecem ativas sem supervisão, portanto, as credenciais devem ser estáticas — um nome de usuário e senha, um PIN fixo ou uma resposta a desafio fixa, que é armazenada com segurança e retransmitida a cada reconexão. Perfis que exigem um código rotativo (TOTP) ou um login via navegador (SAML) não conseguem manter a conexão sozinhos.

Cada conexão mostra seu status (Connected, Connecting, Disconnected ou Error), servidor, rotas, DNS, há quanto tempo está conectada e tráfego, juntamente com as opções Desconectar, Editar conexão e Excluir conexão. Excluir uma conexão desconecta-a e remove seu perfil e as credenciais armazenadas do dispositivo.

Desativar o Suporte a VPN encerra todas as conexões VPN.

O chip de gastos

Um chip de gastos opcional (por exemplo, "$7,18 restantes") na barra de métricas mostra o valor restante do seu budget mais restrito — ou o saldo da conta se nenhum limite estiver definido. Ative-o com a opção Mostrar no cabeçalho na aba Budgets & limits: "Mostra os gastos restantes com IA como um chip na barra de métricas superior. Apenas você vê isso." Clicar no chip abre a aba Budgets & limits.