O que é
O agente trabalha dentro dos sites com uma regra simples: toda mudança tem volta, e o que não tem volta simples espera você. Arquivo alterado vira uma entrada que se desfaz sozinha; comando, WP-CLI ou SQL que muda algo só roda com um ponto de restauração recente (código + banco); e, se a chave pedir, a ação destrutiva só acontece depois do seu “sim” no painel.
Sempre como o usuário do site
Dentro de um site, o agente roda como o usuário Linux daquele site, nunca como root. Ele alcança o que o próprio site alcança: os arquivos dele e o banco dele, com a senha dele. Um site não enxerga o vizinho, e o agente também não.
Para investigar, existe o modo leitura: o comando roda com a pasta do site montada só para
leitura, sem rede, sem banco e sem acesso a Redis ou PHP-FPM. Dá para procurar, listar e conferir
sintaxe (grep, find, php -l) sem como mudar nada.
Desfazer arquivo por arquivo
Cada arquivo que o agente escreve, move ou apaga gera uma entrada no diário de desfazer, com o conteúdo anterior guardado. Desfazer uma entrada volta só aquele arquivo, byte a byte, com as permissões de antes. Peça ao agente “desfaz a última mudança” ou “volta o arquivo X”.
Apagar nunca apaga: o arquivo vai para a quarentena do site (.gws-quarentena/).
Ponto de restauração antes de mudar
Comando, WP-CLI ou SQL que altera o site exige um ponto de no máximo 60 minutos. Se não houver, o servidor cria sozinho e o agente repete o pedido quando o ponto fica pronto.
| O que entra | o código do site e o banco inteiro (ficam de fora uploads, caches, logs e a quarentena) |
| Quantos | até 5 por site, guardados por 3 dias |
| Espaço | só cria se houver livre o dobro do tamanho do site + 1 GB |
| Restaurar | antes, o painel guarda um ponto do estado atual: a restauração também se desfaz |
A senha do usuário do banco também volta ao estado do ponto, para o site não perder a conexão quando a senha foi trocada depois.
A aba Pontos de restauração
Em Configurações → Automação/MCP (Beta) → Pontos de restauração você vê os pontos que o agente criou e restaura sem depender dele. É o caminho se a conversa com o agente acabou e o site ficou diferente do que você queria.
Para o backup tradicional, de longo prazo, continue usando o backup do site: o ponto de restauração é uma rede de segurança de curto prazo, não substitui o backup.
Aprovação do dono
Com Exigir a minha aprovação ligado na chave (obrigatório para Acesso total sem lista de IPs), estas ações param e esperam:
- ações destrutivas do painel (excluir site, restaurar backup, importar banco, virar DNS…);
- comando, WP-CLI e SQL que alteram o site;
- restaurar um ponto.
O pedido aparece no topo da Automação, no cartão Aprovações pendentes, com o resumo do que o agente quer fazer, a chave e a origem. Você recebe também um e-mail (com o SMTP configurado).
- Leia o resumo. Aprove só o que você entende.
- Clique em Aprovar ou Negar. Negar não muda nada no servidor, e o agente é avisado.
- Aprovado, o agente repete o mesmo pedido e ele é executado.
A aprovação vale para aquele pedido exato: aprovar “excluir a.com” não exclui b.com. Ela é de uso
único e vale 30 minutos depois de aprovada; pedido sem resposta expira em 1 hora.
Na API para automações, a ação que precisa de aprovação responde
HTTP 409 com um approval_id. Depois de aprovada, repita a chamada com o cabeçalho
X-GWS-Approval contendo esse id.
Ações longas
Operação que passa de ~20 segundos (WP-CLI que muda, criar ou restaurar ponto, instalações) vira um job que roda à parte e sobrevive até a um reinício do PHP. O agente acompanha o job até o fim e lê o log.
Problemas comuns
- Mudei um arquivo e o site não mudou: arquivo estático (CSS, JS, imagem) pode levar até 2
minutos para mudar na resposta, pelo cache de arquivos do nginx; página do WordPress pode estar no
cache de página. Arquivo
.phpleva até 60 segundos (cache de código do PHP). - “Sem espaço para o ponto de restauração”: libere disco ou faça a mudança pelo painel. Ver Uso de recursos e disco.