Ir para conteúdo
be-human.ai
← Voltar ao blog

Fundamentos de harness

Harness ou arquivo de prompt: o que compradores de IA devem perguntar

O arquivo de prompt guarda as instruções. O harness cuida de ferramentas, memória, permissões, checagens e recuperação. Saiba o que perguntar sobre cada um.

Capa tipográfica do Be Human com o título: Harness ou arquivo de prompt: o que compradores de IA devem perguntar
Ilustração conceitual criada com IA · Be Human

Um arquivo de prompt é o texto que diz a um modelo como se comportar em uma tarefa: seu papel, tom, regras, formato de resposta e exemplos. O harness é tudo o que cerca esse arquivo e faz o trabalho acontecer, incluindo a escolha do modelo, as ferramentas, a memória, as permissões, a validação, os registros e a recuperação depois de uma falha. Ao avaliar um agente, o prompt costuma ser a menor parte do que você está comprando. A maior parte da confiabilidade e do risco está no harness.

Principais pontos

  • Um arquivo de prompt define as instruções de uma tarefa. O harness é a camada operacional que executa essa tarefa em sistemas reais.
  • Avalie um prompt pelo comportamento que ele apresenta em testes, não pelo tamanho nem pela redação.
  • Pergunte quem controla ferramentas, permissões, memória e pontos de aprovação, porque são eles que definem o que o agente realmente pode fazer.
  • Exija registros, condições de parada e um caminho de reversão antes de qualquer agente tocar em um sistema em produção.
  • Trate a troca de modelo como uma mudança no harness, que precisa de revisão, e não como uma edição rápida no texto.

Por que o arquivo de prompt recebe toda a atenção

A maioria dos primeiros projetos de agentes começa com um documento. Alguém escreve um bloco longo de instruções, cola em um campo de configuração e a primeira demonstração parece convincente. O prompt é visível, fácil de editar e fácil de explicar para um gestor, então vira o centro da conversa. Esse foco é compreensível, mas empurra o comprador para a pergunta errada logo no início. Um prompt bem escrito ainda pode gerar um resultado ruim quando o agente tem as ferramentas erradas, lê registros desatualizados, repete uma ação duas vezes ou continua trabalhando depois de perder o objetivo.

O que um arquivo de prompt controla e o que não controla

Um arquivo de prompt molda a forma como o modelo interpreta um pedido. Ele pode definir o papel, a ordem das etapas, o formato da resposta e o tipo de julgamento que o agente deve aplicar. Merece redação cuidadosa e revisão periódica. Mas o arquivo, sozinho, não impõe nada. Uma frase como "nunca emita um crédito acima do limite aprovado" é um pedido que o modelo normalmente vai seguir. Não é uma permissão. O limite real precisa estar nas permissões da ferramenta, em código ou em uma etapa de aprovação que o modelo não consegue contornar.

Os arquivos de prompt também não separam instruções de conteúdo. Um e-mail, uma página da web ou a mensagem de um cliente podem conter texto que tenta substituir as regras do agente. As orientações da OWASP sobre injeção de prompt tratam isso como um problema de projeto, que exige controles fora do prompt, como limitar o que um conteúdo não confiável pode disparar. A defesa é uma propriedade do sistema ao redor, não de uma frase melhor no arquivo.

Do que o harness é feito

O harness é o conjunto de partes que operam durante uma execução. Na maioria das implantações empresariais, ele inclui:

  • Seleção e fallback de modelos, que decidem qual modelo atende cada etapa e o que acontece quando ele fica lento, indisponível ou muda de comportamento.
  • Ferramentas e suas regras de entrada, que definem as ações que o agente pode executar e os campos que cada ação aceita.
  • Memória e montagem de contexto, que decidem quais registros o agente lê, quão atuais eles são e quando expiram.
  • Permissões e pontos de aprovação, que decidem o que roda sozinho e o que espera por uma pessoa.
  • Validação, registros, condições de parada e recuperação, que mostram o que aconteceu e permitem que um trabalho interrompido seja retomado com segurança.

As notas de engenharia da Anthropic sobre agentes de longa duração descrevem uma divisão parecida: boa parte do que torna um trabalho longo confiável está na estrutura ao redor do modelo, incluindo como o progresso é registrado e como uma nova sessão retoma o fio da tarefa. Para uma definição simples dessa camada, veja o que é harness de IA. Para uma lista de verificação que você pode usar com qualquer fornecedor, veja requisitos de harness para agentes de IA.

Quais perguntas fazer sobre o arquivo de prompt

Quando um fornecedor ou uma equipe interna mostra um arquivo de prompt, o objetivo é descobrir se ele é mantido, testável e limitado. Faça estas perguntas:

  • Quem escreveu, quando foi alterado pela última vez e o que mudou?
  • Cada regra importante tem um caso de teste que mostra que o agente a segue?
  • O arquivo é curto o bastante para um responsável de operações ler de uma vez, com os procedimentos longos movidos para documentos ou habilidades versionados separadamente?
  • Ele diz o que o agente deve recusar ou escalar, e não apenas o que deve tentar fazer?
  • Ele instrui o agente a tratar mensagens de clientes, anexos e conteúdo da web como dados, e não como instruções?
  • Quais partes precisariam ser reescritas se o modelo subjacente fosse substituído?

