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 密鑰配置：支援與各種 LLM 整合，包括 Claude、OpenAI、Ollama 或任何與 OpenAI 相容的供應商。使用者可以通過 micro-agent config set 命令或環境變數配置 API 密鑰並選擇模型（例如 gpt-4o、claude）。

• 自訂 OpenAI API 端點：允許設定自訂端點以用於本地 LLM（如 Ollama）或其他供應商（如 Groq）。

• 與 Figma 整合（通過 Visual Copilot）：可以與 Visual Copilot 整合以直接連接到 Figma，從而實現高保真從設計到程式碼的轉換、精確的設計標記映射和元件重用。Micro Agent 隨後優化輸出以確保其通過測試並符合設計。

• 配置選項：

  • --max-runs (-m)：設定程式碼生成和測試的最大嘗試次數。
  • config 命令：提供用於設定 API 密鑰、模型和其他配置的 CLI，包括互動式 UI。
  • 環境變數：所有配置選項都可以通過環境變數覆蓋。

• 更新機制：包括一個命令 (micro-agent update) 以便輕鬆升級到最新版本。

使用者效益

• 提高生產力：自動化程式碼校正的迭代過程，為開發人員節省大量時間和精力。

• 更高的程式碼品質：確保生成的程式碼符合指定的測試標準，從而產生更健壯和可靠的應用程式。

• 減少手動偵錯：通過自動迭代直到測試通過，最大限度地減少手動偵錯 AI 生成程式碼的需求。

• 專注的 AI 應用：作為一個「微型」代理程式，它避免了過於雄心勃勃的 AI 代理程式的常見缺陷，為其特定任務提供可靠的結果。

• 靈活性：支援各種 LLM 並提供廣泛的配置選項以適應不同的開發環境和偏好。

• 測試驅動開發 (TDD) 促進：自然地整合並增強 TDD 工作流程。

相容性和整合

• Node.js：需要 Node.js v18 或更高版本。

• LLMs：與 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 開發的開源人工智慧代理程式，用於為您編寫和修復程式碼。它旨在生成測試案例，然後在程式碼上迭代，直到所有測試案例通過，從而更有效率地獲得功能程式碼。

Micro Agent 與其他人工智慧程式碼代理程式有何不同？

Micro Agent 是一個「微型」代理程式，這表示它體積小、專注，並專精於一個任務：編寫測試，然後產生通過該測試的程式碼。與有時會因複合錯誤而「失控」的通用程式碼代理程式不同，Micro Agent 旨在透過專注於特定的疊代過程來實現可靠性。它不試圖成為一個端到端的開發人員、安裝模組或管理多個檔案。

Micro Agent 的主要特點是什麼？

Micro Agent 提供：

• 測試驅動開發

  它會生成一個測試，然後在程式碼上迭代，直到測試通過。

• 互動模式

  提供互動式體驗，它會提出問題並利用您的回饋來改進生成的程式碼。

• LLM API 金鑰支援

  支援各種 LLM，包括 Claude、OpenAI、Ollama 或任何與 OpenAI 相容的供應商。

• 單元測試匹配

  可以在檔案上運行並迭代程式碼，直到指定的測試腳本通過。

• 視覺匹配（實驗性）

  可以生成程式碼以透過比較渲染輸出與螢幕截圖來匹配設計（需要 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 儲存庫上建立議題或透過 Twitter 聯絡 @steve8708。