Arquitetura de agentes de IA: os padrões que aguentam produção
As discussões de arquitetura começam quase sempre pelo lado errado: um diagrama de caixas com nomes de conceitos. A versão útil começa pela falha que querem evitar, porque cada padrão abaixo existe para travar uma tarde má concreta.
Estes seis são aqueles a que voltamos sempre. Combinam-se: um agente em produção é tipicamente um ciclo limitado com gateway de ferramentas, duas camadas de memória e um portão humano.
1. O ciclo limitado#
O caso base e a vossa opção por omissão. Um ciclo sobre um pequeno conjunto de ferramentas com condições de paragem explícitas: teto de passos, teto de gasto, deteção de repetição e limite de tempo. A virtude é um rasto linear lido de cima a baixo.
Se não conseguem desenhar o agente como um ciclo com uma lista de saídas, ainda não têm arquitetura: têm um prompt ambicioso.
2. Planeador–executor com replaneamento#
Para tarefas acima de cinco passos, peçam primeiro um plano numerado, executem e replaneiem ao falhar em vez de seguir um plano desatualizado. O ganho não é precisão: é que uma pessoa vê a intenção antes da ação.
3. A passagem crítica#
Uma segunda chamada revê o rascunho ou a ação proposta contra o objetivo e as provas recuperadas, e pode devolvê-la uma vez. Apanha uma parte real da saída confiante mas sem suporte.
| Padrão | Chamadas extra | O que dá | Saltar se |
|---|---|---|---|
| Ciclo limitado | 0 | Rastreabilidade, controlo de custo | Nunca — é a base |
| Planeador–executor | 1–2 | Intenção visível, auditabilidade | Tarefas abaixo de cinco passos |
| Passagem crítica | 1 por saída revista | Menos afirmações sem suporte | Saídas baratas e reversíveis |
| Gateway de ferramentas | 0 | Permissões, auditoria, limites | Só protótipos |
| Memória em camadas | 0–1 | Pertinência com contexto longo | Execuções curtas |
| Portão humano | 0 | O irreversível fica seguro | Se nada for irreversível |
4. O gateway de ferramentas#
Não deixem o agente chamar os vossos sistemas diretamente. Ponham à frente de cada ferramenta uma camada que faça quatro coisas: validar argumentos contra um esquema, verificar se este utilizador final pode tocar naquele registo, aplicar um limite de ritmo e escrever uma linha de auditoria com o identificador da execução.
5. Memória em camadas#
Um histórico indiferenciado é a causa mais comum de um agente que piora ao longo de uma execução. Separem: objetivo e restrições, nunca podados; turnos recentes literais; turnos antigos comprimidos em notas factuais; e conhecimento recuperado, trazido por passo e nunca acumulado.
6. O portão humano#
Cada ação irreversível fica atrás de uma aprovação explícita com contexto suficiente para decidir em segundos. O portão é uma funcionalidade de produto, não uma limitação.
Perguntas frequentes
São precisos os seis padrões?
Não. Comecem pelo ciclo limitado e pelo gateway; ambos são quase obrigatórios em tudo o que toca sistemas reais.
A passagem crítica melhora mesmo a precisão?
Em tarefas onde o modelo pode produzir respostas plausíveis mas sem suporte, claramente sim.
Onde deve ficar o gateway?
No vosso serviço, entre agente e sistemas, com a identidade do utilizador final a atravessá-lo.
arquitetura de agentes iapadrões de desenho de agentesplaneador executorgateway de ferramentasmemória de agente
