Micro Agent

Micro Agent의 제품 특징

개요

Micro Agent는 BuilderIO에서 개발한 오픈 소스 AI 에이전트로, 코드 작성 및 수정 프로세스를 자동화하도록 설계되었습니다. 복합적인 오류가 발생하기 쉬운 범용 AI 코딩 에이전트와 달리, Micro Agent는 작고, 집중적이며, 특정 작업에 특화되어 있습니다. 즉, 정의된 테스트 케이스를 통과할 때까지 코드를 생성하고 반복하는 "마이크로" 에이전트입니다. 코드 생성 및 수정의 반복적인 프로세스를 처리하여 개발자가 더 높은 수준의 작업에 집중할 수 있도록 함으로써 개발 워크플로우를 간소화하는 것을 목표로 합니다.

주요 목적 및 대상 사용자 그룹

• 주요 목적: 주어진 프롬프트와 테스트 케이스를 기반으로 코드를 생성하고 모든 테스트가 통과할 때까지 반복적으로 개선합니다. LLM이 생성한 깨진 코드를 수정하는 번거로운 프로세스를 자동화합니다.

• 대상 사용자 그룹:

  • 코딩 프로세스를 가속화하려는 소프트웨어 개발자 및 엔지니어.
  • 테스트 주도 개발(TDD)을 보다 효율적으로 구현하려는 팀.
  • 생성된 코드가 기능적이고 정확한지 확인하기 위한 신뢰할 수 있는 방법이 필요한 코드 생성용 대규모 언어 모델(LLM) 사용자.
  • 제어되고 집중된 방식으로 코드 자동화를 위해 AI를 활용하는 데 관심이 있는 개인 및 조직.

기능 세부 정보 및 작업

• 테스트 주도 코드 생성: Micro Agent의 핵심 기능은 코드를 생성한 다음 제공된 테스트 스크립트를 통과할 때까지 반복하는 것입니다.

• 대화형 모드: 사용자는 대화형 모드(micro-agent)에서 Micro Agent를 실행할 수 있으며, 이 모드에서는 질문을 하고 사용자 피드백을 사용하여 코드 생성을 개선합니다.

• 단위 테스트 일치:

  • 편집할 파일과 테스트 스크립트(예: npm test)를 가져옵니다.
  • 기본 테스트 파일 명명 규칙(예: .ts 파일의 경우 .test.ts)을 가정합니다.
  • 사용자 지정 테스트 파일 경로(-f) 및 프롬프트 파일(-p)을 지정할 수 있습니다.

• 시각적 일치(실험적):

  • 렌더링된 코드의 로컬 URL과 스크린샷 파일을 제공하여 코드를 디자인과 일치시킬 수 있습니다.
  • 최적의 성능을 위해 Anthropic API 키가 필요하며, 시각적 피드백에는 Anthropic Claude Opus를 활용하고 코드 생성에는 OpenAI를 활용합니다.

• LLM API 키 구성: Claude, OpenAI, Ollama 또는 OpenAI 호환 공급자를 포함한 다양한 LLM과의 통합을 지원합니다. 사용자는 micro-agent config set 명령 또는 환경 변수를 통해 API 키를 구성하고 모델(예: gpt-4o, claude)을 선택할 수 있습니다.

• 사용자 지정 OpenAI API 엔드포인트: Ollama와 같은 로컬 LLM 또는 Groq와 같은 다른 공급자와 함께 사용할 사용자 지정 엔드포인트를 설정할 수 있습니다.

• Figma와의 통합(Visual Copilot을 통해): Visual Copilot과 통합하여 Figma와 직접 연결할 수 있으며, 고품질 디자인-코드 변환, 정확한 디자인 토큰 매핑 및 구성 요소 재사용을 가능하게 합니다. Micro Agent는 출력을 개선하여 테스트를 통과하고 디자인과 일치하도록 합니다.

• 구성 옵션:

  • --max-runs (-m): 코드 생성 및 테스트 최대 시도 횟수를 설정합니다.
  • config 명령: API 키, 모델 및 대화형 UI를 포함한 기타 구성을 설정하는 CLI를 제공합니다.
  • 환경 변수: 모든 구성 옵션은 환경 변수를 사용하여 재정의할 수 있습니다.

