O que é um harness de agentes? Como os agentes de IA rodam em produção
Um harness de agentes é o software em volta de um modelo de IA que dá a ele um computador, ferramentas, permissões, aprovações e o registro de tudo. Guia para líderes de operações.
Read in EnglishLeer en español
Um harness de agentes é o software que envolve um modelo de IA e o transforma em um agente capaz de fazer trabalho de verdade. O modelo raciocina. O harness dá a ele um computador para trabalhar, ferramentas e dados, permissões sobre o que pode acessar, aprovações antes de ações sensíveis e o registro de cada passo.
Em inglês o nome é agent harness, e não tem tradução consolidada. Harness é o arnês, a cadeirinha do escalador, e a imagem ajuda: quem escala sabe que o que segura você numa via difícil não é a força, é a cadeirinha. Com agentes de IA é igual. O modelo é a força: lê uma demanda do banco parceiro, rastreia um repasse em três sistemas e escreve uma resposta em segundos. Mas só com força você cai. Em produção, é o harness que decide se o agente ajuda ou atrapalha.
O Runtime é o harness de agentes para times de pagamentos e fintech. Cada agente roda no seu próprio computador, dentro da sua nuvem, com as suas aprovações e o registro completo, e qualquer pessoa de operações, risco, compliance ou atendimento consegue criar um.
Este guia é para quem é dono do processo, não do código. Se você é quem vai construir, leia como construir um harness de agentes (em inglês).
O modelo não é o agente
Quando alguém diz "construímos um agente", quase sempre quer dizer que escreveu um bom prompt e plugou uma API. Funciona na demo. Quebra na primeira vez que o agente bate num timeout, fica sem contexto ou tenta mexer no que não devia.
O modelo faz uma coisa só: recebe texto e decide o próximo passo. Todo o resto é trabalho do harness:
- Onde o agente roda, e o que acontece com essa máquina quando ele termina?
- Quais sistemas ele pode ler, e quais pode alterar?
- Quem aprova antes de o dinheiro sair?
- E se o fornecedor do modelo cair no meio da tarefa?
- Como mostrar para um auditor exatamente o que o agente fez na terça passada?
Nenhuma dessas é uma pergunta sobre o modelo. Todas decidem se você pode confiar nele num processo de verdade.
O que tem num harness
Um harness de produção tem algumas peças. Se faltar uma, você descobre qual era do pior jeito.
| Peça | O que significa para o seu time |
|---|---|
| Um computador isolado por execução | Cada agente trabalha na sua própria máquina, com navegador, terminal e arquivos. Nada vaza entre casos e nada mexe direto em produção. |
| Um agente de código que faz o trabalho | Um agente como Claude Code, Codex ou OpenCode consulta, cruza dados e escreve pequenos scripts para terminar a tarefa, em vez de só conversar. |
| Ferramentas e credenciais | Acesso às suas APIs, bancos de dados, servidores MCP e um navegador para portais sem API. As credenciais ficam mascaradas: o agente usa a chave sem nunca ver o valor. |
| Procedimentos e skills | Seus manuais escritos uma vez, para que toda execução siga o mesmo processo e aproveite o que já foi aprendido. |
| Gatilhos onde o trabalho já acontece | Os agentes começam pelo Slack, Teams, WhatsApp, voz, e-mail, um alerta ou um horário. Seu time não precisa aprender outra ferramenta. |
| Limites e aprovações | Os agentes começam só com leitura. O que movimenta dinheiro ou responde ao banco espera o ok de uma pessoa. |
| Avaliações e orçamento | Toda mudança é testada em casos reais já resolvidos, e o gasto tem teto por execução e por pessoa. |
| Acesso por perfil e por time | Cada time vê seus agentes e seus dados. Um agente de atendimento não abre dossiê de compliance. |
| Trilha de auditoria | Cada consulta, ferramenta, aprovação e custo fica guardado e exportável, para responder "por que o agente fez isso?". |
Cada peça é um projeto por si só. Juntas, são a diferença entre uma demo e um colega de time.
Por que em pagamentos a régua é mais alta
Quase tudo o que se escreve sobre harness de agentes parte do princípio de que o pior caso é uma resposta errada. Em pagamentos, o pior caso é uma ação errada.
Um agente que libera um repasse retido para a conta errada custa dinheiro de verdade. Um agente que perde o prazo de uma demanda do banco parceiro coloca a parceria em risco. Um agente que cola um número de cartão num prompt cria um problema de PCI. E quando o regulador pergunta como um caso foi tratado, "foi a IA" não é resposta.
Por isso o harness de um time de pagamentos tem tarefas mais exigentes:
- Rodar onde os dados estão. Os computadores dos agentes na sua própria nuvem, para que dados de cartão não saiam do seu ambiente.
- Manter dados sensíveis fora do modelo. Credenciais mascaradas e filtros que tiram números de cartão, CPF e afins dos prompts e dos logs.
- Começar só com leitura. Os agentes investigam à vontade; o que movimenta dinheiro, aplica uma retenção ou responde ao banco espera aprovação.
- Guardar a evidência. Cada execução guardada do começo ao fim, pronta para o compliance, um auditor ou o banco parceiro.
- Continuar de pé. Novas tentativas, caminhos de recuperação e troca automática de fornecedor, porque uma instabilidade passageira não deveria parar uma investigação.
É também por isso que tantos projetos internos empacam. O primeiro agente é fácil. Aprovações, trilha de auditoria e controle de acesso levam alguns trimestres de um time de engenheiros seniores antes de o agente tocar dado real. Enquanto isso, a fila só cresce.
Onde o Runtime entra
Dá para montar um harness com serviços de nuvem e projetos open source. A maioria dos times que tenta passa dois trimestres em infraestrutura antes de o primeiro agente tocar um pagamento real. O Runtime é o harness de agentes para times de pagamentos e fintech, com todas as peças acima prontas desde o primeiro dia.
- Sem depender de um único fornecedor. O Runtime está conectado a vários provedores de sandbox (Google Kubernetes Engine, microVMs do AWS Lambda, E2B, Daytona e Modal), a vários provedores de modelos, inclusive modelos open source, e a vários agentes de código (Claude Code, Codex e OpenCode), com contingência entre eles. Se um fornecedor cai, a operação continua.
- Controles prontos. Avaliações, orçamentos, acesso por perfil e por time, limites, aprovações, skills, um repositório de servidores MCP e ferramentas, e repasse de um agente para outro.
- Feito para quem faz o trabalho. As plataformas de agentes de baixo nível são só para engenheiros. O Runtime é um app web pensado para times não técnicos. Depois que a engenharia define os limites, operações cria e usa seus próprios agentes, e a engenharia recupera o seu tempo.
- Testado onde importa. O Runtime opera com clientes que movimentam centenas de bilhões de dólares em pagamentos, nos processos críticos de cada time que toca uma transação: proteger (fraude, risco, compliance), movimentar (operações de pagamentos, conciliação), implantar clientes e atender.
No dia a dia, funciona em quatro passos:
- Descreva o trabalho. Alguém do time escreve em português o que o agente deve fazer e anexa o procedimento. O Runtime monta o agente e dá a ele seu próprio computador.
- Conecte suas ferramentas. APIs, bancos de dados e servidores MCP, mais um navegador para portais de bancos e adquirentes sem API. O acesso por perfil define o que cada agente pode ler e fazer.
- Coloque para rodar. Chame o agente pelo Slack, Teams, WhatsApp, e-mail, mensagem ou telefone, ou dispare por um alerta ou horário. Ele investiga no próprio computador e mostra cada passo.
- Mantenha uma pessoa no circuito. Movimentações, retenções e respostas ao banco esperam aprovação. Cada execução fica guardada com evidência, custo e resultado.
As avaliações mandam o trabalho de rotina para o menor modelo que ainda passa nos testes, então cada execução fica mais barata com o tempo. E cada execução vira memória para a próxima. A isso chamamos de sistema de inteligência.
Para ver isso num processo concreto, veja como automatizar a conciliação de Pix, investigar golpes no Pix ou usar o Claude para revisar dossiês de KYC e KYB. A página de segurança cobre implantação e controles.
Perguntas frequentes
O que é um harness de agentes?
Um harness de agentes (agent harness, em inglês) é o software que envolve um modelo de IA e o transforma em um agente capaz de fazer trabalho de verdade. O modelo raciocina. O harness dá a ele um computador para trabalhar, ferramentas e dados, permissões sobre o que pode acessar, aprovações antes de ações sensíveis e o registro de cada passo. O Runtime é o harness de agentes para times de pagamentos e fintech.
Como se diz agent harness em português?
Não existe uma tradução consolidada. Harness quer dizer arnês, a cadeirinha do escalador, mas o mercado usa o termo em inglês. Por isso o mais claro é falar harness de agentes ou agent harness, ou descrever como a infraestrutura onde os agentes de IA rodam em produção.
Qual a diferença entre um harness de agentes e um framework de agentes?
Um framework é uma biblioteca para escrever a lógica do agente, como o loop que decide qual ferramenta usar. O harness é onde esse agente roda em produção: o computador isolado, as credenciais, o controle de acesso, as aprovações, a trilha de auditoria, as avaliações e a continuidade quando algo falha. No mesmo harness podem rodar agentes feitos com frameworks diferentes ou agentes de código como Claude Code e Codex.
Se já usamos Claude Code ou Codex, ainda precisamos de um harness?
Claude Code e Codex são ótimos agentes e trazem um harness local para um desenvolvedor. Para rodar em time, com dados reais de pagamentos, falta muita coisa: um computador isolado por execução, credenciais restritas, acesso por perfil, aprovações no Slack ou no Teams, registro guardado e caminhos de recuperação quando um fornecedor cai. O Runtime roda Claude Code, Codex e OpenCode dentro desse harness.
Um harness de agentes pode rodar na nossa própria nuvem?
Deveria, se o agente acessa dados de cartão ou dados pessoais. Com o Runtime, os computadores dos agentes rodam na sua conta de AWS, GCP ou Azure, inclusive em São Paulo, enquanto nós operamos o plano de controle, ou você pode hospedar a plataforma inteira. Os dados sensíveis ficam no seu ambiente.
Times não técnicos precisam de engenheiros para usar um harness de agentes?
Só para a configuração inicial. A engenharia conecta os sistemas e define os limites: o que cada agente pode ler, o que precisa de aprovação e o orçamento. Depois disso, operações, risco, compliance e atendimento criam e usam agentes pelo app web do Runtime, escrevendo em português o que o agente deve fazer.
Se amarre antes de subir
Hoje qualquer um aluga os mesmos modelos. A força deixou de ser diferencial.
O que separa quem tira valor dos agentes de quem se queima é o harness em volta deles. Escolha a via que o seu time realmente precisa subir, aquele processo que não para de crescer, e confira se está bem amarrado antes de começar.
Bora escalar.
Coloque um agente no seu processo mais manual
Traga um procedimento. Um engenheiro de IA do Runtime monta o primeiro agente com seu time, na sua nuvem e com as suas aprovações.