Quando a gente cria um agente de IA ou um job agendado, o primeiro alívio vem quando "funcionou": o post saiu, o arquivo foi gerado, o job terminou.
Só que, quando ele começa a rodar sem ninguém olhando, aparece outro tipo de falha. Publicar a mesma coisa duas vezes. Quase escrever na conta errada. Parar sem que ninguém perceba. Entregar ao cliente um arquivo que não deveria estar ali. Funcionar de dia e cair só de madrugada.
Eu rodo uma operação pequena de automação (posts automáticos, distribuição de produtos digitais, jobs noturnos em Python e Claude Code). As cinco falhas abaixo aconteceram comigo, ou quase aconteceram. Não tem exemplo inventado. Para cada uma deixei uma checagem que leva uns 3 minutos.
A ideia que atravessa tudo: coloque o freio no programa, não no prompt. Em vez de pedir para a IA "não enviar duas vezes", o código confere o registro antes de enviar e, se já existe, não envia.
1. Envio duplicado: a mesma escrita acontece duas vezes
O que acontece. O post ou o envio sai duas vezes. Em rede social isso derruba a confiança da conta; em e-mail ou pagamento, causa dano real a outra pessoa.
Por que acontece. O caso clássico é "não sei se enviou". A requisição deu timeout, ou o processo caiu antes da resposta. Do outro lado já tinha sido processado, mas o seu código entende como falha e tenta de novo. Agentes de IA tendem a dizer "falhou, vou tentar de novo" com toda a boa vontade, então esse padrão aparece fácil.
Checagem de 3 minutos
- Você grava "vou enviar isto" antes de enviar? Se só grava depois, uma queda no meio não deixa rastro.
- Quando o resultado é desconhecido (timeout etc.), o job tenta de novo sozinho? O mais seguro é marcar como "desconhecido", parar, e uma pessoa confirmar antes de seguir.
- Se o mesmo conteúdo for enviado de novo, existe algo que olha o registro e bloqueia?
2. Escrever na conta errada
O que acontece. Quem tem várias contas ou projetos acaba escrevendo no lugar errado: trabalho e pessoal, produção e teste.
Por que acontece. O token vem de variável de ambiente ou arquivo de configuração. Se você troca o arquivo ou esquece de mudar, o programa segue em silêncio. Eu tenho duas contas na mesma rede social e uma delas nunca pode publicar nada desta operação; por isso o job confere a identidade antes de cada envio.
Checagem de 3 minutos
- Logo antes de escrever, o job pergunta para a API "quem sou eu?" e para se o ID não for o esperado?
- O ID esperado fica num lugar diferente do token (no código ou numa configuração fixa)? Se os dois ficam no mesmo arquivo, eles se trocam juntos.
3. Parada silenciosa: parou e ninguém percebeu
O que acontece. O job agendado não rodou, e não apareceu erro nem aviso. Quando você nota, faltam dias de processamento.
Por que acontece. Se o job quebra, dá para avisar. Mas um job que nem iniciou não gera erro. No meu caso, a atualização automática do Windows reiniciou o PC de madrugada e as tarefas daquela noite simplesmente não rodaram. Saldo de API acabando também é uma forma de parada silenciosa.
Checagem de 3 minutos
- Além de "registrar quando roda", existe "avisar se ficou X horas sem registro" (monitoramento de vida)?
- Existe aviso antes de acabar o saldo ou a cota de uma API paga?
- Se roda no seu PC, você conferiu o horário de reinício automático e a configuração de suspensão?
4. Arquivo que não deveria estar no entregável
O que acontece. O ZIP ou PDF que você vende ou distribui leva junto notas internas, rascunhos, arquivos de configuração. No pior caso, segredos.
Por que acontece. Compactar a pasta de trabalho inteira leva junto o que está em andamento. Eu fiz uma compra de teste de um kit que já estava à venda e, ao abrir o ZIP recebido, descobri que cerca de metade do conteúdo era material interno do vendedor. Troquei na hora por uma versão só com os arquivos do comprador.
Checagem de 3 minutos
- O entregável é montado a partir de uma lista do que pode entrar, e não da pasta inteira?
- Você recebeu o arquivo pelo mesmo caminho do cliente e conferiu (por hash, por exemplo) se é idêntico ao que gerou?
5. Cai só de madrugada: na mão funciona, no agendador quebra
O que acontece. Rodando você mesmo, tudo certo. Rodando pelo Agendador de Tarefas ou cron de madrugada, falha.
Por que acontece. Pelo agendador mudam a pasta de trabalho, as variáveis de ambiente, a codificação de texto e o usuário logado. No Windows japonês, por exemplo, a saída padrão usa cp932 e o script cai no instante em que tenta imprimir um caractere fora dessa codificação. Foi exatamente o que aconteceu num job meu.
Checagem de 3 minutos
- O script define explicitamente a pasta de trabalho e a codificação (por exemplo
PYTHONUTF8=1)? - Você já disparou o job pelo agendador, de dia, e leu o log?
- Você sabe onde fica o log quando ele cai?
Bônus: limite antes de aumentar o volume
Quando a automação funciona, dá vontade de aumentar a frequência. Só que, quanto mais vezes ela roda, maior o estrago quando uma das cinco falhas acontece. E posts parecidos em intervalos curtos podem ser vistos pela plataforma como abuso de automação; isso aconteceu com a minha conta (o rótulo foi removido depois da revisão).
Defina no código um limite por dia e um intervalo mínimo, e tenha um interruptor que pare tudo de uma vez quando algo parecer errado.
Para levar
Nenhuma dessas falhas some quando a IA fica mais inteligente. Não saber se enviou, não saber com qual conta está logado, não saber que parou: tudo isso se resolve fazendo o sistema parar quando não sabe.
Se quiser uma versão para imprimir, fiz um checklist gratuito em português (PDF de uma página, 25 verificações): Checklist pré-voo de Agent Ops
E se quiser a implementação completa em Python (só biblioteca padrão, 10 capítulos: registro antes do envio, "quem sou eu", monitoramento de vida e de custo, inspeção do entregável, jobs noturnos), o guia está em português: Antes de deixar agentes de IA escreverem sem supervisão
Se você já passou por alguma falha diferente dessas, conta nos comentários. Quero incluir na próxima revisão.
A tradução para o português teve auxílio de IA; os casos são da minha própria operação.
