Vercel na Prática: Construa um AI Coding Agent Harness e Fature com Engenharia

A Vercel Academy soltou um curso completo, “Build Your Own AI Coding Agent Harness”, que destrincha como construir do zero um framework de agente de código que realmente funciona. Não é mais um tutorial de três APIs e um demo meia-boca — aqui você enfrenta de frente tool loop, poda de contexto, delegação para subagentes e gestão de ciclo de vida.

Para o engenheiro que quer monetizar com IA, esse curso é um divisor de águas: tem gente demais usando Cursor para autocompletar código, mas quem entrega “framework de agente sob medida” cobra muito acima do freelance comum.

Primeiro, o Básico: O que é um Agent Harness

Agent Harness é o andaime que permite à IA trabalhar sozinha, gerenciar contexto e manter a segurança —相当于 um gerente de projeto + fiscal de segurança + caderneta de anotações para a IA. Sem Harness, a IA é só um modelo que conversa; com Harness, ela vira um funcionário júnior que recebe tarefa, executa, reporta e sabe quando voltar ao humano pedindo socorro.

A trinca usada no curso tem funções bem definidas:

  • AI SDK: faz a IA falar (chama modelos, gera texto)
  • Vercel Sandbox: faz a IA agir (executa comandos em ambiente isolado)
  • just-bash: faz a IA obedecer (padroniza interface de ferramentas, tornando shell previsível)

Juntos, formam uma fábrica de agentes completa.

A Dor: Por que Seu Agente Sempre Fica no Demo

Joel Hooks abre o curso cutucando a realidade constrangedora do setor — “um tool loop de três ferramentas é só demo; o problema explode quando você coloca para trabalhar de verdade”. Mande o agente ler um arquivo de 5.000 linhas e ele enfia tudo no contexto, sem conseguir cuspir de volta. Dê permissão de bash e ele solta um rm -rf no seu banco de produção. Peça vinte passos seguidos e no décimo ele já esqueceu o que estava fazendo.

Cliente não paga casca, paga se o agente entrega. 90% dos “tutoriais de assistente de código IA” ensinam a empacotar prompt, plugar API da GPT e fazer uma interface bonitinha. Mas o que empresa paga caro é saber se o agente roda uma cadeia inteira de tarefas com segurança — isso é problema de arquitetura, não de ajuste de parâmetro.

A ambição do curso da Vercel é clara: tratar Agent Harness como produto de engenharia sério, não script de brinquedo.

A Oportunidade: Engenheiro de Agente Virou o Recurso Mais Escasso do Freelance

O mercado de freelance já mostra uma polarização nítida. De um lado, o “usuário de IA” que só completa código com Cursor e briga por preço baixo. Do outro, o engenheiro que entrega “solução customizada de AI Agent” — projeto único com ticket bem acima do freelance médio e cliente na fila de espera.

Por quê? Porque empresa quer “fluxo de trabalho automatizado”, não “autocompletar código”. Um lojista de e-commerce não quer um script Python — quer um agente que rastreia preço de concorrente, gera文案 de listing, roda teste A/B e solta relatório no automático. Só quem domina arquitetura de Agent Harness entrega isso.

⚠️ Segundo o post original, projetos da categoria “AI agent customization” no Upwork giram na casa de milhares de dólares, mas não verifiquei de forma independente.

Caminho 1: Domine os Módulos Centrais do Curso e Construa seu Fosso Técnico

Os módulos mais valiosos do programa precisam ser digeridos um a um. Cada um em três frases: problema → solução → analogia.

Tool Loop: o coração do agente.

  • Problema: chamada de ferramenta falha, dá timeout, conflita em paralelo e o agente desmorona.
  • Solução: AI SDK usa condição stopWhen para encerrar o loop, combinado com maxSteps limitando passos máximos e retry automático.
  • Analogia: é o controlador de ritmo da linha de montagem — se uma estação falha, a linha para, não deixa peça defeituosa passar adiante.

Tool Design: a granularidade da ferramenta define o teto de capacidade do agente.

  • Problema: granularidade grossa demais e o agente não faz trabalho fino; fina demais e ele se perde nas chamadas.
  • Solução: separe “manipular sistema de arquivos” em cinco ferramentas atômicas — read, write, edit, glob, grep — em vez de entregar um bash coringa.
  • Analogia: é dar ferramentas专用 (chave, chave de fenda, furadeira) ao funcionário, não enfiar a garagem inteira na mão dele.

