Micro Agent

一个为你编写并修复代码的 AI 智能体。

Demo

只需运行 micro-agent，输入提示词（prompt），它就会生成测试用例，并反复迭代代码直到所有测试用例通过。

为什么选择 Micro Agent？

LLM 非常擅长给你提供有问题的代码，而通常需要反复迭代才能使这些代码按预期工作。

既然 AI 不仅可以处理代码生成，还能处理迭代和修复，为什么要手动去做呢？

为什么叫“微型（Micro）”智能体？

AI 智能体听起来很酷，但通用的编程智能体往往达不到预期。它们容易陷入复合错误中而失控。想象一下你的扫地机器人卡在桌子底下的场景，放大 1000 倍。

微型智能体的理念是：

创建一个明确的测试用例，提供清晰的反馈，判断代码是否按预期工作；
反复迭代代码直到所有测试用例通过。

阅读更多关于为什么存在 Micro Agent 的文章。

此项目不是什么

本项目并不试图成为一个端到端的开发者。AI 智能体目前（甚至在可预见的未来）还没有能力可靠地胜任这项工作。本项目不会安装模块、读写多个文件，也不会执行任何在失败时极有可能造成灾难性后果的操作。

它只是一个微型智能体。它体量小、目标专注，并尽可能把一件事做好：编写一个测试，然后生成通过该测试的代码。

安装

Micro Agent 需要 Node.js v18 或更高版本。

npm install -g @builder.io/micro-agent

开始使用

开始使用的最好方法是在交互模式下运行 Micro Agent，它会询问有关生成代码的问题，并利用你的反馈来改进所生成的代码。

micro-agent

看，你现在已经是一名测试驱动的开发者了。不客气。

手动运行

添加 LLM API Key

Micro Agent 支持 Claude、OpenAI、Ollama 或任何与 OpenAI 兼容的提供商（如 Groq）。你需要将 API Key 添加到 CLI 中：

micro-agent config set OPENAI_KEY=
micro-agent config set MODEL=gpt-4o

或者使用 Claude：

micro-agent config set ANTHROPIC_KEY=
micro-agent config set MODEL=claude

要使用自定义的 OpenAI API 端点（例如用于 Ollama 或 Groq），你可以通过以下方式设置端点：

micro-agent config set OPENAI_API_ENDPOINT=
micro-agent config set OPENAI_API_ENDPOINT=https://api.groq.com/openai/v1

单元测试匹配

Demo

要在单元测试匹配模式下针对某个文件运行 Micro Agent，你需要提供一个在每次代码生成尝试后运行的测试脚本。例如：

micro-agent ./file-to-edit.ts -t "npm test"

这将在 ./file-to-edit.ts 文件上运行 Micro Agent，执行 npm test，并持续编写代码直到测试通过。

上述命令假设文件结构如下：

some-folder
├──file-to-edit.ts
├──file-to-edit.test.ts # 测试文件。如果路径不同，请使用 -f 参数
└──file-to-edit.prompt.md # 可选的提示文件。如果路径不同，请使用 -p 参数

默认情况下，Micro Agent 假设你有一个与编辑文件同名但后缀为 .test.ts 的测试文件（例如上述示例中的 ./file-to-edit.test.ts）。

如果不是这种情况，你可以使用 -f 标志指定测试文件。你还可以添加一个提示文件来指导代码生成，该文件可以位于 .prompt.md（如 ./file-to-edit.prompt.md），或者通过 -p 指定。例如：

micro-agent ./file-to-edit.ts -t "npm test" -f ./file-to-edit.spec.ts -p ./path-to-prompt.prompt.md

视觉匹配（实验性）

Visual Demo

[!WARNING] 该功能处于实验阶段，正在积极开发中。请谨慎使用。

Micro Agent 还可以帮助你匹配设计稿。为此，你需要提供一个设计稿和本地渲染代码的 URL。例如：

micro-agent ./app/about/page.tsx --visual localhost:3000/about

Micro Agent 将生成代码，直到代码的渲染输出与你放置在编辑文件旁边的截图文件（在本例中为 ./app/about/page.png）更加匹配。