Restauração e Recuperação

Backups capturam o estado do seu agente a cada hora. Esta página cobre a outra metade: trazer as coisas de volta — desde recuperar um arquivo excluído acidentalmente, reverter todo o agente para o estado de ontem, até colocar em funcionamento um dispositivo novo com tudo o que um dispositivo com falha tinha.

Tudo aqui começa na aba Backups em Gerenciamento de dispositivos.

Referência rápida

Uma propriedade tranquilizadora do design: "Um instantâneo de segurança é tirado automaticamente primeiro, de modo que esta restauração pode ser desfeita." Restaurar nunca é uma via de mão única — você pode sempre desfazer até o momento anterior.

Navegando dentro de um ponto de restauração

Clique em Browse files em qualquer ponto de restauração para abrir Browse backup — uma visualização somente leitura dos arquivos do agente exatamente como estavam naquele momento, com a hora e a região do ponto de restauração no título.

Figura 1: Navegando pelo workspace dentro de um ponto de restauração

No navegador, você pode:

• Alterne entre as áreas Workspace, Wiki e Data, e navegue pelas pastas. Ative Show system files & folders para ver também os arquivos de sistema do agente.
• Pesquise por nome de arquivo dentro do ponto de restauração ou clique em All restore points para "Pesquisar em todos os pontos de restauração — encontra arquivos que foram excluídos ou alterados desde este backup."
• View um arquivo, Download dele (ou de uma pasta, com Download as archive) diretamente para o seu computador — útil quando você só precisa ver uma versão antiga sem restaurar nada.
• Restore to device — coloque um arquivo ou pasta de volta no agente, no lugar. Use Select multiple items para restaurar vários de uma vez.
• Copy link to this location — compartilhe um link que abre o navegador no mesmo lugar.

Arquivos que possam conter chaves ou credenciais são sinalizados antes de você baixá-los, pois os downloads são descriptografados.

A navegação funciona mesmo quando o dispositivo está off-line ou inativo — os backups ficam na nuvem, portanto, uma falha no dispositivo não impede que você leia (ou baixe) tudo o que ele continha. É também assim que você extrai dados antes de uma substituição.

Histórico de versões de um único arquivo

Para qualquer arquivo no navegador, Version history lista todos os pontos de restauração em que esse arquivo foi alterado, com registros de data/hora e tamanhos, para que você possa retroceder um documento no tempo e escolher exatamente a versão desejada.

Figura 2: Histórico de versões de um único arquivo em todos os pontos de restauração

Cada versão pode ser visualizada, baixada, comparada com a versão anterior (Compare with the previous version) ou restaurada com Restore this version to the device.

O que mudou entre os pontos de restauração

What changed em um ponto de restauração lista os arquivos que foram adicionados, alterados ou removidos desde aquele backup.

Figura 3: O que mudou desde um ponto de restauração

Use-o para responder "quando este arquivo desapareceu?" ou para verificar o que uma restauração reverteria. Open in file browser vai diretamente para um arquivo no ponto de restauração. As comparações funcionam entre pontos de restauração armazenados na mesma Região.

Restaurando

Clique em Restore to this point em um ponto de restauração para abrir Restore this agent. A caixa de diálogo informa para quando o agent será revertido e o que mudou desde então.

Figura 4: Restaurar este agent — escolha tudo ou apenas áreas selecionadas

Em What to restore, escolha:

• Everything — "memory, chats, workspace files e installed tools são todos substituídos pelo backup; tudo o que foi criado desde então é removido. O agente é reiniciado."
• Only selected areas — "o restante do dispositivo permanece inalterado e o agente continua funcionando." Escolha as áreas para reverter, como os arquivos do workspace ou a wiki.

Para restaurar tudo:

1. Selecione Everything.
2. Opcionalmente, marque Also restore the software version from this backup, para que os dados e o software do agente retornem juntos — útil quando ferramentas ou qualquer personalização no agente pararam de funcionar corretamente.
3. Em Type the device name to confirm:, digite exatamente o nome do agente.
4. Clique em Restore.

Um ponto de restauração de Safety é criado automaticamente primeiro. O agent para brevemente enquanto os dados são substituídos e, em seguida, retorna ao estado restaurado.

Se o backup estiver armazenado em mais de uma Região, escolha Restore from region — "As cópias são idênticas — escolha qualquer Região para restaurar."

Arquivos individuais

No navegador de arquivos (acima), restaure qualquer seleção de arquivos específicos de volta aos seus lugares — a opção mais cirúrgica, para quando apenas um documento apresentou problemas.

Acompanhando uma restauração

