P. Mafra MendesConversar

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.

Leia também