Neste artigo
- Criar agente IA TypeScript tutorial do zero: 7 partes do guia do freeCodeCamp de 20/10/2026
- As 7 partes do harness
- O que o loop básico faz
- Por que isso importa para quem está começando
- O tutorial é gratuito?
- Quantas partes tem o tutorial?
- Preciso saber TypeScript avançado?
- O projeto serve para outros modelos além de um só?
- Leia também
Criar agente IA TypeScript tutorial do zero: 7 partes do guia do freeCodeCamp de 20/10/2026
Muita gente consegue montar um agente de IA em TypeScript em dez minutos: passa um modelo, algumas ferramentas e um loop. O difícil é fazer esse agente funcionar de verdade em produção. O tutorial do freeCodeCamp publicado em 20 de outubro de 2026 mostra exatamente essa diferença.
O guia, assinado por Gabor Koos, constrói um harness de agente do zero em 7 partes, usando um agente de codificação como exemplo. Conforme publicado no freeCodeCamp News, o projeto completo está no repositório github.com/gkoos/agent-harness-from-scratch.
As 7 partes do harness
O tutorial segue marcos em vez de entregar o código final de uma vez:
- Parte 1: o loop básico do agente, em src/core/agent.ts.
- Parte 2: validação das ferramentas antes da execução.
- Parte 3: isolamento do workspace, com bloqueio de symlinks e escrita fora da pasta do projeto.
- Parte 4: orçamentos de execução, com limite de passos.
- Parte 5: gestão de contexto para não estourar a janela do modelo.
- Parte 6: observabilidade, com logs do que o agente fez em cada passo.
- Parte 7: testes determinísticos de falha, para garantir que o harness falha do jeito certo.
A ideia central do autor: dados gerados pelo modelo são entrada não confiável. O harness valida antes de executar, em vez de confiar no que o LLM produziu.
O que o loop básico faz
No marco inicial, o agente segue uma sequência simples. Ele manda a conversa e as definições de ferramentas para o modelo, e adiciona a resposta do modelo ao histórico.
O loop repete até o modelo devolver uma resposta final ou o harness atingir o limite de passos. As ferramentas ficam do lado do harness: o modelo só declara o que quer chamar, e a execução real acontece no código TypeScript.
Esse desenho é o que diferencia um demo de um agente confiável. Quem usa Cursor ou Copilot hoje já está rodando algo parecido por baixo, só que fechado.
O tutorial inteiro é gratuito e o código fica aberto no GitHub, então dá para clonar, modificar e usar como base do seu próprio agente.
Por que isso importa para quem está começando
Entender o harness por dentro muda como você usa as ferramentas de IA. Você passa a saber por que o agente "esquece" contexto, por que ele às vezes chama a ferramenta errada e por que um limite de passos salva a sua conta de API.
Se você quer a primeira vaga em TI, esse tipo de projeto no GitHub pesa mais no currículo do que dez cursos no perfil. Veja o nosso guia do primeiro emprego em TI para montar o portfólio.
Perguntas frequentes
O tutorial é gratuito?
Sim. O freeCodeCamp publica o guia inteiro de graça, com o código no GitHub.
Quantas partes tem o tutorial?
Sete partes, do loop básico até testes determinísticos de falha.
Preciso saber TypeScript avançado?
Basta TypeScript intermediário: tipos, promises e módulos. O tutorial constrói o resto passo a passo.
O projeto serve para outros modelos além de um só?
Sim. O harness foi desenhado para ser independente de provedor: a troca de modelo fica isolada na camada de chamada.
Leia também
Quem está montando carreira com agentes pode complementar com agentes de IA autônomos: como se preparar em 2026. Na parte financeira, a calculadora CLT × PJ ajuda a decidir se vale a pena bancar o custo de API no bolso.
Comece pelo repositório hoje: clone o projeto, rode a parte 1 e vá até a parte 3 antes do fim da semana. É o suficiente para entender o que o seu editor de IA faz por baixo.