O harness é o que você já faz com um júnior
Você é o engenheiro responsável. Precisa entregar um estudo hidráulico. Encaminha o trabalho a um engenheiro júnior.
Não diz só «faz o estudo». Deixa o quadro:
- Quais ferramentas ele pode usar (o software do escritório, o Excel da vazão, a camada de GIS; não o chat público).
- O que deve fazer (montar o caso, rodar o modelo, extrair vazões e avisos).
- O que deve conferir antes de devolver qualquer coisa (unidades, trecho certo, se o modelo abriu, se convergiu).
- O que não pode inventar se faltar um dado.
- O que tem de devolver (arquivo, versão, números com unidades, e onde parou se falhou).
- O que ele não assina: você revisa e assina.
Esse quadro — ferramentas, instruções, conferências, limites e devolução — é exatamente um harness quando cerca um modelo de IA. O modelo raciocina e propõe, como o júnior. O harness é o quadro com que ele trabalha. Quem assina continua sendo você.
Um arnês não pensa por você. Segura. Conecta. Impede que você saia do envelope seguro. Tampouco transforma o chat em engenheiro automático.
As nove partes do quadro que você dá ao júnior
PRANCHA DE SISTEMA · HA-01
Anatomia de um harness de IA
Deslize horizontalmente para explorar a prancha completa.
Em AEC, essas nove partes se leem assim. Entre parênteses vai o nome em inglês, porque é assim que aparece na documentação de agentes:
H-01 Instruções e políticas (system prompt / policies). É o encargo escrito ao júnior: objetivo, escopo, unidades, normas, ações proibidas e quando perguntar ao engenheiro responsável. «Faz o estudo» não basta. Isso é o system prompt.
H-02 Contexto (context). É a pasta do projeto que o júnior recebe: modelo e versão certos, levantamento, chuva de projeto, rede existente e critérios ou especificações. Se o contexto falta ou está errado, ele pode entregar uma resposta polida para o projeto errado. Inclui a janela de contexto e a compactação.
H-03 Ferramentas (tools). São as ferramentas que o júnior está autorizado a usar: EPANET/SWMM, planilha, GIS e repositório documental. O júnior ou o modelo propõe; a ferramenta especializada calcula ou consulta. Ele não recebe as chaves de todos os sistemas. No Revit, essa tomada costuma ser MCP.
H-04 Orquestração (orchestration). É a ordem combinada do trabalho: identificar entradas, fazer o pré-voo (preflight), montar o caso, executar o motor de cálculo, inspecionar avisos e redigir o relatório. Os passos fixos permanecem fixos; só se delega a interpretação quando faz falta. Inclui despachar um agente para outro fio com pasta limpa.
H-05 Estado e memória (state & memory). É o caderno ou registro de cálculo: arquivo e versão usados, hipóteses confirmadas, passos terminados e perguntas pendentes. A memória útil está respaldada e pode ser corrigida; despejar a conversa inteira não é boa memória.
H-06 Validações e guardrails (validation & guardrails). São conferências e limites independentes: unidades, continuidade, faixas, balanço de massa, convergência e campos obrigatórios. Guardrails são controles, não uma garantia de que o projeto esteja correto.
H-07 Aprovação humana (human approval). O júnior pode inspecionar e executar rascunhos, mas o engenheiro responsável aprova alterar o modelo oficial, o orçamento contratual, emitir o relatório ou assinar. Esses são pontos de parada exatos.
H-08 Observabilidade e evidência (observability & evidence). É o pacote de cálculo rastreável: pedido, arquivo e versão, ferramenta ou motor, parâmetros, resultados, avisos, tempo ou custo se importar, e revisor. Outro engenheiro precisa poder reconstruir o que aconteceu.
H-09 Tratamento de falhas e ambiente de execução (failure handling & runtime). Indica o que o júnior faz se faltar um arquivo, o modelo não convergir, falhar a licença ou o sistema, ou se atingir o limite de tempo ou custo: parar, registrar, retentar só com regras definidas, trabalhar isolado sobre uma cópia e nunca preencher lacunas com números plausíveis.
As ordens padronizadas — unidades, formato, norma ou livro — não são um agente novo: são a ficha plastificada da empresa que o harness pode carregar sem abrir outro contexto.
Por que essas nove partes são o harness
Juntas, essas nove partes são o harness: não o júnior, não o software hidráulico e não o chat, e sim o quadro que conecta o pedido a uma execução controlada e a uma revisão profissional.
Os modelos de linguagem (LLM) são probabilísticos: preveem o próximo texto plausível. Por isso precisam estar cercados de um arnês (harness). O objetivo do harness não é «fazer o chat soar mais esperto». É entregar resultados ancorados em processos determinísticos — motores, arquivos, regras e evidência — em vez de depender da sorte do modelo.
O harness pode se conectar a aplicativos (Revit, planilhas, GIS), ler PDFs e plantas, escrever código e usar código open source (OpenSees, OpenFOAM, CalculiX, EPANET/SWMM e outros) para que o número que chega à sua mesa saia de uma ferramenta verificável, não da probabilidade do LLM.
Sua missão como engenheiro civil: verificar que o modelo, por meio do harness, use as ferramentas adequadas, na ordem adequada e com as restrições adequadas, para obter resultados verificáveis e auditáveis. Se você só confia no que o chat «acha», não tem engenharia: tem texto convincente.
Cada uma dessas partes se explica com mais detalhe nos demais artigos da série. Este artigo é o mapa. Os seguintes abrem cada peça.
O que não é (para não se confundir)
- Ter um chat com arquivos não é ter um harness.
- Encaixar uma ferramenta (por exemplo um conector ao Revit ou a um motor) não é o agente completo: é uma mão. Faltam permissões, checagens, parada e assinatura.
Sinais de que você só tem um chatbot
- Devolve texto, mas não deixa evidência de qual arquivo ou motor usou.
- Você não consegue apontar versão, parâmetros ou software.
- Quando a ferramenta falha, o modelo inventa a lacuna.
- Nenhum passo sensível pede a sua aprovação.
- Não há forma repetível de testar o mesmo caso.
Se você reconhece vários, não precisa de um modelo maior. Precisa de quadro.
O que você faz em quinze minutos
Escolha uma tarefa real (revisar um modelo, uma vazão, um quantitativo, um avanço). Numa folha, quatro colunas:
| Conversar | Executar | Verificar | Aprovar |
|---|---|---|---|
| Onde só interpreta ou explica. | Qual arquivo ou motor faz a ação de verdade. | Qual regra independente confere o resultado. | Quem assina e com qual evidência. |
Se só existe a primeira coluna, você tem um chat. Se executa, valida, deixa evidência e sabe parar, você já está montando um harness.
Hoje: uma tarefa, essas quatro colunas. Se algo falhar, anote onde parou. Isso também é o ofício.
Série: o mapa e as próximas leituras
Esta nota é o hub da série sobre o harness de IA para engenharia civil. Cada peça se desenvolve com analogias de escritório e de obra:
- A primeira coisa que você deve aprender para usar IA como engenheiro civil — este mapa (H-01…H-09).
- Faça sua IA usar o Revit — H-03, MCP como a tomada entre o chat e o Revit.
- System prompt na engenharia civil — H-01, políticas persistentes versus regras coladas em cada e-mail.
- Prompt engineering para engenharia civil — a ordem de serviço clara versus a ordem vaga.
- Mesmo pedido, dois resultados: seu LLM não calcula — o engenheiro versus a oficina.
- Entendendo o papel do agente em um harness — mandar alguém para outra sala com pasta limpa.
- Como padronizar as ordens que você dá a um agente — a ficha plastificada da empresa.
- Seu agente esquece o que você disse antes — quando o caderno de obra já não cabe na mesa.
Comece pelo system prompt e pelo papel do LLM se você ainda está no chat. Passe para MCP, agente e compactação quando o sistema começar a executar.
Conclusão
A conversa sobre IA na engenharia civil não deveria começar e terminar no nome do modelo. A capacidade profissional aparece no sistema completo: dados corretos, ferramentas especializadas, permissões, validações, rastreio e revisão humana.
O modelo propõe. O harness conecta, executa, verifica e limita. O profissional decide e assina.
Fontes
- OpenAI — A practical guide to building agents
- Model Context Protocol — Introdução
- OpenSees — site oficial
- Casys AI — mcp-calculix
- Sam Schillace — “What is a harness and why do I care?”
Avaliação e limitações
Trate as notas abaixo como contexto de avaliação, não como um cálculo ou uma verificação comprovados.
Para o trabalho profissional, convém avaliar o modelo e o harness como um sistema completo, com casos representativos, critérios de aceitação, rastreabilidade e revisão humana.