• 업데이트 메커니즘: 최신 버전으로 쉽게 업그레이드할 수 있는 명령(micro-agent update)이 포함되어 있습니다.

사용자 혜택

• 생산성 향상: 코드 수정의 반복적인 프로세스를 자동화하여 개발자의 시간과 노력을 크게 절약합니다.

• 높은 코드 품질: 생성된 코드가 지정된 테스트 기준을 충족하는지 확인하여 더욱 견고하고 신뢰할 수 있는 애플리케이션을 만듭니다.

• 수동 디버깅 감소: 테스트 통과 시까지 자동으로 반복하여 AI 생성 코드의 수동 디버깅 필요성을 최소화합니다.

• 집중된 AI 애플리케이션: "마이크로" 에이전트로서 지나치게 야심찬 AI 에이전트의 일반적인 함정을 피하고 특정 작업에 대한 신뢰할 수 있는 결과를 제공합니다.

• 유연성: 다양한 LLM을 지원하며 다양한 개발 환경 및 선호도에 맞는 광범위한 구성 옵션을 제공합니다.

• 테스트 주도 개발(TDD) 촉진: TDD 워크플로우와 자연스럽게 통합되고 향상시킵니다.

호환성 및 통합

• Node.js: Node.js v18 이상이 필요합니다.

• LLM: OpenAI(예: GPT-4o, GPT-3.5-turbo), Anthropic(예: Claude, Claude-3-5-Sonnet), Ollama 및 기타 OpenAI 호환 공급자와 호환됩니다.

• 개발 환경: 기존 테스트 스크립트(예: npm test)와 통합하여 일반적인 소프트웨어 개발 워크플로우 내에서 작동하도록 설계되었습니다.

• Figma: 디자인-코드 워크플로우를 위해 Visual Copilot을 통해 Figma와 통합됩니다.

• 운영 체제: Node.js가 지원되는 다양한 운영 체제에서 작동합니다.

고객 피드백 및 사례 연구

• 커뮤니티 참여

  • GitHub 별: GitHub에서 4.1k개의 별을 받아 강력한 커뮤니티 관심과 채택을 나타냅니다.
  • 포크: 371개의 포크는 활발한 커뮤니티 참여와 기여 가능성을 시사합니다.
  • 이슈: 40개의 미해결 이슈는 지속적인 개발 및 개선 및 버그 수정에 대한 커뮤니티 상호 작용을 보여줍니다.
  • 블로그 게시물: Builder.io 블로그에서 존재 및 목적에 대한 추가 세부 정보와 통찰력을 얻을 수 있습니다.
  • 커뮤니티 기여: 신규 기여자를 위한 good first issue 레이블과 함께 기여를 환영합니다.

접근 및 활성화 방법

• 설치: npm 패키지로 제공됩니다. npm install -g @builder.io/micro-agent를 사용하여 전역으로 설치할 수 있습니다.

• 실행: 대화형 모드의 경우 micro-agent를 사용하거나, 단위 테스트 또는 시각적 일치를 위한 특정 플래그와 함께 명령줄에서 실행합니다.

• API 키 구성: 사용자가 micro-agent config set 명령을 사용하여 선택한 LLM 공급자(예: OpenAI, Anthropic)에 대한 API 키를 설정해야 합니다.

Micro Agent란 무엇인가요?

Micro Agent는 BuilderIO가 개발한 오픈 소스 AI 에이전트로, 코드를 작성하고 수정합니다. 테스트 케이스를 생성한 다음 모든 테스트 케이스가 통과할 때까지 코드를 반복적으로 수정하여 기능적인 코드를 얻는 과정을 효율적으로 만들도록 설계되었습니다.

Micro Agent는 다른 AI 코딩 에이전트와 어떻게 다른가요?

