Micro Agent

Описание

Micro Agent — это инструмент на базе ИИ, предназначенный для помощи разработчикам путем написания и доработки кода. Его основная функциональность заключается в генерации кода, который удовлетворяет предопределенным тестовым случаям, тем самым автоматизируя итеративный процесс отладки и улучшения. Этот подход направлен на решение распространенной проблемы, когда LLM генерируют код, требующий обширной ручной коррекции.

Инструмент работает, сначала генерируя тестовый случай, а затем итеративно создавая код до тех пор, пока все указанные тесты не будут пройдены. Эта методология разработки на основе тестов (TDD) является центральной в дизайне Micro Agent, гарантируя, что сгенерированный код является не только функциональным, но и надежным и проверяемым. Проект подчеркивает философию «микро»-агента, что означает, что он намеренно сфокусирован на одной, четко определенной задаче: написании тестов, а затем генерации кода, который проходит эти тесты. Это контрастирует с более универсальными ИИ-агентами, которые иногда могут приводить к накоплению ошибок.

Micro Agent поддерживает интеграцию с несколькими популярными поставщиками LLM, включая Claude, OpenAI и Ollama, а также любыми совместимыми с OpenAI сервисами, такими как Groq. Пользователи могут настраивать свои API-ключи и предпочтительные модели непосредственно через интерфейс командной строки. Инструмент предлагает два основных режима работы: сопоставление модульных тестов и экспериментальный режим визуального сопоставления. В режиме сопоставления модульных тестов пользователи предоставляют скрипт тестов, который Micro Agent выполняет после каждой попытки генерации кода. Функция визуального сопоставления, которая все еще находится в разработке, позволяет агенту пытаться сопоставить заданный дизайн, сравнивая отрисованный вывод кода со скриншотом.

Установка проста через npm, требуется Node.js v18 или новее. Начало работы может быть таким же простым, как запуск `micro-agent` в интерактивном режиме, который направляет пользователя через процесс генерации кода. Для более продвинутых сценариев использования пользователи могут указывать пути к файлам, скрипты тестов, файлы подсказок и даже визуальные цели. Проект также включает опции для настройки максимального количества запусков и управления настройками с помощью специальной команды `config` или переменных окружения. Вклад приветствуется, с акцентом на улучшение возможностей агента и пользовательского опыта.

Основные функции Micro Agent

• Генерация и итерация кода на базе ИИ

• Подход к разработке на основе тестов

• Поддержка нескольких поставщиков LLM (Claude, OpenAI, Ollama, Groq)

• Интерактивный режим для управляемой генерации кода

• Сопоставление модульных тестов для проверки кода

• Экспериментальное визуальное сопоставление для соответствия дизайну

• Настраиваемые API-ключи и модели

• Настраиваемое максимальное количество попыток запуска

• Интеграция с Visual Copilot для преобразования Figma в код

• Интерфейс командной строки для настройки и выполнения

Начало работы с Micro Agent

1. 1

   Установка: Выполните `npm install -g @builder.io/micro-agent`

2. 2

   Настройка API-ключа: Используйте `micro-agent config set OPENAI_KEY=<ваш токен>` или `micro-agent config set ANTHROPIC_KEY=<ваш токен>`

3. 3

   Установка модели: Используйте `micro-agent config set MODEL=<имя модели>` (например, `gpt-4o`, `claude-3-5-sonnet-20241022`)

4. 4

   Запуск в интерактивном режиме: Выполните `micro-agent` и следуйте подсказкам

5. 5

   Запуск с тестами: Используйте `micro-agent <путь к файлу> -t "<скрипт тестов>"`

6. 6

   Запуск с визуальным сопоставлением: Используйте `micro-agent <путь к файлу> --visual <url>` (требуется API-ключ Anthropic)

Варианты использования Micro Agent

• Автоматическая доработка кода
• Помощь в разработке на основе тестов
• Быстрое прототипирование
• Сокращение ручной отладки
• Реализация дизайна в код
• Улучшение генерации кода LLM
• Повышение производительности разработчика

Часто задаваемые вопросы Micro Agent

• Что такое Micro Agent и что он делает?

  Micro Agent — это инструмент на базе ИИ, который пишет и итеративно исправляет код. Он генерирует код на основе тестовых случаев и дорабатывает его до тех пор, пока все тесты не будут пройдены, с целью повышения качества кода и сокращения ручных усилий.

• Какие поставщики LLM поддерживает Micro Agent?

  Micro Agent поддерживает Claude, OpenAI, Ollama и любых совместимых с OpenAI поставщиков, таких как Groq.

• Как Micro Agent обеспечивает качество кода?

  Он использует подход разработки на основе тестов, генерируя код, который должен пройти указанные модульные тесты. Он итеративно дорабатывает код до тех пор, пока все тестовые случаи не будут удовлетворены.

• Что означает аспект «микро» в Micro Agent?

  Обозначение «микро» означает его сфокусированную цель: преуспеть в написании тестов, а затем в создании кода, который проходит эти тесты, избегая сложности и потенциальных ошибок универсальных агентов для кодирования.

• Может ли Micro Agent помочь с реализацией визуального дизайна?

  Да, Micro Agent имеет экспериментальную функцию визуального сопоставления, которая пытается сопоставить отрисованный вывод кода с предоставленным скриншотом дизайна. Он также интегрируется с Visual Copilot для преобразования Figma в код.

• Каковы предварительные требования для установки Micro Agent?

  Для установки Micro Agent требуется Node.js v18 или новее.

• Как настроить API-ключи для Micro Agent?

  Вы можете настроить API-ключи с помощью командной строки, например: `micro-agent config set OPENAI_KEY=<ваш токен>` или `micro-agent config set ANTHROPIC_KEY=<ваш токен>`.

• Могу ли я указать, какую модель ИИ использует Micro Agent?

  Да, вы можете установить предпочтительную модель, используя `micro-agent config set MODEL=<имя модели>`, например `gpt-4o` или `claude-3-5-sonnet-20241022`.

• Что такое режим «сопоставление модульных тестов»?

  В этом режиме вы предоставляете скрипт тестов, который Micro Agent запускает после каждой попытки генерации кода. Агент продолжает генерировать код до тех пор, пока скрипт не выполнится успешно.

• Как я могу внести свой вклад в проект Micro Agent?

  Вклад приветствуется. Вы можете отправлять Pull Requests и ознакомиться с файлом `./CONTRIBUTING.md` для получения руководств. Также доступны проблемы с меткой «good first issue» для новых участников.

• Каково количество запусков по умолчанию, которое пытается выполнить Micro Agent?

  По умолчанию Micro Agent пытается выполнить 10 запусков. Это можно изменить с помощью флага `-m`, например: `micro-agent ./file-to-edit.ts -m 20`.

• Обрабатывает ли Micro Agent сложные многофайловые операции?

  Нет, Micro Agent разработан как «микро»-агент и не пытается устанавливать модули, читать/записывать несколько файлов или выполнять другие сложные операции, которые могут привести к значительным ошибкам.