Apoio escrito: o modelo não executa sozinho a ferramenta
Um harness é o programa que envolve a chamada ao modelo e coordena o restante da execução. Ele pode preparar mensagens, disponibilizar ferramentas, validar chamadas, executar código autorizado, registrar resultados e decidir se o ciclo continua.
Abrir diagrama em tamanho original
Suponha que você peça “some estes valores e salve o resultado”. O modelo pode produzir uma solicitação estruturada para usar uma ferramenta. O harness recebe essa solicitação, verifica se a ferramenta existe e se a chamada está dentro das regras, executa-a e retorna a saída ao modelo. Só então o modelo pode explicar o resultado ou pedir outra ação.
O ciclo básico é:
- O harness envia contexto e ferramentas disponíveis ao modelo.
- O modelo produz uma resposta final ou uma solicitação de ferramenta.
- O harness valida e executa a solicitação permitida.
- O resultado entra no histórico; o modelo continua com esse novo contexto.
Disponibilizar uma ferramenta não significa que qualquer pedido será executado. Permissões, validação de argumentos, limites e confirmação humana podem ser decisões do harness. O modelo propõe; o ambiente controla a execução.
Cada nova interação também pode aumentar o histórico enviado ao modelo. Por isso, o desenho do ciclo e a gestão de contexto são partes do trabalho de engenharia, não detalhes invisíveis.
Pergunta de recuperação: quem faz a chamada externa de fato — o modelo ou o programa que hospeda o modelo? Explique o papel de cada um.
Para aprofundar
- OpenAI: chamadas de função — o ciclo entre modelo, aplicação, ferramenta e retorno do resultado.
- Anthropic: Building effective agents — observação do ambiente, condições de parada e tratamento de resultados.
Material complementar da Fernanda
- Guia de Claude Code: tools — Use a seção como exemplo concreto do ciclo: o modelo solicita uma ferramenta, o ambiente executa e o resultado entra na próxima decisão. Diferencie solicitação de ferramenta de execução autorizada.
Pratique com /aprender
Copie o comando e cole no chat para iniciar uma prática guiada:
/aprender Quero praticar o ciclo de um agente com uma ferramenta de busca. Dê um pedido do usuário e peça que eu identifique separadamente o que o modelo propõe e o que o harness valida, executa e devolve. Depois inclua um caso em que a permissão nega a chamada. Faça uma pergunta de cada vez e espere minha resposta.