Voltar ao blog
Arquitetura & Engenharia23 de julho de 2026·11 min de leitura

O harness é o produto: por que a robustez de um agente não está no modelo, está na engenharia em volta dele

Por Digital Solutions do Brasil

O harness é o produto: por que a robustez de um agente não está no modelo, está na engenharia em volta dele

Continuação de O dia em que US$ 285 bilhões evaporaram

Onde o artigo anterior parou

O artigo sobre a SaaSpocalypse terminou com uma frase que resume nossa operação: a IA gera, a engenharia garante. Ela fechava um argumento sobre software sob medida, mas ela é maior do que isso. Ela vale para cada agente que colocamos em produção.

Os números do freio continuam os mesmos. A Veracode mediu que 45% do código gerado por IA falha em testes de segurança baseados no OWASP. O Gartner projeta que 40% dos projetos agênticos serão cancelados até 2027. O NCSC britânico avaliou que a transição para software gerado por IA levará anos, não meses, com riscos hoje acima da tolerância da maioria das organizações. A Klarna substituiu atendimento humano por IA, admitiu ter ido longe demais e voltou a contratar gente.

Nenhum desses casos é uma falha de modelo. São falhas de tudo que existe em volta do modelo.

Esse "tudo em volta" tem nome: harness agêntico. E ele é o verdadeiro produto de engenharia em um projeto de IA.

O que é um harness agêntico

Um modelo de linguagem, sozinho, faz uma coisa: recebe texto e devolve texto. Ele não tem memória entre chamadas, não sabe o que já tentou, não tem acesso aos seus sistemas, não sabe se acertou e não tem noção de prazo, custo ou permissão.

O harness é a camada de engenharia que transforma essa função sem estado em um trabalhador confiável. Ele responde por:

o que a tarefa é, em um contrato explícito e não em um prompt gigante;

com o que ela pode ser executada, ou seja, quais ferramentas, com quais credenciais e quais limites;

com base em que ela é decidida, ou seja, qual memória e qual conhecimento entram no contexto;

quando ela está pronta, isto é, quem verifica a saída antes de ela avançar;

o que acontece se der errado ou seja, retentativa, compensação, escalonamento;

quem responde por ela com trilha de auditoria, permissão e custo atribuído;

A analogia mais honesta é automotiva. O modelo é o motor. O harness é o chassi, a transmissão, o freio, o cinto, a telemetria e o limitador de rotação. Ninguém coloca um motor de Fórmula 1 no meio da rua e chama aquilo de carro. Foi exatamente isso que boa parte do mercado fez em 2025 e 2026, e é por isso que o Gartner projeta quatro em cada dez projetos cancelados.

A matemática que derruba pilotos bonitos

Existe uma razão estrutural, e não cultural, para tantos pilotos impressionantes morrerem antes de virar produção: erro composto.

Um agente que executa um processo real não dá uma resposta. Ele encadeia etapas. Ler, classificar, extrair, consultar, decidir, redigir, despachar. Cada etapa tem uma taxa de acerto. E elas se multiplicam.

Acurácia por etapa3 etapas6 etapas10 etapas
90%72,9%53,1%34,9%
95%85,7%73,5%59,9%
99%97,0%94,1%90,4%
99,9%99,7%99,4%99,0%

Um agente com 95% de acurácia por etapa parece excelente em uma demonstração. Em um processo de seis etapas, ele erra praticamente um em cada quatro casos ponta a ponta. Em dez etapas, ele erra quatro em cada dez.

Duas conclusões saem daí, e as duas são de arquitetura, não de modelo:

Primeira: acurácia por etapa precisa ser medida, não sentida. Se você não instrumentou cada etapa, você não sabe em qual linha da tabela está.

Segunda: sem verificação intermediária, o erro não é detectado, é propagado. Um dado extraído errado na etapa dois vira uma decisão fundamentada em dado errado na etapa quatro e uma resposta oficial errada na etapa seis. O agente segue confiante, porque nada nele foi projetado para duvidar.

Trocar de modelo move a linha da tabela um pouco para baixo. Colocar verificação entre as etapas muda a tabela inteira, porque interrompe a cadeia antes que o erro se multiplique. É por isso que o QA não é etapa final. Ele é infraestrutura.

Nossa arquitetura: cinco camadas e um barramento

A arquitetura multiagente que a Syntropy Labs desenvolve e a Fábrica de Agentes opera se organiza em cinco camadas, com um barramento de eventos ligando os agentes lateralmente. O fluxo funcional corre de cima para baixo. Governança e infraestrutura atravessam todas as camadas.

L0 · Governança e observabilidade

Não é a última camada, é a primeira. Auditoria com trace completo de cada decisão, permissões por agente e por ferramenta, ponto de aprovação humana em decisões sensíveis, custo apurado por pod e conformidade à LGPD desenhada na arquitetura, não anexada depois.

O teste desta camada é simples: dado um resultado entregue há três meses, você consegue reconstruir quem decidiu, com base em qual informação, com qual modelo, a que custo e com qual aprovação? Se a resposta for não, não existe governança, existe log.

L1 · Orquestração

