Um agente de código é um sistema baseado em IA que usa o contexto de desenvolvimento para selecionar e realizar trabalho em direção a um objetivo de desenvolvimento de software.
Essa definição operacional aplica o conceito de agente de IA ao desenvolvimento. A implementação determina quais etapas o sistema pode escolher e executar, quais exigem participação humana e quais permanecem indisponíveis. O rótulo, sozinho, não especifica IDE, CLI, modelo, protocolo ou nível de autonomia.
Uma sugestão e uma etapa delegada são diferentes
Um patch gerado é conteúdo proposto. Aplicá-lo é uma operação realizada por uma pessoa ou por um mecanismo de execução. Um agente de código pode participar da escolha e da realização dessas etapas, mas uma interface que apenas exibe texto sugerido não estabelece a execução delegada desse texto.
Descreva o trabalho efetivo em vez de deduzi-lo do nome do assistente. Inspecionar código, alterar um artefato, selecionar um teste e solicitar trabalho em outro sistema são operações possíveis distintas. Nenhuma delas é obrigatória em todo agente de código, e a permissão para uma não cobre automaticamente as outras.
O trabalho de desenvolvimento pode executar mais que uma edição
Uma tarefa de desenvolvimento pode envolver código do repositório ou de dependências, além das mudanças propostas pelo próprio agente. Por exemplo, a documentação de scripts do npm v11 descreve etapas do ciclo de vida em torno da execução de testes e scripts executados por um shell. Essa é uma propriedade das ferramentas escolhidas, não uma exigência de que todo agente de código use npm ou shell.
Quando essas ferramentas estão disponíveis, examine o que é executado e sob qual identidade. O diff submetido não descreve necessariamente os acessos ou efeitos produzidos durante sua preparação. Um ambiente de execução pode expor recursos além dos arquivos que a tarefa pede para editar.
Descreva o escopo delegado
Especifique o objetivo de desenvolvimento, o repositório ou os artefatos relevantes, as operações permitidas, o ambiente de execução e as decisões que continuam com as pessoas. Uma tarefa de preparar uma mudança não autoriza, por si só, sua publicação ou a alteração de um serviço compartilhado. A credencial disponível pode permitir mais do que a tarefa atribuída.
Uma tool call é uma forma de solicitar uma operação. Ela não estabelece todo o trabalho por trás daquela interface nem o resultado de sua execução. Mantenha a etapa solicitada, a permissão aplicável e o resultado observado separados ao descrever o que o agente de código fez.
O guia de implantação da governança de agentes de código na empresa explica como transformar um fluxo autorizado em um piloto delimitado, com critérios de aceite explícitos.
O pilar de governança de agentes de código desenvolve os requisitos de autoridade, ambiente e evidência por trás dessa delegação.