Agente que executa um fluxo com aprovação humana

Nesta aula

O agente mais confiável que eu conheço não é o mais autônomo. É o que sabe exatamente quando parar e perguntar.

Você já tem as peças: um agente que lê documentos, usa ferramentas, segue instruções, e a noção de como ele se conecta a sistemas. Esta aula junta tudo em um fluxo que faz trabalho de verdade e que você consegue confiar: ler, decidir, registrar e pedir ok. O ponto central é onde a pessoa entra. Colocar gente no lugar errado do fluxo produz duas coisas ruins: um agente que faz estrago sozinho, ou uma pessoa afogada em aprovações que ela não lê. A prática é desenhar o fluxo do seu processo com os pontos de aprovação certos.

• Ao final, você vai saber desenhar um fluxo de agente com as quatro etapas e os pontos de aprovação.
• Vai entender como dimensionar a aprovação para caber na atenção real de quem aprova.
• Vai sair com um entregável: o fluxo do seu processo desenhado, com pontos de aprovação, regra de expiração e o que fica registrado.

As quatro etapas: ler, decidir, registrar, pedir ok

Vou usar como fio condutor um escritório contábil que precisa receber, todo mês, os extratos bancários de 80 clientes até o dia 5. Hoje uma pessoa passa dois dias cobrando por mensagem. O fluxo do agente:

1. Ler

O agente lê a lista de clientes e a pasta (ou sistema) onde os extratos chegam. Percebe quem já enviou e quem falta. Lê também o histórico: quem costuma atrasar, quem já recebeu lembrete este mês. É a etapa de perceber da aula 1, agora com ferramentas de verdade (arquivo exportado ou conector, como na aula 8).

2. Decidir

Com as regras da instrução, o agente classifica cada cliente: já enviou (nada a fazer), falta e é o primeiro lembrete (lembrete padrão), falta e já recebeu um lembrete (segundo lembrete, tom um pouco mais direto), falta há três meses seguidos (caso para a contadora). As regras são "se X, faça Y", como na aula 6.

3. Registrar

Antes de qualquer ação, o agente escreve o que leu e o que decidiu em um lugar que uma pessoa consegue ler: uma linha por cliente numa planilha de registro, com data, situação e ação proposta. Isso é a trilha. Se alguém perguntar daqui a dois meses "por que o cliente tal recebeu três lembretes", a resposta está lá.

4. Pedir ok

Agora a pergunta: qual das ações o agente executa sozinho e qual precisa de ok? Use as três perguntas da aula 1. Lembrete padrão para quem falta: reversível, barato, no escopo. Autônomo. Segundo lembrete com tom mais direto: ainda reversível, mas toca na relação com o cliente. Na primeira versão, pede ok. Cliente com três meses de atraso: fora do escopo do agente. Não é pedido de ok, é entrega para a contadora decidir.

Dimensionando a aprovação: a atenção de quem aprova é o limite

Aprovação humana só funciona se a pessoa lê. E a pessoa só lê se o volume cabe no dia dela. Essa é a conta que quase ninguém faz antes de colocar um agente no ar. Faça agora, com o seu processo: quantas ações "com ok" o fluxo gera por dia ou por semana? Quanto tempo leva ler e decidir cada uma? Quem aprova tem esse tempo?

No escritório contábil, se todo lembrete pedisse ok, seriam 60 a 80 aprovações no começo do mês. A contadora aprovaria tudo sem ler no segundo dia. Movendo o lembrete padrão para autônomo, sobram os segundos lembretes: uns 15 a 20 por mês. Cabe. Se ainda não coubesse, dava para restringir mais: só pede ok o segundo lembrete de cliente que nunca atrasou antes (é o caso em que o tom importa mais).

O pedido de ok bem feito

Quando o agente pede aprovação, o pedido precisa ter tudo que a pessoa precisa para decidir em segundos. Este é o formato que eu peço na instrução:

Repare: situação, regra e ação exata. A pessoa não precisa abrir nada para decidir. E as respostas possíveis são três, o que mantém a decisão rápida.

O que acontece quando ninguém responde

Todo fluxo com aprovação tem um caso que quase todo mundo esquece: o pedido fica sem resposta. A contadora entrou de férias, o dono viajou, a mensagem se perdeu. O que o agente faz? A resposta precisa estar escrita antes de o fluxo ir ao ar, e é uma de três:

O que nunca acontece: silêncio virar sim. Um agente que executa por falta de resposta não tem aprovação humana; tem um portão que fecha sozinho depois de um tempo. E o registro (etapa 3) guarda o que aconteceu com cada pedido: aprovado, negado, alterado, expirado.

Como isso vira ferramenta

Você pode montar esse fluxo de três jeitos, do mais simples ao mais completo. No projeto de chat das aulas 4 a 6, você mesmo faz a etapa de ler (anexa a lista do dia) e o agente faz decidir, registrar (produz a planilha) e pedir ok (mostra os pedidos na conversa). É semi-automático, mas já economiza e serve para testar o desenho. Com um agente de terminal (aula 7) ou conectores MCP (aula 8), o ler passa a ser automático e o registrar grava direto numa planilha. E com uma ferramenta de automação (n8n, Make, Zapier), o fluxo roda sozinho em horário definido e manda os pedidos de ok por mensagem; isso é assunto do curso de automação sem código. O desenho é o mesmo nos três. É por isso que a prática de hoje é desenho.