Um agente de código é um agente de IA especializado em programar: lê um repositório, compreende como está organizado, altera os ficheiros necessários, executa os testes e encadeia dezenas de modificações numa única sessão. Ao contrário do autocompletar de um editor, que sugere a linha seguinte, o agente recebe um objetivo («passa os preços para cêntimos inteiros», «adiciona esta validação») e decide o que alterar, em que ordem e como testar.
Costuma trabalhar num ciclo: planeia, edita, executa (testes, compilação, scripts), lê o resultado e corrige. Pode abrir branches, preparar commits e, se lhe for permitido, fazer deploy.
O que muda com um agente de código
- Escrever deixa de ser o gargalo: o processo lento passa a ser saber o que pedir e verificar se o que foi entregue faz o que deve.
- Amplifica quem o dirige em ambos os sentidos: converte o conhecimento em trabalho concluído, e as lacunas em erros com boa aparência, repetidos em muitos ficheiros ao mesmo tempo.
- As permissões importam mais do que nunca: que repositórios, que branches, que credenciais e se tem ou não acesso a produção.
Boas práticas
- Pedir em passos delimitados e na ordem correta, com critérios de aceitação claros.
- Permissões mínimas e explícitas; produção apenas com aprovação humana.
- Testes antes e depois, cópia de segurança e reversão preparadas antes de fazer deploy.
- Verificar a afirmação «feito»: a afirmação não é a prova.
Na NAiOS, os agentes que atuam sobre sistemas reais seguem o princípio human in the loop: propõem, e a ação irreversível é confirmada por uma pessoa.