Building an Internal Coding Agent at Zup: Lessons and Open Questions
O artigo apresenta o CodeGen, um agente de codificação interno da Zup, demonstrando que decisões de engenharia como design de ferramentas, salvaguardas de segurança e modos de supervisão humana são mais decisivos para a adoção e confiabilidade em produção do que apenas a qualidade do modelo ou o *prompt engineering*.
Artigo original sob licença CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta é uma explicação gerada por IA do artigo abaixo. Não foi escrita nem endossada pelos autores. Para precisão técnica, consulte o artigo original. Ler aviso legal completo
Imagine que você está construindo um estagiário de programação superinteligente para trabalhar na sua empresa. Esse estagiário não é apenas um corretor ortográfico que sugere palavras; ele é um "agente" que pode ler seus arquivos, escrever código novo, rodar comandos no computador e tentar resolver problemas sozinho.
Este artigo conta a história de como a empresa Zup (no Brasil) criou o seu próprio estagiário, chamado CodeGen, e as lições que aprenderam no caminho. A grande descoberta deles foi: ter um cérebro inteligente (o modelo de IA) não é suficiente. O segredo está em como você organiza a mesa de trabalho, dá as ferramentas certas e define as regras de segurança.
Aqui está a explicação do artigo, traduzida para uma linguagem do dia a dia:
1. O Problema: O "Gênio" Desastrado
Muitas empresas tentam criar esses agentes baseados em Inteligência Artificial (IA). Elas gastam muito tempo escolhendo o "cérebro" mais inteligente (o modelo de linguagem). Mas, na prática, esses agentes costumam falhar quando saem do laboratório e vão para o mundo real.
A analogia: Imagine que você contratou um gênio da culinária. Ele sabe cozinhar qualquer prato do mundo. Mas, se você não der a ele facas seguras, não tiver um limite para quanto sal ele pode usar e não tiver um chefe para aprovar o prato antes de servir, ele pode acabar queimando a cozinha ou envenenando os clientes.
O artigo diz que o problema não é a inteligência do "cozinheiro", mas sim como a cozinha foi montada.
2. A Solução da Zup: O CódigoGen
A Zup criou o CodeGen. Em vez de apenas sugerir código, ele age. Mas eles aprenderam que a mágica não estava no modelo de IA, e sim em 4 pilares de engenharia:
A. As Ferramentas (O Kit de Ferramentas)
Se você der ao estagiário um martelo gigante para pregos minúsculos, ele vai quebrar tudo.
- O Erro Comum: Pedir para a IA reescrever um arquivo inteiro de uma vez. A IA costuma "cortar" o texto ou esquecer partes no meio do caminho (como se ela tivesse falta de ar ao escrever um livro inteiro de uma só vez).
- A Solução da Zup: Eles criaram uma ferramenta de "troca de texto". Em vez de pedir para reescrever o livro todo, a IA só troca uma frase específica por outra. É como usar um corretor de texto para mudar apenas uma palavra, em vez de reescrever a página inteira. Isso evita erros gigantes.
B. A Segurança (O Guarda-Costas)
O agente precisa rodar comandos no seu computador (como instalar programas ou apagar arquivos). Isso é perigoso.
- O Perigo: Se o agente tiver acesso total, ele pode, sem querer, apagar tudo (
rm -rf) ou enviar código errado para o servidor. - A Solução: Eles criaram camadas de segurança.
- Modo Aprovação: No começo, o agente é como um estagiário que precisa que o chefe diga "OK" antes de fazer qualquer coisa que mude algo.
- Modo Autônomo: Conforme o chefe ganha confiança, ele deixa o estagiário trabalhar sozinho.
- Regra de Ouro: Não adianta bloquear uma ferramenta se o agente puder fazer a mesma coisa perigosa por outro caminho. A segurança tem que ser vista como um sistema inteiro, não peça por peça.
C. A Memória (O Caderno de Anotações)
O agente precisa lembrar o que fez há 5 minutos para não repetir erros.
- A Solução: Eles criaram um sistema de memória que dura o tempo da sessão de trabalho (como um caderno que você usa durante o expediente e joga fora à noite). Isso é suficiente para tarefas complexas sem precisar de uma memória eterna e complicada que pode confundir o agente com informações velhas.
D. A Confiança (O Treinamento)
Ninguém confia num estagiário novo para dirigir o carro sozinho no primeiro dia.
- A Estratégia: Eles não forçaram os desenvolvedores a confiar cegamente. Eles deixaram os humanos começarem no "Modo Aprovação" (onde o humano aprova cada passo). Aos poucos, conforme o agente acerta, os humanos passam para o "Modo Autônomo". A confiança foi construída organicamente, passo a passo.
3. Lições Importantes (O que eles descobriram)
- Não adianta só melhorar o "cérebro": Melhorar a descrição de como as ferramentas funcionam (o manual de instruções) é mais importante do que tentar fazer o modelo de IA pensar "mais inteligente" com prompts mágicos.
- Faça na mão antes de usar pronto: Eles tentaram usar frameworks prontos (como LangChain), mas eles não se encaixavam bem na necessidade de um ciclo de "pensar-fazer-verificar". Então, eles construíram a lógica deles mesmos. Só depois, quando as ferramentas do mercado evoluíram, eles perceberam que tinham inventado a roda certa. Isso deu a eles o controle total.
- Segurança é um sistema, não um botão: Bloquear uma ferramenta perigosa não adianta se houver outra ferramenta que faça a mesma coisa perigosa. A segurança precisa ser consistente em tudo.
4. Perguntas que ainda ficam no ar (O Futuro)
O artigo termina dizendo que ainda há mistérios para resolver:
- Como criar manuais de ferramentas que a IA nunca erre?
- Onde traçar a linha entre o que a IA decide e o que o humano controla?
- Como fazer o agente lembrar de coisas de meses atrás sem se confundir?
- Como garantir que o código que a IA escreve seja testado tão bem quanto o código humano?
Resumo Final
Construir um agente de programação para empresas não é sobre ter a IA mais cara do mercado. É sobre engenharia de processos. É como montar um time: você precisa das ferramentas certas, regras claras, um sistema de segurança robusto e um processo de treinamento que permita que a confiança cresça naturalmente.
O CodeGen da Zup funcionou porque eles focaram em como o agente trabalha, e não apenas em o que o agente pensa.
Afogado em artigos na sua área?
Receba digests diários dos artigos mais recentes que correspondam às suas palavras-chave de pesquisa — com resumos técnicos, no seu idioma.