Better Agents
为智能体项目生成可测试、可评估、可观测且可协作维护的开发结构。
- Star 数
- ★ 1.6k
- 最近更新
- 6 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 开始 Agno 项目的开发者,希望第一次提交前就建立 Scenario 端到端测试目录和提示词版本管理。
- 不适合
- 需要开箱即用运行时的团队:它只生成项目骨架
- 不想依赖 LangWatch 云服务的团队
- 不使用 Claude Code、Cursor、Antigravity 或 Kilocode 的开发者
- 维护状态
- 超过半年没有提交最近提交 2026-05-11最新版本 v0.1.23(2026-02-22)
这个 Agent 能做什么,适合哪些场景?
Better Agents 是一个命令行工具和一套智能体开发标准,用于初始化新的智能体项目。它面向 Agno、Mastra、LangGraph 等可选框架,并可配合 Claude Code、Cursor、Antigravity 或 Kilocode CLI 等编码助手使用。初始化后,项目结构包含应用代码目录、端到端 Scenario 测试、评估 Notebook、版本化提示词、提示词注册表、MCP 配置和 AGENTS.md。其交付边界是生成和规范化本地项目骨架,而不是作为托管运行时执行智能体。它适合希望从项目起步阶段就纳入测试、提示词协作、评估和可观测性约定的团队。
运行 better-agents init . 或 better-agents init my-awesome-agent 后,CLI 会引导选择编程语言、智能体框架、编码助手、LLM 提供商和 API 密钥。它生成 app/(或 src/)、tests/scenarios/、tests/evaluations/、prompts/、prompts.json、.mcp.json、AGENTS.md、.env 与 .gitignore 等项目文件。tests/scenarios/ 用于 Scenario 端到端会话测试,tests/evaluations/ 放置用于评估 RAG 或分类等流水线环节的数据集和 Notebook,prompts/ 以 YAML 保存版本化提示词。.mcp.json 用于配置 MCP 服务器,使所选编码助手能够获得所选框架和 Scenario 测试相关的上下文。
- 使用 Claude Code 开始 Agno 项目的开发者,希望第一次提交前就建立 Scenario 端到端测试目录和提示词版本管理。
- 采用 Mastra 的团队,需要让多个成员通过 YAML 提示词和
prompts.json协作维护提示词。 - 构建含 RAG 或分类环节的 LangGraph 项目,并希望在
tests/evaluations/中保存评估数据与 Notebook 的工程团队。 - 需要为新智能体项目预置
.mcp.json、可观测性相关配置和开发约定的技术负责人。 - 已使用 Cursor、Antigravity 或 Kilocode CLI 的开发者,希望把现有编码助手接入统一的智能体项目结构。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @langwatch/better-agentsnpx @langwatch/better-agents init my-agent-project
- 运行环境
- Node.js 22+
如何安装或部署这个 Agent?
要求 Node.js 22+、npm 或 pnpm、一个受支持的编码助手、LangWatch API key 和所选 LLM 提供商的 API key。全局安装:npm install -g @langwatch/better-agents。也可免安装运行:npx @langwatch/better-agents init my-agent-project。
如何使用这个 Agent?
在当前目录初始化:better-agents init .;创建新目录并初始化:better-agents init my-awesome-agent。随后按 CLI 引导选择语言、框架、编码助手、LLM 提供商并提供所需 API key。默认启用匿名使用遥测;如需退出,设置 BETTER_AGENTS_TELEMETRY=0。
这个 Agent 有哪些优点和局限?
- 一次初始化同时建立 Scenario 端到端测试、评估 Notebook、提示词版本化和提示词注册表,而不只生成应用代码目录。
- 通过
.mcp.json将所选智能体框架与 Scenario 测试相关 MCP 配置纳入新项目。 - 可在初始化流程中选择语言、智能体框架、编码助手和 LLM 提供商,面向多种开发组合。
- 项目结构明确区分
tests/scenarios/、tests/evaluations/和prompts/,便于将行为测试、离线评估与提示词协作分开维护。
- 运行环境要求 Node.js 22+,并依赖 npm 或 pnpm。
- 需要 LangWatch API key 及所选 LLM 提供商的 API key,采用前需处理凭据配置。
- 文档列出的编码助手范围有限:Claude Code、Cursor、Antigravity 和 Kilocode CLI。
- 它生成项目标准和配置,而非提供已部署的智能体运行服务;实际框架实现仍需由项目自行完成。
这个 Agent 与同类方案有什么区别?
它与 Agno、Mastra、LangGraph 等智能体框架是互补关系:这些框架承载实际智能体代码,而 Better Agents 用于初始化围绕测试、评估、提示词和 MCP 配置的项目结构。它也配合 Claude Code、Cursor、Antigravity 和 Kilocode CLI 等编码助手使用,而非替代这些助手。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Better Agents 当前 | 44 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.6k | 6 个月前 | TypeScript | Claude Code |
| RocketRide | 84 · 表现良好 | — | ★ 20k | 今天 | Python | — |
| Hypha 智能体框架 | 55 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 452 | 5 天前 | TypeScript | OpenAI API |
| Rulesync | 71 · 存在缺口 | 命令行工具免费 | ★ 1.6k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
CLI 将 API 密钥限定为环境变量,并提供匿名遥测退出开关,降低了在参数中暴露密钥的风险;但遥测默认开启,且样本未说明事件字段和数据保留方式,因此最小权限、数据流透明度和外部影响仅部分体现。初始化会自动启动所选编码助手,确认步骤及撤销生成文件或外部操作的方法未见说明。MIT 许可清楚,作者字段指向 LangWatch,但发布者身份未验证,不能据此确认维护者归属。
仓库有类型检查、构建、lint、单元及端到端测试的 CI 配置;这只能证明存在验证流程,不能证明执行结果。文档对 Node 版本要求不一致(README 写 22+,快速入门写 18+,package.json 为 >=18),且支持的助手和框架列表也有差异。失败处理示例有限,初始化及遥测错误行为未充分说明。
文档面向使用编码助手搭建 Python 或 TypeScript Agent 的开发者,并给出多种框架、模型提供商和初始化方式。命令行选项能约束语言、框架和目标,但产品能力边界、支持组合及环境兼容细节不完整;自动启动助手也让工作流适配程度有限。
README、快速入门、使用说明、许可证和变更日志入口形成了清晰的信息结构,并提供安装命令及实际示例。MIT 许可文本完整,版本号可见;但文档存在版本要求与功能列表差异,已知限制和明确维护责任未充分说明。贡献指南链接存在,但其内容未提供。
产品提供项目骨架、Agent 测试与评估结构、提示词管理和助手上下文设置,能为新项目提供可直接使用的起点。其价值主要由文档中的功能描述支持,样本没有展示生成结果细节或成本数据;默认遥测和 API 密钥等配置带来额外设置负担。
安装、选项和环境变量等操作性主张有 CLI 代码及文档部分对应;但“生产就绪”和“确保符合最佳实践”等较强宣传主张缺少样本内结果证据。README 与快速入门、package.json 在 Node 版本及支持列表上互有差异;审查基于静态样本,无法核实行为或测试结果。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- Node.js 要求和部分助手、框架支持列表在 README、快速入门、使用说明及 package.json 之间不一致;使用前应以实际 CLI 选项为准。
- 遥测默认开启;文档仅提供退出变量,没有在样本中说明收集字段、传输目的地细节或保留政策。
- 初始化完成后会自动启动所选编码助手;样本未说明生成文件的覆盖确认或恢复流程。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
[0.1.23](https://github.com/langwatch/better-agents/compare/v0.1.22...v0.1.23) (2026-02-22) Features * pass LANGWATCH_API_KEY to MCP server config ([#84](https://github.com/langwatch/better-agents/issues/84)) ([8ab576e](https://github.com/langwatch/better-agents/commit/8ab576ecc12eca6d1da3526983f04212d857ca6a))在 GitHub 查看 ↗ -
发布说明摘录
[0.1.20](https://github.com/langwatch/better-agents/compare/v0.1.20...v0.1.20) (2025-12-11) Features * add non-interactive mode with CLI options ([#77](https://github.com/langwatch/better-agents/issues/77)) ([0ff5bd1](https://github.com/langwatch/better-agents/commit/0ff5bd1c74782ba6b808ac415906e666cf368552)) Miscellaneous * release v0.1.20 ([c799e6c](https://github.com/langwatch/better-agents/commit/c799e6cfc81120bf1f43848b44d272587967a7be))在 GitHub 查看 ↗ -
发布说明摘录
[0.1.20](https://github.com/langwatch/better-agents/compare/v0.1.19...v0.1.20) (2025-12-09) Features * cursor-agent(mac) ([#59](https://github.com/langwatch/better-agents/issues/59)) ([75f51f7](https://github.com/langwatch/better-agents/commit/75f51f760346e35758348cafec4d6aac0a04f7da)) * vercel-ai ([#70](https://github.com/langwatch/better-agents/issues/70)) ([8aa9b11](https://github.com/langwatch/better-agents/commit/8aa9b11b98f8c16b6cfa2a2a61aa54793a4d9b09)) …在 GitHub 查看 ↗
常见问题
它会直接部署或运行我的智能体吗?
app/ 或 src/。需要哪些密钥?
如何关闭遥测?
BETTER_AGENTS_TELEMETRY=0;匿名使用遥测默认开启。它支持哪些编码助手?
Better Agents 免费吗?
Better Agents 开源吗?
Better Agents 安全吗?
Better Agents 还在维护吗?
Better Agents 是谁开发的?
谢谢反馈,我们会据此改进页面。