Better Agents

为智能体项目生成可测试、可评估、可观测且可协作维护的开发结构。

Star 数
★ 1.6k
最近更新
6 个月前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台Claude Code
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.js 22+npm 或 pnpm受支持的编码助手LangWatch API 密钥LLM 提供商 API 密钥Shell / 命令行网络访问本地文件系统MCP Server
典型场景
使用 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 测试相关的上下文。

  1. 使用 Claude Code 开始 Agno 项目的开发者,希望第一次提交前就建立 Scenario 端到端测试目录和提示词版本管理。
  2. 采用 Mastra 的团队,需要让多个成员通过 YAML 提示词和 prompts.json 协作维护提示词。
  3. 构建含 RAG 或分类环节的 LangGraph 项目,并希望在 tests/evaluations/ 中保存评估数据与 Notebook 的工程团队。
  4. 需要为新智能体项目预置 .mcp.json、可观测性相关配置和开发约定的技术负责人。
  5. 已使用 Cursor、Antigravity 或 Kilocode CLI 的开发者,希望把现有编码助手接入统一的智能体项目结构。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @langwatch/better-agents
  • npx @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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
44/ 100 五分制 2.2 / 5
信任安全 10/29
可靠稳定 5/14
适用触发 9/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

CLI 将 API 密钥限定为环境变量,并提供匿名遥测退出开关,降低了在参数中暴露密钥的风险;但遥测默认开启,且样本未说明事件字段和数据保留方式,因此最小权限、数据流透明度和外部影响仅部分体现。初始化会自动启动所选编码助手,确认步骤及撤销生成文件或外部操作的方法未见说明。MIT 许可清楚,作者字段指向 LangWatch,但发布者身份未验证,不能据此确认维护者归属。

可靠稳定5 / 14 · 1.8/5

仓库有类型检查、构建、lint、单元及端到端测试的 CI 配置;这只能证明存在验证流程,不能证明执行结果。文档对 Node 版本要求不一致(README 写 22+,快速入门写 18+,package.json 为 >=18),且支持的助手和框架列表也有差异。失败处理示例有限,初始化及遥测错误行为未充分说明。

适用触发9 / 18 · 2.5/5

文档面向使用编码助手搭建 Python 或 TypeScript Agent 的开发者,并给出多种框架、模型提供商和初始化方式。命令行选项能约束语言、框架和目标,但产品能力边界、支持组合及环境兼容细节不完整;自动启动助手也让工作流适配程度有限。

规范维护10 / 18 · 2.8/5

README、快速入门、使用说明、许可证和变更日志入口形成了清晰的信息结构,并提供安装命令及实际示例。MIT 许可文本完整,版本号可见;但文档存在版本要求与功能列表差异,已知限制和明确维护责任未充分说明。贡献指南链接存在,但其内容未提供。

有效结果7 / 13 · 2.7/5

产品提供项目骨架、Agent 测试与评估结构、提示词管理和助手上下文设置,能为新项目提供可直接使用的起点。其价值主要由文档中的功能描述支持,样本没有展示生成结果细节或成本数据;默认遥测和 API 密钥等配置带来额外设置负担。

证据核验3 / 8 · 1.9/5

安装、选项和环境变量等操作性主张有 CLI 代码及文档部分对应;但“生产就绪”和“确保符合最佳实践”等较强宣传主张缺少样本内结果证据。README 与快速入门、package.json 在 Node 版本及支持列表上互有差异;审查基于静态样本,无法核实行为或测试结果。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • Node.js 要求和部分助手、框架支持列表在 README、快速入门、使用说明及 package.json 之间不一致;使用前应以实际 CLI 选项为准。
  • 遥测默认开启;文档仅提供退出变量,没有在样本中说明收集字段、传输目的地细节或保留政策。
  • 初始化完成后会自动启动所选编码助手;样本未说明生成文件的覆盖确认或恢复流程。
证据充分度:低 评估于 2026年11月8日 审查版本 00c44b92fafc
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/better-agents.svg?lang=zh)](https://followagents.com/zh/agents/better-agents)
<a href="https://followagents.com/zh/agents/better-agents"><img src="https://followagents.com/badge/better-agents.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.1.23
    发布说明摘录
    [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 查看 ↗
  2. v0.1.21
    发布说明摘录
    [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 查看 ↗
  3. v0.1.20
    发布说明摘录
    [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 查看 ↗

常见问题

它会直接部署或运行我的智能体吗?
不会。它的已说明作用是通过 CLI 初始化项目结构、配置和开发约定;实际智能体代码位于 app/ 或 src/。
需要哪些密钥?
需要 LangWatch API key,以及所选 LLM 提供商的 API key。
如何关闭遥测?
设置环境变量 BETTER_AGENTS_TELEMETRY=0;匿名使用遥测默认开启。
它支持哪些编码助手?
明确列出 Claude Code、Cursor、Antigravity 和 Kilocode CLI。
Better Agents 免费吗?
软件本身免费,但 Better Agents 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Better Agents 开源吗?
开源。源码在 GitHub(langwatch/better-agents),许可证是 MIT。
Better Agents 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Better Agents 的“信任与安全”打了 10/29 分。评审没有在源码和文档里找到这些安全措施:回滚或恢复路径。接入真实账号或数据前:运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
Better Agents 还在维护吗?
GitHub 仓库自 2026-05-11 以来没有新提交,已超过半年。可能是项目已经完成,也可能已经停更,用之前建议先看看 issue 区。最新版本是 v0.1.23(2026-02-22)。
Better Agents 是谁开发的?
Better Agents 由 GitHub 账号 langwatch 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念