Micro Agent는 "마이크로" 에이전트로, 작고 집중적이며 한 가지 작업, 즉 테스트를 작성하고 해당 테스트를 통과하는 코드를 생성하는 데 특화되어 있습니다. 복합적인 오류로 인해 때때로 “오작동”할 수 있는 범용 코딩 에이전트와 달리, Micro Agent는 특정 반복 프로세스에 집중하여 신뢰성을 목표로 합니다. 종단 간 개발자 역할을 하거나, 모듈을 설치하거나, 여러 파일을 관리하려고 시도하지 않습니다.

Micro Agent의 주요 기능은 무엇인가요?

Micro Agent는 다음을 제공합니다:

• 테스트 주도 개발 (Test-Driven Development)

  테스트를 생성하고 테스트가 통과할 때까지 코드를 반복합니다.

• 대화형 모드 (Interactive Mode)

  질문을 하고 사용자의 피드백을 활용하여 생성된 코드를 개선하는 대화형 경험을 제공합니다.

• LLM API 키 지원 (LLM API Key Support)

  Claude, OpenAI, Ollama 또는 OpenAI 호환 제공업체를 포함한 다양한 LLM과 작동합니다.

• 단위 테스트 매칭 (Unit Test Matching)

  지정된 테스트 스크립트가 통과할 때까지 파일에서 코드를 실행하고 반복할 수 있습니다.

• 시각적 매칭 (실험적) (Visual Matching (Experimental))

  렌더링된 출력을 스크린샷과 비교하여 디자인에 맞게 코드를 생성할 수 있습니다(Anthropic API 키 필수).

• Figma 통합 (Figma Integration)

  Visual Copilot과 통합하여 고충실도 디자인-코드 변환을 수행하고 구성 요소와 디자인 토큰을 재사용할 수 있습니다.

• 구성 가능 (Configurable)

  CLI 명령 또는 환경 변수를 통해 API 키, 모델 및 최대 실행 횟수를 설정할 수 있습니다.

Micro Agent의 시스템 요구 사항은 무엇인가요?

Micro Agent는 Node.js v18 이상을 필요로 합니다.

Micro Agent는 어떻게 설치하나요?

npm을 사용하여 Micro Agent를 전역으로 설치할 수 있습니다: npm install -g @builder.io/micro-agent

Micro Agent는 어떻게 시작하나요?

가장 쉬운 시작 방법은 대화형 모드에서 Micro Agent를 실행하는 것입니다: micro-agent 이것은 프로세스를 안내하고 사용자의 피드백을 활용하여 생성된 코드를 개선할 것입니다.

Micro Agent에 내 LLM API 키는 어떻게 구성하나요?

config set 명령을 사용하여 API 키를 설정할 수 있습니다. OpenAI의 경우: micro-agent config set OPENAI_KEY=<your token> Anthropic의 경우: micro-agent config set ANTHROPIC_KEY=<your token> Ollama 또는 Groq와 같은 제공업체를 위한 사용자 지정 OpenAI API 엔드포인트를 설정할 수도 있습니다.

Micro Agent를 시각적 디자인 매칭에 사용할 수 있나요?

예, Micro Agent에는 실험적인 시각적 매칭 기능이 있습니다. 디자인(스크린샷으로)과 렌더링된 코드의 로컬 URL을 제공하면 Micro Agent가 디자인에 맞게 코드를 생성합니다. 이 기능은 현재 최적의 성능을 위해 Anthropic API 키를 필요로 합니다.

Micro Agent 프로젝트에 어떻게 기여할 수 있나요?

Micro Agent는 오픈 소스이며 기여를 환영합니다. GitHub 저장소 내의 CONTRIBUTING.md 파일에서 지침을 찾을 수 있습니다. 기여가 처음이라면 "good first issue" 라벨이 붙은 이슈를 찾아보세요.

더 많은 정보는 어디서 찾거나 피드백을 제공할 수 있나요?

프로젝트의 GitHub 페이지에서 자세한 내용을 확인할 수 있습니다: https://github.com/BuilderIO/micro-agent 피드백을 제공하려면 GitHub 저장소에 이슈를 열거나 Twitter에서 @steve8708에게 연락할 수 있습니다.