Quatro funções distintas, que costumam ser confundidas em um único bloco:

Event Ingress, que envelopa qualquer entrada em um formato comum de tarefa.

Intent Classifier, que identifica o domínio da tarefa.

Task Router, que despacha a tarefa ao pod correto.

Saga Manager, que cuida de fluxos compostos e, principalmente, de compensação.

Compensação é a função mais subestimada de um harness. Processos reais têm efeitos colaterais. Se a etapa cinco falha depois que a etapa três já atualizou um sistema, alguém precisa desfazer. Sem saga, o que você tem não é automação, é inconsistência distribuída.

L2 · Pods de agentes

Aqui está a decisão de projeto que mais separa arquitetura de gambiarra: cada pod é dono da sua memória e do seu RAG.

Um pod é um agente especialista com escopo fechado: sua memória em namespace isolado, seu índice de conhecimento de domínio, seu modelo escolhido pelo tipo de tarefa e seu conjunto mínimo de ferramentas. Um pod determinístico, que só executa regra, não precisa do mesmo motor de um pod que precisa julgar nuance de linguagem.

Isolar memória e conhecimento por pod resolve três problemas de uma vez: contexto não polui entre domínios, permissão fica granular por agente e o custo se torna atribuível. Um pod com acesso a tudo é um pod que ninguém consegue auditar e que ninguém consegue baratear.

Barramento de eventos

Os pods não se chamam. Eles publicam e assinam eventos, e a regra é rígida: o barramento carrega fatos, nunca memória.

Quando um agente passa o próprio contexto para outro, você criou acoplamento invisível e um caminho para alucinação em cascata. Quando ele publica um fato verificado, o agente seguinte parte de algo auditável. É a diferença entre "o agente anterior achou que o prazo era esse" e "o prazo consta no documento, campo tal, confiança tal, validado".

L3 · Memória e conhecimento federados

Memória por pod em namespaces isolados, RAG por pod com índices próprios de domínio, base corporativa compartilhada em modo somente leitura e a infraestrutura de conhecimento por baixo, com bancos vetoriais, embeddings e pipelines de ingestão.

Federado é a palavra central. A tentação é criar uma memória única e global, porque parece mais simples. Ela é mais simples até o dia em que um agente decide com base em um fragmento de contexto de outro domínio e ninguém consegue explicar por quê.

L4 · Infraestrutura e modelos

Um roteador de modelos escolhe o motor por tarefa, com escalada por confiança: rotina no modelo econômico, nuance e contexto no modelo intermediário, decisão estratégica no modelo de topo. Filas e agendador tratam o assíncrono e as retentativas. Conectores e adaptadores acessam sistemas externos, cada um com credencial isolada.

Credencial isolada por conector não é detalhe de segurança, é contenção de raio de explosão. O incidente da Replit em julho de 2025, quando um agente apagou um banco de produção durante um teste, é a versão didática do que acontece quando um agente carrega mais permissão do que a tarefa exige.

O harness aplicado: a arquitetura do Juris AI

O Juris AI é a materialização dessa arquitetura em um processo que não admite erro: o ciclo de documentos jurídicos e regulatórios, da entrada do ofício à ação de consequência.

O diagrama abaixo mostra a mesma estrutura de cinco camadas aplicada a esse domínio.

Diagrama da solução

Juris AI · arquitetura multiagente · Syntropy Labs

Entradas e eventos

E-mail
IMAP · SMTP
Portais
tribunais · órgãos
API de parceiros
protocolos externos
ERP · CRM
sistemas de registro
Cron · prazos
agenda regulatória
Curador humano
entrada e revisão

L1 · Orquestração

Event Ingress
envelope comum de tarefa
Intent Classifier
identifica o tipo de documento
Task Router
despacha ao pod certo
Saga Manager
fluxos compostos · compensação

L2 · Pods de agentes · cada pod é dono da sua memória e do seu RAG

Triagem
determinístico
mem: lotes recebidos
rag: layouts de doc
modelo: barato · OCR
tools: imap, parser, ocr
Classificação
híbrido
mem: taxonomia
rag: tipos e normas
modelo: barato → nuance
ner · confiança por campo
Executor
não determinístico
mem: por processo
rag: base corporativa
modelo: nuance
tools: erp, crm, data lake (leitura)
QA
determinístico + LLM
mem: rejeições
rag: critérios de aceite
modelo: nuance
barra antes de avançar · F1 mínimo
Supervisor
não determinístico
mem: prazos e SLA
rag: políticas internas
modelo: decisão
escalona e compensa
Despachante
determinístico
mem: protocolos
rag: templates oficiais
modelo: barato
só despacha o que foi aprovado
▲ ▼  Barramento de eventos · publish / subscribe · fatos, nunca memória  ▲ ▼

L3 · Memória e conhecimento federados

Memória por pod
namespaces isolados
RAG por pod
índices próprios de domínio
Base corporativa
normas e precedentes · somente leitura
Infra de conhecimento
bancos vetoriais · embeddings · ingestão

L4 · Infraestrutura e modelos

