Guia do iniciante em AI Agents
Essas semanas estava conversando com meu primo que queria usar IA para organizar os arquivos dele, que estavam todos jogados em uma pasta sem ordem nenhuma. Sugeri que usasse o Claude Code ou o Codex, que podem através de agentes fazer diversas alterações no PC: criar, escrever e deletar arquivos, entre outras coisas.
Quanto mais eu ia passando pra ele as coisas que pra mim são triviais, percebi que quem já é da área de TI e/ou programador tem uma grande facilidade de entender a IA, pois ela faz um trabalho que nós já fazíamos antes manualmente, e estamos mais acostumados com configurações, código, frameworks etc. Mas para quem é leigo pode parecer coisa de outro mundo e pode até ser um pouco perigoso.
Então pensei: qual é o conhecimento mínimo que uma pessoa precisa ter antes de conseguir usar esses novos agentes de IA de maneira segura? Com isso montei a seguinte lista.
Git (Prioridade máxima!)
Um dos maiores perigos de usar esses agentes é ele simplesmente decidir "liberar espaço" como um irmão mais novo faz nos jogos salvos do seu memory card. Se você não tiver backups pode dizer adeus, pois dificilmente eles mandam os arquivos pra lixeira (vale configurá-los depois para fazerem isso).
Claro que você pode criar um monte de arquivo zip pra cada backup e salvar no Google Drive ou Dropbox, naquele esquema de relatorio_v3_FINAL_agora_vai.zip. Mas o Git está aí há anos pra solucionar esse problema de maneira mais elegante. Ele também pode ser usado para qualquer arquivo, não somente arquivos de código. Então se você tem uma planilha local importante com várias versões, vale a pena dar uma olhada.
Recomendo FORTEMENTE que você peça para o ChatGPT, Gemini, Claude ou seja quem for te ensinar sobre. Tenho sentido que é a maneira mais rápida de aprendizado hoje. Se preferir algo mais estruturado, o link abaixo é um bom começo.
Curso gratuito do Gustavo Guanabara: Curso de Git e GitHub no Curso em Vídeo, também disponível como playlist no YouTube.
Entenda o que o agente pode fazer antes de deixar ele fazer
Todas essas ferramentas têm modos de aprovação: o agente mostra o que pretende executar e você aceita ou recusa. No começo, deixe tudo no modo mais restritivo e leia o que ele vai rodar antes de aprovar. Resista à tentação de liberar acesso total logo de cara. Depois que você entender o padrão do que ele faz, aí sim vale afrouxar as permissões pra ganhar velocidade.
Noções básicas de arquitetura de software
Esse item vale principalmente pra quem quer construir alguma coisa, não só automatizar tarefas do dia a dia. Entender como o que você quer construir funciona ajuda a direcionar o agente para a direção certa. Saber como seu sistema vai se comunicar com seus arquivos, banco de dados e telas é super importante.
Não precisa entender tudo nem saber das melhores práticas, mas é importante saber diferenciar o frontend de um backend e ter uma noção do que é uma API, um banco de dados e MCP (um padrão que conecta a IA a outras ferramentas).
Um bom ponto de partida: Frontend e Backend, entendendo os pilares do desenvolvimento web.
Escolha uma ferramenta e fique com ela
Hoje existem várias ferramentas no mercado: Claude Code, Codex, Cursor, Antigravity, VSCode + Copilot etc. Todas compartilham coisas em comum e também têm suas diferenças.
Ficar pulando de uma ferramenta a outra enquanto você não ficou bom em uma só não vale a pena, pois você vai gastar tempo reaprendendo a base da ferramenta e não aprendendo os fundamentos de uso dos agentes.
Recomendo começar com o Codex, que tem uma interface mais amigável. O Claude Code sinto que é mais usado, mas tem uma curva de aprendizado maior. Pode mudar pra ele quando estiver mais familiarizado (ou continuar no Codex, que é uma boa opção também).
Conhecimento básico de terminal (opcional, mas ajuda muito)
Se você pegar o core dos agentes de hoje, o que eles fazem é escrever arquivos e rodar comandos de terminal. Só. Então ter noção dos comandos que ele está executando ajuda a entender o caminho e a direcionar o agente quando ele estiver indo pro lugar errado.