Como criar um agente de IA fixo em um documento para tarefa recorrente
Por Pedro Mafra Mendes · 4 min de leitura
Para uma tarefa que se repete toda semana, o melhor agente de IA é um documento. Você escreve em um Google Doc ou em um arquivo .md o objetivo, o contexto, as regras, o passo a passo, a conferência e o que entregar no fim. O gatilho vira uma frase: "leia o documento X no meu Drive e execute".
Por que repetir o pedido toda semana dá errado
O jeito mais comum de usar IA em tarefa recorrente é reescrever o pedido toda vez. Segunda-feira você abre o chat e escreve "analisa a venda da semana e me diz o que está parado". Na semana seguinte escreve de novo, com outras palavras, esquecendo um detalhe. O resultado muda de uma semana para outra, e você não sabe se mudou porque o negócio mudou ou porque o pedido mudou.
Quando a instrução fica em um arquivo, ela para de depender da sua memória e do seu humor naquela manhã. O documento é o agente: ele tem um objetivo, um passo a passo, e a IA repete o ciclo até chegar no objetivo.
As partes de um agente fixo
O documento que uso como modelo tem estas seções:
- objetivo: o que o agente precisa entregar, em uma ou duas frases;
- contexto do negócio: o que a IA precisa saber sobre a empresa para a análise fazer sentido (categoria, sazonalidade, o que é normal);
- entradas e saídas: de onde vem o dado e onde o resultado tem que parar;
- regras: definições, unidades e proibições, como "não invente número; se faltar dado, escreva sem dados";
- passo a passo: a sequência do trabalho, na ordem;
- conferência: o que checar antes de entregar, com a instrução "se não bater, corrige e confere de novo";
- o que entregar no fim: o link do arquivo, os totais e o que foi conferido.
A seção de regras parece burocracia, mas é ela que dá confiança no resultado. Sem "não invente número", a IA preenche lacuna com algo plausível. Sem a unidade definida, ela mistura peça com real.
O gatilho pode ser uma frase ou um horário
Com o documento pronto, disparar o agente fica trivial. Você pode escrever "leia o documento Análise semanal no meu Drive e execute" ou colocar essa frase em um agendamento para toda segunda às 7h.
Tem uma vantagem que pouca gente percebe: como a instrução está no arquivo, e não na conversa, ela funciona igual no Claude, no Codex ou em outro modelo. Se amanhã você trocar de ferramenta, o agente vai junto. Se um colega precisar fazer a mesma análise, você compartilha o documento.
Quando fixar o passo a passo
Um agente tem liberdade para escolher o caminho até o objetivo. Para muita coisa isso é bom. Para dado crítico, é um risco, porque o agente pode seguir um caminho nesta semana e outro na próxima, e o número muda sem que nada no negócio tenha mudado.
Por isso, se o resultado vai para uma decisão de compra, de preço ou para a diretoria, fixo o passo a passo no documento com detalhe: qual coluna usar, qual fórmula, em qual ordem. A liberdade fica para a parte de interpretação, e o cálculo fica escrito e igual toda vez.
Um exemplo com estoque de moda
Para ensinar o método, uso uma loja de moda feminina fictícia com 16 produtos. O agente analista tem como objetivo apontar ruptura e encalhe. A regra de cálculo está escrita no documento:
- cobertura em semanas é o estoque atual dividido pelas unidades vendidas na semana;
- abaixo de duas semanas de cobertura, risco de ruptura;
- acima do limite definido, encalhe.
Com o documento, a IA calculou a semana inteira: receita, peças vendidas e tíquete médio. Na saída, apontou os produtos em risco e sugeriu um pedido para antecipar os itens que iam faltar. Cada número veio com a conferência descrita no documento, batendo a receita contra a soma da planilha.
O mesmo documento, apontado para a base real de uma loja, faz a mesma análise toda segunda, do mesmo jeito.
Perguntas frequentes
Preciso saber programar para criar um agente fixo?
Não. O agente é um documento em texto comum, em Google Doc ou .md. O que importa é escrever com clareza o objetivo, as regras e o passo a passo.
O agente em documento funciona em qualquer IA?
Funciona em qualquer modelo que consiga ler o arquivo e acessar as fontes de dado. Como a instrução está no documento, você troca de ferramenta sem reescrever o agente.
Qual a regra mais importante do documento?
A que proíbe inventar número e manda escrever "sem dados" quando faltar informação. É ela que impede o agente de entregar algo plausível e errado.