Roteador de modelos
escolhe o motor por tarefa
escalada por confiança
Modelo econômico
rotina · alto volume
Modelo de nuance
contexto · linguagem jurídica
Modelo de decisão
exceção · escalonamento
Filas · agendador
assíncrono · retries
Conectores · credencial isolada
IMAP / SMTP
Portais
ERP
CRM
Data lake (leitura)
Assinatura digital
Workflow interno
Dashboards
Storage · docs
Legendamemóriaconhecimento / RAGmodelofluxo de cima para baixo · o barramento liga os pods · L0 e L4 servem todas as camadas
Diagrama da arquitetura multiagente do Juris AI em cinco camadas

Os seis pods espelham o time humano e, mais importante, cada um carrega o próprio harness:

PodNaturezaO que o harness garante
Triagem e ingestãoDeterminísticoEnvelope único de tarefa, OCR com fallback, nada entra sem identificação
Classificação e NERHíbridoExtração com confiança por campo, F1 mínimo por entidade
Executor de contextoNão determinísticoConsulta a sistemas de registro somente leitura, via conector com credencial isolada
QA e verificaçãoDeterminístico com LLMBarra o que não atende ao padrão, antes de avançar, não depois
Supervisor e SLANão determinísticoPrazo, completeza e escalonamento, com compensação quando o fluxo quebra
Despacho e protocoloDeterminísticoSó despacha o que passou por verificação, com registro e trilha completa

A camada de curadoria humana atravessa o fluxo inteiro. Em processo sensível, a última palavra é sempre humana. O agente não substitui o especialista, ele elimina a cola humana que consumia o tempo do especialista.

O resultado, medido em operação, é ganho de produtividade superior a 50% com acurácia validada por agentes de QA dedicados. Não porque o modelo é melhor do que o de qualquer outro, mas porque o que está em volta dele foi construído por engenharia.

Sete antipadrões que produzem passivo

Vemos os mesmos erros em quase toda arquitetura agêntica que chega para diagnóstico:

01
Prompt monolítico. Um bloco de texto de três mil palavras tentando ser especificação, política de segurança e manual de operação ao mesmo tempo.
02
Agente com todas as ferramentas. Permissão máxima por conveniência de desenvolvimento, que nunca é revisada depois.
03
Memória global compartilhada. Simples de começar, impossível de auditar.
04
QA como etapa final. Verificar no fim significa descobrir o erro depois de ele ter contaminado quatro etapas.
05
Retentativa sem compensação. Tentar de novo em um processo com efeito colateral já aplicado é duplicar o efeito, não corrigi-lo.
06
Um modelo único para tudo. Ou você paga caro por tarefa trivial, ou você paga barato por decisão crítica. As duas contas são ruins.
07
Observabilidade como log. Registrar o que aconteceu é diferente de conseguir reconstituir por que aconteceu.

Nenhum desses itens aparece na demonstração. Todos aparecem no terceiro mês de produção.

Dez perguntas antes de colocar um agente em produção

1.

Qual é a acurácia medida de cada etapa, e não do fluxo inteiro?

2.

Quem verifica cada saída antes de ela avançar?

3.

O que acontece quando a etapa N falha depois que a etapa N menos 2 já gravou em um sistema?

4.

Qual é o conjunto mínimo de ferramentas que este agente precisa, e ele tem exatamente esse conjunto?

5.

Cada conector tem credencial própria e escopo próprio?

6.

Onde está o ponto de aprovação humana e qual é o critério de escalonamento?

7.

Dado um resultado de três meses atrás, você reconstrói a decisão inteira?

8.

Qual é o custo por tarefa, por pod, e ele está sendo acompanhado?

9.

O que este agente lembra, por quanto tempo, e quem mais enxerga essa memória?

10.

Se o modelo por trás dele for trocado amanhã, o que quebra?

Se mais de três respostas forem "ainda não", o que existe é um piloto, não um sistema.

O próximo degrau

O mercado passou 2025 e 2026 discutindo qual modelo é melhor. É a pergunta errada, e ela ficou ainda mais errada agora que os modelos de fronteira convergiram em capacidade.

A diferença entre um projeto de IA que vira ativo e um que vira passivo não está no motor. Está na verificação, no isolamento, na compensação, na governança e no roteamento. Está no harness.

Gerar ficou barato. Garantir continua sendo engenharia. E garantir é exatamente o que se contrata quando se contrata uma Fábrica de Agentes.

Fábrica de Agentes

Squads digitais com verificação no centro, prontos para produção

O harness não é acessório do agente. É o que transforma o agente em ativo de produção.

Fontes

  • Veracode, estudo sobre falhas de segurança OWASP em código gerado por IA
  • Gartner, projeção de 40% de projetos agênticos cancelados até 2027
  • NCSC (Reino Unido), avaliação de março de 2026 sobre riscos da transição para software gerado por IA
  • Bloomberg, caso Klarna (mar/2026)
  • Replit, incidente de exclusão de banco de produção por agente (jul/2025)
  • Digital Solutions do Brasil, arquitetura multiagente Syntropy Labs e caso Juris AI

Pronto para eliminar a cola humana?

Converse com nossos especialistas e descubra como a Fábrica de Agentes se encaixa na sua operação.

Falar com um especialista