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

Vercel na Prática: Construa um AI Coding Agent Harness e Fature com Engenharia
RichardsonA 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
stopWhenpara encerrar o loop, combinado commaxStepslimitando 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 -rfno 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
prepareSteppara 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:
- 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.
- 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.
- 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+toolsdo AI SDK, uso destopWhen, exemplo de poda comprepareStep),控制在 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:
- 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”.
- Mês 2: foque só no módulo “tool loop” do curso, combinado com o quickstart oficial do AI SDK para rodar o demo.
- Mês 3: adicione o módulo “sandbox abstraction” e monte um agente que organiza pastas automaticamente.
- 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.