Enquanto uma restauração é executada, um banner na parte superior do módulo exibe o progresso — por exemplo, Restaurando arquivo... ou Restaurando este agent..., indicando o que já foi restaurado e o que falta.

Figura 5: Restauração de arquivo emandamento

Quando ele termina, o banner exibe "The last file restore completed successfully." ou "The agent was restored successfully." Após uma restauração completa, o agente é reiniciado: "The backup has been restored. The agent is starting its services back up — this takes about a minute."

Desfazer esta restauração

Após a conclusão de uma restauração completa, Undo this restore — "Rewinds the agent to the automatic safety snapshot taken just before this restore — undoing it." Se uma restauração se mostrar incorreta, nada é perdido.

Substituindo um dispositivo

Se um AI Agent Processor falhar, Replace this device (na parte inferior da guia Configuração) transfere tudo para uma nova unidade. "The replacement takes over this device’s name, settings, access and backup history. The old device is decommissioned and can no longer connect."

Figura 6: Replace this device — escolher um ponto de restauração

O diálogo orienta você pelas etapas da substituição: primeiro, você insere o número de série ou ID de dispositivo do dispositivo de substituição; depois, escolhe o que deseja restaurar nele e, por fim, confirma.

1. Ligue o novo dispositivo e coloque-o on-line — ele deve estar não pareado e acessível.
2. Clique em Replace this device, insira o número de série ou o ID de dispositivo do dispositivo de substituição (a partir do adesivo de QR code ou da etiqueta na parte inferior ou traseira da unidade) e clique em Next.
3. Na segunda etapa (Figura 6), mantenha a opção Restore a backup onto the new device marcada e escolha um Restore point na lista (por padrão, o backup mais recente). Opcionalmente, marque Also pin the software to the version from this restore point e clique em Next.
4. Em Type the device name to confirm:, digite o nome do dispositivo antigo exatamente como exibido e clique em Replace device.

Observação: "This cannot be undone. The old device is decommissioned immediately and any data on the replacement is overwritten."

O diálogo exibe o progresso enquanto o novo dispositivo assume o controle e restaura o backup; clique em Continue in background se não quiser esperar. Quando terminar: "Device replacement complete — the new device is ready." Os pontos de restauração do dispositivo antigo permanecem disponíveis na guia Backups, marcados como Previous device, para que nada fique órfão.

Como os backups são executados a cada hora, uma falha de hardware normalmente custa no máximo uma hora do estado do agente.

Removendo um dispositivo

Remove & reset device (na parte inferior da guia Configuração) retira um Physical Agent da sua instalação.

Figure 7: Remove & reset device — o que acontecerá e o que acontece com os backups

O diálogo explica o que acontece:

• "The device is removed from this facility and loses all access."
• "All data on the hardware is erased and it returns to its pairing screen, ready to be added to any facility."
• Se o agente hospedar Published Apps, elas serão listadas: "Removing this agent will take those apps offline. Anyone using them will lose access."

Escolha o que acontece com os backups:

Clique em Next e confirme:

Figura 8: Digite o nome do agente para confirmar a remoção

1. Em Type the name of the agent exactly as shown (case sensitive):, digite o nome do agente. "The name must match exactly, including capital letters."
2. Clique em Remove & reset device.

Com um backup final, "A final backup runs first and can take several minutes. The device is only erased after it confirms the backup completed." Se o backup final não puder ser concluído, nada será removido e você poderá escolher como continuar: Retry the backup, Remove without a backup ou Keep this agent. Se o dispositivo estiver off-line, ele será removido agora e se apagará na próxima vez que for ligado e conectado.

Suas credenciais (conexão com o Performance Hub, acesso a modelos, chaves de notificação) são revogadas assim que ele é removido. Os backups mantidos permanecem no armazenamento em nuvem sob sua instalação e podem alimentar um agente futuro — seja por meio de Replace this device ou com Restore from a backup ao adicionar um agente. Eles expiram de acordo com sua configuração de retenção normalmente.

A remoção é o caminho correto ao aposentar hardware, devolver uma unidade ou desativar um agente de que você não precisa mais. Se estiver movendo o agente para um hardware diferente na mesma instalação, use Replace this device — "it carries the name, settings and backups over."

Removendo um Cloud Agent

Para um Cloud Agent, use Delete this cloud agent em vez disso. Isso remove a Cloud Agent Instance e o registro do agente nesta instalação, com a mesma opção sobre o que acontece com seus backups. "The Cloud Agent Instance and disks are removed. This cannot be undone."

Páginas relacionadas

• Backups — frequência, retenção, fixação e regiões
• Introdução — adição de um agente, incluindo Restaurar de um backup
• Device management — a aba Configuração
• Solução de problemas