Construindo um Agente de Codificação de IA Local Seguro com Node.js
Agentes de IA parecem complexos. Eles não são.
Um agente é simplesmente um LLM conectado a um loop, ferramentas e regras de segurança.
Eu construí um agente de codificação local usando Node.js e Mistral via Ollama. Você não precisa de chaves de API pagas. Tudo roda na sua máquina.
O agente ajuda você a entender seus projetos JavaScript. Ele pode: • Listar arquivos do projeto • Ler arquivos do projeto • Pesquisar texto • Explicar código • Encontrar bugs • Propor mudanças de código
O princípio fundamental é a segurança. O agente pode inspecionar arquivos, mas não pode editá-los. Ele apenas retorna uma proposta de patch para você revisar. Isso mantém um humano no loop.
Como o agente funciona: Um chatbot normal segue um caminho simples: Usuário faz uma pergunta -> O modelo responde
Um agente segue um loop: Usuário faz uma pergunta -> O modelo decide por uma ferramenta -> O JavaScript executa a ferramenta -> O modelo vê o resultado -> O modelo responde
Principais padrões usados neste projeto: • Agent loop: O processo se repete até que o modelo forneça uma resposta final. • Tool calling: O modelo solicita funções JavaScript específicas. • Tool allowlist: Apenas ferramentas aprovadas são executadas. • System prompt: Regras dizem ao modelo como se comportar. • JSON action protocol: O modelo responde com dados estruturados. • Safety boundary: O acesso a arquivos permanece dentro da raiz do seu projeto.
A segurança é a prioridade. Usei uma função chamada safeResolve para evitar path traversal. Isso garante que o agente não consiga acessar arquivos fora da pasta do seu projeto. Também defini limites para o tamanho dos arquivos para proteger o contexto do modelo.
A estrutura do projeto: • src/cli.js: O ponto de entrada do terminal. • src/agent.js: O loop principal e o despacho de ferramentas. • src/ollama.js: O cliente de API local. • src/tools.js: Ferramentas seguras de sistema de arquivos. • test/tools.test.js: Testes de segurança e comportamento.
Você pode executar este projeto com Node.js e Ollama. Use o Mistral ou experimente modelos específicos para codificação, como Qwen2.5-Coder ou DeepSeek-Coder, para obter melhores resultados.
Construa ferramentas úteis. Mantenha-as restritas. Deixe seu código impor os limites de segurança.
Fonte: https://dev.to/gaurav101/building-a-safe-local-ai-coding-agent-with-nodejs-46ol