Sandbox Abstraction: a chave da segurança.

  • Problema: com bash liberado, o agente executa rm -rf no seu banco de produção.
  • Solução: Vercel Sandbox oferece ambiente isolado — o agente pode bagunçar à vontade sem tocar na máquina hospedeira.
  • Analogia: é a capela de exaustão do laboratório de química — se explodir, explode a capela, não o prédio.

Poda de Contexto: arquivo de 5.000 linhas não vai inteiro no prompt.

  • Problema: a IA lê 5.000 linhas e estoura a memória; conversa antiga ainda polui a decisão nova.
  • Solução: use o hook prepareStep para podar o contexto antes de cada passo, mantendo só os últimos N passos + resumo compactado do histórico.
  • Analogia: é arrumar a mesa — guarda na despensa o que não usa hoje, deixa na mesa só o que vai precisar.

Delegação para Subagentes: tarefa complexa precisa ser quebrada.

  • Problema: agente único em tarefa multi-módulo explode o contexto e embaralha responsabilidade.
  • Solução: agente principal planeja, subagentes executam módulos específicos, resultado volta consolidado para o principal.
  • Analogia: é o gerente de projeto distribuindo tarefa para front, back e QA, ele só acompanha cronograma e risco.

Gestão de Ciclo de Vida: do start, execução, pausa, retomada ao encerramento, cada estado exige controle fino.

  • Problema: tarefa longa cai a rede no meio, usuário cancela, modelo dá timeout — estado do agente se perde.
  • Solução: serialize cada estado em storage, habilite checkpoint e intervenção humana.
  • Analogia: é o save do jogo — morre, carrega do último ponto, não precisa zerar de novo.

Caminho 2: Use a Stack do Curso para Faturar e Construir Cases

Terminar o curso não é fim, é começo. Pegue a combinação Vercel AI SDK + Vercel Sandbox + just-bash e parta para o primeiro projeto real.

O caminho mais rápido para monetizar é anunciar serviço no Fiverr, Upwork e Mercado Livre / OLX: “Desenvolvo AI Agent customizado com a stack da Vercel”. Os três primeiros clientes podem ser a metade do preço ou até de graça — o objetivo é case e avaliação.

⚠️ Segundo o post original, fazer três clientes de graça pode levar de dias a semanas dependendo da complexidade do agente, e não verifiquei de forma independente; vale a pena se você converter os cases em clientes pagantes depois.

A escolha do case importa. Fuja de “faz um chatbot pra mim” — é commodity. Mire em “automatiza meu fluxo operacional”, que tem valor alto. Exemplos:

  • Para lojista de e-commerce跨境: agente que monitora avaliações na Amazon, extrai palavras-chave das críticas, gera sugestão de melhoria e dispara no Slack.
  • Para creator do Lemon8/Pinterest: agente que raspa posts de contas de referência, analisa padrão de viralização e gera lista de pautas.
  • Para dev independente: agente que monitora issues no GitHub, classifica por prioridade e gera rascunho de PR.

⚠️ Segundo o post original, esse tipo de projeto fica na casa de dezenas de milhares de reais, mas não verifiquei de forma independente.

Cold Start: Sem Carteira de Cliente, Como Destravar

A maioria começa sem cliente corporativo. Três canais concretos:

  1. Post em comunidade para puxar tráfego: publique em comunidades de Vibe Coding, fóruns de dev e Lemon8 posts de case com título no modelo “Construí um Agent com Vercel AI SDK para o setor X e economizo X horas/mês”, anexando vídeo-demo de 30 segundos. O tráfego traz cliente no direct.
  2. Freela de graça em troca de testimonial: peça indicação a amigos, cobre só R$ 500 no primeiro projeto, mas exija depoimento por escrito + autorização para tornar o case público.
  3. Escada de preço: R$ 500 (agente de módulo único) → R$ 3.000 (workflow multi-módulo) → R$ 30.000 (solução customizada completa + 6 meses de manutenção). Cada degrau exige o case do anterior como lastro.

Caminho 3: Reempacote o Curso e Monetize como Creator

O curso da Vercel é em inglês e tem barreira de entrada alta. Essa é exatamente a sua janela de informação assimétrica.

Quebre o conteúdo em 10 a 15 episódios e publique no TikTok, YouTube, Lemon8 e newsletter. Exemplos de título: “Vazou tutorial interno da Vercel: como escrever um framework de AI Agent”, “Tool loop de três funções é brinquedo — o agente de verdade precisa desses cinco módulos”, “Poda de contexto: a técnica que faz o agente parar de esquecer”.

