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 Claude Opusを活用し、コード生成のためにOpenAIを利用するため、最適なパフォーマンスにはAnthropic APIキーが必要です。

• 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のフォークがあり、活発なコミュニティへの参加と貢献の可能性を示唆しています。
  • Issues: 40の未解決のIssueがあり、継続的な開発と改善およびバグ修正のためのコミュニティの交流を示しています。
  • ブログ投稿: Builder.ioブログで、その存在と目的についてのさらなる詳細と洞察が提供されています。
  • コミュニティ貢献: 新規貢献者向けのgood first issueラベルとともに、貢献を歓迎しています。

アクセスとアクティベーション方法

• インストール：npmパッケージとして利用可能です。npm install -g @builder.io/micro-agent を使用してグローバルにインストールできます。

• 実行：対話モードの場合はmicro-agentを使用してコマンドラインから実行するか、単体テストまたはビジュアルマッチングの場合は特定のフラグとともに実行します。

• APIキー設定：選択したLLMプロバイダー（例：OpenAI、Anthropic）のAPIキーをmicro-agent config setコマンドを使用して設定する必要があります。

Micro Agentとは？

Micro Agentは、BuilderIOが開発したオープンソースのAIエージェントで、コードの記述と修正を自動で行います。テストケースを生成し、すべてのテストケースが合格するまでコードを繰り返し修正するように設計されており、機能するコードを得るプロセスをより効率的にします。

Micro Agentは他のAIコーディングエージェントとどう違いますか？

Micro Agentは「マイクロ」エージェントであり、小型で、特定のタスクに集中し、テストを記述し、そのテストに合格するコードを生成することに特化しています。複合的なエラーで「暴走」することがある汎用コーディングエージェントとは異なり、Micro Agentは特定の反復プロセスに焦点を当てることで信頼性を目指しています。エンドツーエンドの開発者になろうとしたり、モジュールをインストールしたり、複数のファイルを管理したりすることはありません。

Micro Agentの主な機能は何ですか？

Micro Agentは以下の機能を提供します。

• テスト駆動開発

  テストを生成し、テストに合格するまでコードを繰り返し修正します。

• 対話モード

  質問を投げかけ、ユーザーのフィードバックを利用して生成されたコードを改善する対話型の体験を提供します。

• LLM APIキーのサポート

  Claude、OpenAI、Ollama、または任意のOpenAI互換プロバイダーを含む様々なLLMで動作します。

• 単体テストのマッチング

  ファイルで実行し、指定されたテストスクリプトが合格するまでコードを繰り返し修正できます。

• 視覚的マッチング（実験的）

  レンダリングされた出力をスクリーンショットと比較することで、デザインに一致するコードを生成できます（Anthropic APIキーが必要です）。

• Figma連携

  Visual Copilotと統合し、コンポーネントやデザイン・トークンを再利用して、忠実度の高いデザインからコードへの変換を実現します。

• 設定可能

  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リポジトリでIssueを開くか、Twitterで@steve8708に連絡してください。