IA e agentes · Arquitetura e operação · 6 min
Engenharia de harnesses para agentes de IA
A camada operacional que conecta objetivos, ferramentas, memória e controles para tornar um agente governável.
O modelo não é o sistema
Um agente útil não é apenas um modelo que responde a um prompt. Ele precisa interpretar um objetivo, usar capacidades permitidas, manter o estado necessário e entregar evidência de como chegou a uma resposta.
O harness reúne essas responsabilidades. Ele define o contrato de execução: ferramentas disponíveis, limites de acesso, políticas de nova tentativa, orçamento de custo e eventos que devem ficar registrados.
Projetar para a operação, não para a demonstração
Dar acesso ilimitado aumenta a superfície de risco e dificulta o diagnóstico de falhas. O princípio prático é o privilégio mínimo: cada agente recebe apenas as ferramentas, os dados e as permissões necessários para uma tarefa concreta.
A telemetria deve correlacionar solicitação, chamadas a ferramentas, latência, resultado e falha. Com esse rastro é possível distinguir uma resposta plausível de uma operação realmente confiável.
Leitura do diagrama
Como ler este sistema
- 01Usuário / App inicia uma solicitação com identidade, escopo e objetivo; a identidade não transfere automaticamente todas as suas permissões ao agente.
- 02O agente propõe passos dentro de um harness: a camada que reúne contexto, ferramentas, memória, políticas e limites de execução.
- 03As ferramentas devolvem resultados estruturados; a memória recupera contexto permitido; a observabilidade registra o rastro para diagnosticar e auditar.
- 04A linha de retroalimentação transforma eventos, erros e consumo em sinais de melhoria, nunca em uma autorização implícita.
Conceitos essenciais
Termos técnicos
- Harness
- Camada de execução que torna um agente governável.
- Privilégio mínimo
- Acesso mínimo necessário para uma tarefa.
- Rastro
- Registro correlacionado de uma execução.
Arquitetura
Implicações e controles
Separar o agente das integrações evita que o raciocínio probabilístico seja a autoridade final sobre uma operação determinística. Cada ferramenta deve validar esquema, identidade, autorização e idempotência do lado do serviço.
Riscos a considerar
- Acesso excessivo a dados ou ferramentas.
- Novas tentativas em loop e gasto ilimitado.
- Sucesso aparente sem evidência verificável.
Lista de verificação
- Definir resultado, responsável e condição de parada.
- Limitar capacidades, dados e orçamentos por tarefa.
- Correlacionar solicitação, ferramentas, resultado e erro.
- Escalar ações financeiras, jurídicas ou irreversíveis.
Conclusão
Um harness não promete um raciocínio melhor: transforma uma resposta em uma operação visível, delimitada e respaldada por evidência.