Cada vídeo de 5 a 8 minutos destrincha um ponto técnico com demo de código. Plano prático:

  • Episódio 1 sobre tool loop, com 3 trechos de código (configuração generateText + tools do AI SDK, uso de stopWhen, exemplo de poda com prepareStep),控制在 7 minutos.
  • Teste A/B de título: “Vazou tutorial interno da Vercel” vs “Guia prático de framework de AI Agent” —投放 R$ 100 em impulsionamento para cada um, compare CTR, escale o vencedor.

Monetização em três camadas: camada 1 é anúncio de educação em programação; camada 2 é vender curso próprio empacotando a série em “Formação Prática de Engenheiro de AI Agent”; camada 3 é consultoria premium ajudando empresa a montar squad de agentes. ⚠️ Segundo o post original, conta com 10 mil seguidores cobra na casa de R$ 1.000 por anúncio de educação em programação, mas não verifiquei de forma independente.

Guia de Escolha: Qual Caminho é Para Você

  • Programador CLT querendo renda extra: combine caminho 2 com versão leve do caminho 3. Use o fim de semana para 1-2 freelas pequenos e grave o processo em vídeo curto para o Lemon8. Meta: R$ 5.000 a R$ 10.000/mês.
  • Freelancer mirando R$ 50.000/mês: vá fundo no caminho 2. Cold start de 3 meses — nos primeiros 3 não escolha cliente, só acumule case; a partir do quarto, mire cliente de ticket alto, ticket médio acima de R$ 30.000.
  • Estudante / migrando de carreira: comece pelo caminho 1, domine o curso, suba 5 projetos demo no GitHub como portfólio, só considere freela depois de 6 meses.

Case: O Próprio Curso do Joel Hooks é o Modelo

Joel Hooks é o autor do curso na Vercel Academy e o instrutor principal de “Build Your Own AI Coding Agent Harness”. Ele mesmo é case vivo de “engenheiro de agente monetizando” — produz tutorial técnico de qualidade, construiu marca pessoal forte na comunidade dev e o conteúdo é republicado em massa.

A jogada dele é replicável: stack central na Vercel AI SDK, entregável é “sistema de agente rodando” e não “trecho de código”. É exatamente o供给 mais escasso hoje no mercado de freela de agente.

⚠️ Sobre dados de renda de outros devs independentes (como US$ 50 mil/mês, 120 mil seguidores em seis meses), o material não trouxe fonte verificável, então este artigo não cita números específicos.

Trilha Para Quem Começa do Zero

Se você nunca mexeu com Node.js / TypeScript, siga essa ordem:

  1. Mês 1: base de Node.js + sintaxe TypeScript + conceitos de LLM (o que é token, prompt, function calling). Recursos em português: tutorial de TypeScript do DevDocs, “Manual do Engenheiro de IA”.
  2. Mês 2: foque só no módulo “tool loop” do curso, combinado com o quickstart oficial do AI SDK para rodar o demo.
  3. Mês 3: adicione o módulo “sandbox abstraction” e monte um agente que organiza pastas automaticamente.
  4. A partir do mês 4: comece a monetizar pelo caminho 2 ou 3.

Expectativa realista: no mês 1, domine apenas o módulo de tool loop, não tente engolir tudo de uma vez. 2 horas por dia, 30 dias depois você monta a menor cadeia de agente funcional.

Chamada Para Ação: Abra a Vercel Academy Hoje à Noite

O curso da Vercel Academy é aberto e gratuito, sem cadastro pago. Vá em vercel.com/academy, procure por “Build Your Own AI Coding Agent Harness”, entre na página e comece pelo primeiro módulo.

Não tente terminar tudo de uma vez. 2 horas por dia, domine tool loop e sandbox abstraction primeiro, depois parta para o MVP — mesmo que seja só um agente que organiza pastas.

Quando você conseguir montar em 30 minutos uma cadeia completa “ler arquivo → analisar conteúdo → gerar relatório → gravar novo arquivo”, você já passou 90% dos “alunos de tutorial de programação com IA”. Aí freela, vídeo, newsletter — tudo flui com conteúdo real.

Abra a Vercel Academy hoje à noite, comece pelo módulo de tool loop — 30 dias depois você vai agradecer a si mesmo.