O salto de chatbot para agente parece pequeno na interface e enorme na arquitetura. O chatbot sugere. O agente executa. Ele cria registro, manda mensagem, cancela pedido, mexe em configuração, consulta banco. A partir daí, prompt deixa de ser só texto e vira uma espécie de controle remoto.
Comece pela pergunta menos sexy: o que ele pode fazer?
Antes de escolher modelo, framework ou nome fofo para o agente, faça uma matriz de ações. Ler é diferente de escrever. Escrever é diferente de apagar. Consultar um cliente é diferente de exportar todos. Um agente com credencial administrativa porque “era mais fácil integrar” é só uma conta privilegiada com criatividade. Princípio de menor privilégio continua sendo princípio mesmo quando o usuário é sintético. Dê ao agente apenas o acesso necessário para aquela tarefa, de preferência por escopo, tempo e ambiente. Separe produção de teste. Separe leitura de mutação. Separe decisão de execução quando o impacto for alto.
Aprovação humana não pode ser decoração
Para ações financeiras, exclusões, comunicação externa sensível ou mudanças irreversíveis, peça confirmação real. Não vale uma etapa automática chamada human review em que ninguém revisa nada. A interface precisa mostrar o que será feito, com quais dados e qual consequência.
Logue o raciocínio operacional
Você não precisa guardar pensamentos internos do modelo. Precisa guardar fatos auditáveis: qual instrução recebeu, quais ferramentas chamou, quais dados consultou, qual ação executou, com qual identidade e em que horário. Quando der problema, “foi a IA” não ajuda o suporte, o cliente nem o jurídico. O melhor agente não é o que tem mais autonomia. É o que tem autonomia suficiente para criar valor e pouca o bastante para não transformar um prompt ruim em incidente de produção.