Nota

Entendendo o papel do agente em um harness

Um agente não é um chat mais esperto. É um engenheiro que você manda para outra sala com pasta limpa: fora do fio principal do harness, com missão própria e mesa nova. Volta com um entregável.

Ilustração de um cubículo de engenharia desordenado ligado por um traço descontínuo a uma mesa limpa com uma pasta luminosa, um agente como outro escritório e não mais papel nesta mesa.

A bagunça da sua mesa não viaja com ele

Você manda um engenheiro para outra sala com uma pasta limpa. Missão própria. Mesa nova. Ele não herda a bagunça da sua mesa. Volta com um entregável — quantitativo, diff, relatório com evidência. O ponto não é «mais inteligência»: é contexto novo. Isso, no harness, é um agente (agent).

Se você só tem três minutos: agente = sala nova + missão + entregável; skill = ficha plastificada que se cola em quem já está trabalhando.

Esta nota faz parte da série sobre o harness de IA para engenharia civil. Encaixa com a compactação de contexto: às vezes a solução é outra mesa, não mais papel nesta.

O que muita gente não sabe: você pode mandar tarefas para fora do fio principal

Há um fio principal: a conversa do harness em que você já está. Essa é a sua mesa. Ali ficou o orçamento de ontem, a briga de unidades, a hipótese do pórtico. É útil. Também satura.

E há outra coisa que muitos leitores não sabem que existe: você pode despachar um agente fora desse fio. Não é «outra mensagem na mesma conversa». É mandar alguém para outra sala com pasta limpa. Missão delimitada. Contexto próprio. Quando termina, volta com o entregável — tabela, quantitativo, diff, log — sem ter sujado nem saturado a mesa principal.

Por quê? Porque o fio principal é memória de trabalho compartilhada. Se você cola cada missão nele, o histórico cresce, o modelo compacta, mistura hipóteses e você assina um parágrafo nascido do ruído. Se despacha um agente à parte, a missão não contamina o contexto em que você ainda está pensando o projeto.

Analogia de escritório: o chefe não grita com o mesmo engenheiro, na mesma mesa coberta de plantas, «agora também faz o inventário do nível 3». Manda para outra sala com pasta limpa. Quando volta, o chefe continua com a mesa usável.

Primeiro a cena, depois a palavra da moda

Caminho um: o mesmo chat. Você pede o pórtico, depois a parede, depois «agora o orçamento». O histórico cresce. O modelo compacta. Mistura unidades. Você assina o parágrafo porque «o agente disse». Não havia agente. Havia uma conversa saturada.

Caminho dois: você despacha uma tarefa com fronteira fora do fio principal. Dá só o que ele precisa — arquivo, nível, unidades, o que é proibido inventar — e um lugar limpo. Quando volta, traz um quantitativo, um diff, um relatório com evidência. Você revisa e assina. Se falhou, falhou na sala dele, não no monte da sua mesa.

Essa segunda cena merece o nome agente: muda onde o trabalho mora.

O que é um agente, em linguagem de escritório

Um agente, em AEC prático, é um processo de IA ao qual você atribui uma missão delimitada num contexto novo: instruções, arquivos, ferramentas e limites próprios. Não é «o modelo». O modelo prevê texto. O agente é a missão + a mesa + as mãos + a regra de quando parar.

Missão

O que deve trazer. «Lista de paredes do nível 3 sem tipo, com element id.» Não «me ajuda com o projeto».

Mesa limpa (contexto novo)

Não arrasta o chat de ontem nem a briga de unidades da mensagem doze. Chega com pasta limpa. Se precisa de um dado, pede ou lê com uma tool. Essa mesa nova é o que você ganha ao despachá-lo fora do fio principal.

Entregável e volta

Volta. Um agente que «continua pensando» sem saída clara é uma aba aberta. O valor está no entregável revisável: tabela, diff, log, lista com IDs.

Agente frente a skill: a diferença que importa

Uma skill (skill: habilidade ou procedimento empacotado) é a ficha plastificada do escritório: a instrução padronizada que qualquer um aplica sem contratar outra pessoa. Cola em quem já está trabalhando. Não abre uma cabeça nova nem estreia mesa.

Um agente, em troca, é mandar alguém. Sala nova. Pasta nova. Nova janela de contexto — fora do fio principal quando faz falta.

  • Você precisa que o procedimento de revisão de paredes exista para toda a equipe → skill.
  • Você precisa que alguém faça hoje a revisão do nível 3 sem se contaminar com o chat do orçamento → agente.

Se você contrata «um agente» quando o que queria era uma ficha plastificada, está pagando outra sala para imprimir um procedimento padrão. Se cola uma skill e espera que «vá sozinha para outra sala», ficou com a mesma mesa e um cartão bonito.

Por que AEC sente isso no estômago

Na engenharia civil o contexto não é decoração. É capacidade, unidade, edição de norma, GUID, combinação de carga.

Quando o mesmo fio mistura o pórtico de ontem com a parede de hoje, o risco é assinar um número nascido de uma hipótese que já não vale. Compactar o chat é como mandar um júnior resumir o diário de obra e jogar fora a página em que dizia kN. (Isso se desenvolve em compactação de contexto.)

Por isso o agente com pasta limpa não é luxo: é higiene. Despachar fora do fio principal não é detalhe de interface: é não saturar a mesa em que você ainda está projetando.

Demo de mesa — não caso de cliente —: você pede «revisa IFC» no mesmo chat depois de meia hora de renders, e depois a mesma coisa numa tarefa despachada à parte só com o IFC e as unidades. A diferença não é mágica: é que não herdou a bagunça.

Se quiser o mapa do arnês, volte a o que é um harness de IA. Se o que falta é a ficha, não outra sala, siga com como padronizar as ordens.

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.

Distinga agente (contexto novo, fora do fio) de skill (mesmas políticas, mesma mesa). Se não puder dizer onde rodou, não tem evidência.