Uma boa resposta a essas perguntas é específica. Ela cita um arquivo, um teste e um responsável. Uma resposta vaga, como "ajustamos muito", indica que ninguém consegue mostrar a evidência.

Quais perguntas fazer sobre o harness

As perguntas sobre o harness são onde a maior parte do risco de negócio fica visível. Pergunte:

  • Quais ferramentas o agente pode chamar e quais delas escrevem em um sistema em produção, como um razão contábil, uma agenda ou a caixa de entrada de clientes?
  • Quem aprova uma nova ferramenta, uma permissão ampliada ou uma nova fonte de dados, e onde essa decisão fica registrada?
  • Qual modelo atende cada tarefa e o que acontece quando esse modelo falha, excede o tempo limite ou se comporta de forma diferente após uma atualização?
  • Quais dados o agente lê antes de decidir, quão atuais eles são e o que ele faz quando um registro está faltando?
  • Se uma execução for interrompida, ela pode retomar a partir de um ponto verificado, ou começa do zero e arrisca repetir uma ação?
  • Onde estão os registros, e uma pessoa consegue reconstruir por que o agente tomou cada ação em um dia específico?
  • Como as mudanças são testadas antes de chegar à produção, e quem pode revertê-las?

Para as proteções mais importantes no começo, veja guardrails para agentes de IA nas empresas.

Um cenário ilustrativo e um plano de revisão

Cenário ilustrativo: um distribuidor regional quer um agente que rascunhe respostas a clientes que perguntam sobre o status de pedidos. O fornecedor entrega um arquivo de prompt bem acabado, com tom cordial e linguagem clara de escalonamento. Durante a revisão, a equipe descobre que o agente lê os dados de pedidos de uma planilha atualizada uma vez por dia, e que a mesma conexão pode emitir notas de crédito sem nenhuma etapa de aprovação. O prompt é adequado. O harness não é, e a revisão encontrou isso antes que qualquer cliente recebesse uma resposta.

Uma forma prática de revisar um cenário como esse segue uma sequência curta:

  • Passo 1: Defina a tarefa única e o resultado que conta como sucesso, em termos que alguém consiga verificar.
  • Passo 2: Liste todas as ferramentas e fontes de dados que o agente pode acessar e marque cada uma que possa escrever.
  • Passo 3: Remova o acesso de escrita na primeira versão, ou faça com que cada escrita passe por uma etapa de aprovação.
  • Passo 4: Teste o prompt com casos reais, incluindo mensagens que tentam substituir suas regras.
  • Passo 5: Confirme que registros, condições de parada e comportamento de retomada existem antes da entrada em operação.
  • Passo 6: Registre cada mudança em uma nota de versão para que a próxima revisão saiba o que mudou e por quê.

Como a Be Human trata o harness ao redor do prompt

A Be Human projeta e opera o harness como parte do serviço, não apenas o prompt. Uma primeira etapa define um papel útil, a memória e as ferramentas que esse papel precisa, os limites de aprovação e um critério de sucesso observável. O prompt é então escrito a partir dessa definição e testado dentro dela. Depois da entrada em operação, a operação gerenciada cobre monitoramento, avaliações recorrentes, revisão de permissões, manutenção das integrações, resposta a incidentes e melhorias controladas, para que os escopos das ferramentas e as instruções sejam revisados em uma agenda, e não se desviem sem que ninguém perceba.

Se você não tem certeza de qual tarefa deve ser entregue primeiro a um agente, o diagnóstico gratuito de IA da Be Human pode ajudar a identificar a primeira tarefa que vale a pena transferir.

Perguntas frequentes

Um arquivo de prompt é o mesmo que um prompt de sistema? Um prompt de sistema é uma forma comum de arquivo de prompt, fornecida ao modelo no início de uma sessão. Muitos agentes também carregam instruções de arquivos do espaço de trabalho, de habilidades ou de definições de tarefa. Portanto, o prompt é, na prática, uma camada de instruções dentro do harness. Qualquer que seja o nome que o fornecedor use, pergunte onde cada instrução vive e quem tem permissão para alterá-la.

Um prompt melhor pode substituir um harness? Não. Um prompt pode descrever o comportamento desejado, mas não consegue impor permissões, validar saídas, retomar trabalhos interrompidos nem registrar o que aconteceu. Essas tarefas pertencem a software e procedimentos operacionais fora do modelo. Um prompt forte dentro de um harness fraco continua carregando riscos que a redação não consegue eliminar.

Preciso construir o harness por conta própria? Não necessariamente. Algumas equipes preferem que um operador projete e execute o harness, enquanto mantêm a posse das regras de negócio, dos dados e das aprovações. A escolha certa depende da frequência com que suas tarefas mudam, de quem vai manter as integrações e de quanto tempo de engenharia interna você consegue dedicar. A comparação em harness de IA: construir ou contratar analisa essas trocas.

O que devo perguntar primeiro a um fornecedor? Peça o arquivo de prompt e a descrição do harness lado a lado. Solicite uma lista de ferramentas com o acesso de escrita marcado, os pontos de aprovação, uma amostra dos registros e o plano para trocar o modelo subjacente. Um fornecedor que consegue explicar cada um desses itens em linguagem simples é mais fácil de avaliar do que um que mostra apenas um prompt mais longo.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →