# Harness: o curso grátis da engenheira do Google, em português Um guia do @souoallan · feito pelo Breeze · a dica é do @0xCodila ## O que é harness, sem jargão O modelo de IA é o cérebro. O **harness** é todo o resto que tu monta em volta dele: - o que ele pode ler (contexto e memória); - as ferramentas que ele pode usar; - as regras do que ele não pode fazer sem te perguntar; - e, o mais importante, **a prova que confere o trabalho antes de entregar**. Quase todo mundo confia num agente que "parece certo". O salto é montar um ciclo que: 1. **Testa:** roda o agente numa lista de casos reais, sempre os mesmos. 2. **Julga:** uma regra fixa ou uma segunda IA dá nota pra cada resposta. 3. **Reescreve:** o que errou vira ajuste na instrução do agente, e roda tudo de novo até passar. Um exemplo da aula: dois agentes marcaram o mesmo compromisso. Um conferiu a agenda e o restaurante. O outro chutou o horário e deu sorte. Pelo resultado, os dois tiram a mesma nota. Só olhando o caminho que cada um fez tu descobre qual vai acertar amanhã de novo. ## O curso (1h35, grátis, em inglês) São dois vídeos oficiais. Clica no minuto pra ir direto. ### Parte 1 · Harness do zero (9 min) "AI harness crash course", canal **Google Cloud Tech**, com a Annie Wang (22/10/2026). https://www.youtube.com/watch?v=2C_CefSQEAQ | Minuto | Capítulo | Link | |---|---|---| | 0:00 | O que é um harness | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=0s | | 0:49 | O ciclo: ler, mexer, testar, corrigir | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=49s | | 1:19 | As 4 partes de um harness | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=79s | | 1:40 | Contexto e memória: a conversa e o rascunho | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=100s | | 2:46 | Memória que dura pra semana que vem | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=166s | | 3:37 | Ferramentas: funções e MCP | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=217s | | 4:23 | Checagens em paralelo e limite de tentativas | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=263s | | 5:18 | Onde o código roda: a caixa de areia | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=318s | | 6:00 | Texto malicioso e permissões | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=360s | | 6:54 | Privacidade: pra onde vão os dados | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=414s | | 7:25 | Conferir com regra fixa | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=445s | | 8:00 | Conferir com uma IA juíza | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=480s | | 8:37 | Conferir com gente, e misturar os três | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=517s | | 9:13 | Fechamento | https://www.youtube.com/watch?v=2C_CefSQEAQ&t=553s | ### Parte 2 · Avaliação e agente que se melhora sozinho (1h25) "Agent 102: Agent Evaluation + Self Evolving", aula ao vivo da **Annie Wang**, engenheira de software do Google Cloud, no canal dela (14/10/2026). https://www.youtube.com/watch?v=fmPkXi4gRUM | Minuto | Capítulo | Link | |---|---|---| | 0:00 | Como saber se um agente é bom | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=0s | | 22:10 | Os tipos de avaliação | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=1330s | | 33:42 | Criando a tua própria nota | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=2022s | | 44:15 | A lógica do agente que se melhora sozinho | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=2655s | | 55:29 | O agente reescrevendo a própria instrução (ADK optimize) | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=3329s | | 1:07:19 | Montando o ciclo que roda sozinho | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=4039s | | 1:24:42 | Perguntas e fechamento | https://www.youtube.com/watch?v=fmPkXi4gRUM&t=5082s | ### Bônus · Nunca montou um agente? "Agent 101: Build Your First Agent", também da Annie Wang. O capítulo "montando o teu primeiro agente" começa em 17:11. https://www.youtube.com/watch?v=HM-cx9nG2FA&t=1031s ### Legenda em português Os vídeos são em inglês. No YouTube, liga a legenda e vai em Configurações › Legendas › Traduzir automaticamente › Português. É tradução automática, então alguns termos técnicos saem estranhos. ## Prompt pronto: monta um harness simples pro teu agente Cola no Claude (no app ou no Claude Code) e preenche os colchetes. Não precisa saber programar: ele faz a parte técnica contigo. ``` Quero montar um "harness" simples pro meu agente de IA: um ciclo que testa, dá nota e reescreve a instrução dele até ele funcionar. Meu agente: - O que ele faz: [ex.: responde dúvidas de clientes no direct da minha loja] - Onde ele roda: [ex.: um GPT personalizado, um projeto no Claude, um agente no n8n, código próprio] - A instrução atual dele: [cola aqui o prompt/instrução do agente] - Exemplos de onde ele já errou: [cola 2 ou 3, se tiver] Faz comigo, nessa ordem, e me pergunta o que faltar antes de seguir: 1. CASOS DE TESTE: monta 10 casos realistas pro meu agente (6 comuns, 2 difíceis e 2 pegadinhas que ele deveria recusar ou perguntar antes de responder). Pra cada um, escreve o que seria a resposta certa. 2. CRITÉRIO DE NOTA: cria uma régua de 0 a 10 com no máximo 5 critérios claros (ex.: acertou a informação, seguiu as regras, pediu confirmação quando devia, tom certo, não inventou nada). Separa o que dá pra conferir com regra fixa (ex.: "citou o preço certo") do que precisa de julgamento (ex.: "foi educado"). 3. RODADA 1: roda os 10 casos com a instrução atual, como se tu fosse o meu agente. Depois troca de chapéu e age como juiz rigoroso: dá a nota de cada caso pela régua, olhando não só a resposta final mas o caminho (ele conferiu antes ou chutou?). Me mostra uma tabela: caso, nota, o que errou. 4. REESCRITA: com base só nos erros, reescreve a instrução do agente. Me mostra o antes e o depois, e explica em uma linha cada mudança. 5. RODADAS 2 E 3: roda os mesmos 10 casos com a instrução nova e julga de novo. Para quando a média passar de 8 e nenhum caso ficar abaixo de 6, ou depois de 3 rodadas. 6. ENTREGA: me dá a instrução final pronta pra colar no agente, a lista de casos de teste pra eu guardar e rodar de novo sempre que mudar alguma coisa, e os 3 erros que mais apareceram. Regras: não muda o objetivo do agente sem me perguntar, não inventa informação do meu negócio (se precisar de um dado, pergunta) e me mostra a nota de cada rodada pra eu ver se melhorou. ``` Depois que funcionar, guarda a lista de casos. Toda vez que mexer no agente, roda ela de novo: é isso que separa o agente que "parece certo" do agente que tu sabe que tá certo.