Micro Agent

Descrição

Micro Agent é uma ferramenta alimentada por IA projetada para auxiliar desenvolvedores na escrita e refinamento de código. Sua funcionalidade principal gira em torno da geração de código que satisfaz casos de teste predefinidos, automatizando assim o processo iterativo de depuração e melhoria. Essa abordagem visa abordar o desafio comum de LLMs produzirem código que requer extensa correção manual.

A ferramenta opera gerando primeiro um caso de teste e, em seguida, produzindo código iterativamente até que todos os testes especificados passem. Essa metodologia de desenvolvimento orientado a testes (TDD) é central para o design do Micro Agent, garantindo que o código gerado não seja apenas funcional, mas também robusto e verificável. O projeto enfatiza uma filosofia de agente 'micro', o que significa que ele é intencionalmente focado em uma única tarefa bem definida: escrever testes e, em seguida, gerar código que passe nesses testes. Isso contrasta com agentes de IA de propósito mais geral que, às vezes, podem levar a erros compostos.

Micro Agent suporta integração com vários fornecedores populares de LLM, incluindo Claude, OpenAI e Ollama, bem como quaisquer serviços compatíveis com OpenAI como Groq. Os usuários podem configurar suas chaves de API e modelos preferidos diretamente através da interface de linha de comando. A ferramenta oferece dois modos principais de operação: correspondência de teste unitário e um modo experimental de correspondência visual. Na correspondência de teste unitário, os usuários fornecem um script de teste que o Micro Agent executa após cada tentativa de geração de código. O recurso de correspondência visual, que ainda está em desenvolvimento, permite que o agente tente corresponder a um design fornecido comparando a saída de código renderizada com uma captura de tela.

A instalação é simples via npm, exigindo Node.js v18 ou posterior. Começar pode ser tão simples quanto executar `micro-agent` em modo interativo, que guia o usuário através do processo de geração de código. Para casos de uso mais avançados, os usuários podem especificar caminhos de arquivo, scripts de teste, arquivos de prompt e até mesmo alvos visuais. O projeto também inclui opções para configurar o número máximo de execuções e gerenciar configurações através de um comando `config` dedicado ou variáveis de ambiente. Contribuições são bem-vindas, com foco em melhorar as capacidades do agente e a experiência do usuário.

Recursos principais de Micro Agent

• Geração e iteração de código com IA

• Abordagem de desenvolvimento orientado a testes

• Suporta múltiplos fornecedores de LLM (Claude, OpenAI, Ollama, Groq)

• Modo interativo para geração de código guiada

• Correspondência de teste unitário para verificação de código

• Correspondência visual experimental para conformidade com o design

• Chaves de API e modelos configuráveis

• Tentativas máximas configuráveis

• Integração com Visual Copilot para conversão de Figma para código

• Interface de linha de comando para configuração e execução

Primeiros passos com Micro Agent

1. 1

   Instalar: Execute `npm install -g @builder.io/micro-agent`

2. 2

   Configurar Chave de API: Use `micro-agent config set OPENAI_KEY=<seu token>` ou `micro-agent config set ANTHROPIC_KEY=<seu token>`

3. 3

   Definir Modelo: Use `micro-agent config set MODEL=<nome do modelo>` (ex: `gpt-4o`, `claude-3-5-sonnet-20241022`)

4. 4

   Executar Interativamente: Execute `micro-agent` e siga as instruções

5. 5

   Executar com Testes: Use `micro-agent <caminho do arquivo> -t "<script de teste>"`

6. 6

   Executar com Correspondência Visual: Use `micro-agent <caminho do arquivo> --visual <url>` (requer chave de API Anthropic)

Casos de uso de Micro Agent

• Refinamento Automatizado de Código
• Assistência em Desenvolvimento Orientado a Testes
• Prototipagem Rápida
• Redução de Depuração Manual
• Implementação de Design para Código
• Melhoria na Geração de Código de LLM
• Aumento da Produtividade do Desenvolvedor

Perguntas frequentes de Micro Agent

• O que é o Micro Agent e o que ele faz?

  Micro Agent é uma ferramenta de IA que escreve e corrige código iterativamente. Ele gera código com base em casos de teste e o refina até que todos os testes passem, visando melhorar a qualidade do código e reduzir o esforço manual.

• Quais fornecedores de LLM o Micro Agent suporta?

  Micro Agent suporta Claude, OpenAI, Ollama e quaisquer fornecedores compatíveis com OpenAI como Groq.

• Como o Micro Agent garante a qualidade do código?

  Ele emprega uma abordagem de desenvolvimento orientado a testes, gerando código que deve passar em testes unitários especificados. Ele itera sobre o código até que todos os casos de teste sejam satisfeitos.

• Qual é o aspecto 'micro' do Micro Agent?

  A designação 'micro' significa seu propósito focado: ser excelente em escrever testes e, em seguida, produzir código que passe nesses testes, evitando a complexidade e os erros potenciais de agentes de codificação de propósito geral.

• O Micro Agent pode ajudar na implementação de design visual?

  Sim, Micro Agent possui um recurso experimental de correspondência visual que tenta corresponder a saída de código renderizada a uma captura de tela de design fornecida. Ele também se integra ao Visual Copilot para conversão de Figma para código.

• Quais são os pré-requisitos para instalar o Micro Agent?

  Micro Agent requer Node.js v18 ou posterior instalado em seu sistema.

• Como configuro chaves de API para o Micro Agent?

  Você pode configurar chaves de API usando a linha de comando, por exemplo: `micro-agent config set OPENAI_KEY=<seu token>` ou `micro-agent config set ANTHROPIC_KEY=<seu token>`.

• Posso especificar qual modelo de IA o Micro Agent usa?

  Sim, você pode definir o modelo preferido usando `micro-agent config set MODEL=<nome do modelo>`, como `gpt-4o` ou `claude-3-5-sonnet-20241022`.

• O que é o modo 'correspondência de teste unitário'?

  Neste modo, você fornece um script de teste que o Micro Agent executa após cada tentativa de geração de código. O agente continua a gerar código até que o script seja executado com sucesso.

• Como posso contribuir para o projeto Micro Agent?

  Contribuições são bem-vindas. Você pode enviar Pull Requests e verificar o arquivo `./CONTRIBUTING.md` para obter diretrizes. Questões rotuladas como 'good first issue' também estão disponíveis para novos contribuidores.

• Qual é o número padrão de execuções que o Micro Agent tenta?

  Por padrão, o Micro Agent tenta 10 execuções. Isso pode ser alterado usando a flag `-m`, por exemplo: `micro-agent ./file-to-edit.ts -m 20`.

• O Micro Agent lida com operações complexas de múltiplos arquivos?

  Não, o Micro Agent é projetado como um agente 'micro' e não tenta instalar módulos, ler/escrever múltiplos arquivos ou realizar outras operações complexas que poderiam levar a erros significativos.