<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Criar agente IA TypeScript tutorial do zero: 7 partes do guia do freeCodeCamp de 20/10/2026

DA

4 min

Entusiasta das Tecnologias

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.

Neste artigo

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.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 06/11/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR