Better Agents

Better Agents 是一个命令行工具（CLI），旨在为开发者提供一套开箱即用、符合业界工程规范的 Agent 项目初始化方案。它不构建新的 Agent 框架，而是为现有主流框架（如 Agno、Mastra、LlamaIndex、LangGraph 等）生成结构完整、可维护、可评估的项目模板。

其核心目标是：让开发者从第一行代码起，就走在生产就绪的路径上。

核心能力：一键生成“生产级标配”项目

运行 better-agents init 后，项目将自动包含以下关键组件：

1. 场景化测试（Scenario-Based Testing）

• 为每个核心功能预置真实对话模拟用例（如“用户问天气 → 调用工具 → 返回结构化结果”）；
• 确保 Agent 行为可预期、可验证，避免“本地能跑，上线崩坏”。

2. 提示词工程标准化

• 所有 Prompt 以 YAML 文件格式存储，结构清晰；
• 通过 prompts.json 统一索引，支持：
  • 团队协作编辑
  • 版本回滚
  • 集成 Playground 一键试用与调试

3. 内置评估体系

• evaluations/ 目录包含：
  • 针对 RAG、工具调用、意图分类等关键模块的测试数据集；
  • Jupyter Notebook 模板，用于量化评估准确率、延迟、幻觉率等指标；
• 使“评估即开发”成为默认工作流。

4. 全链路可观测性

• 预集成日志记录、追踪（tracing）与指标采集（metrics）；
• 兼容 OpenTelemetry 等标准，便于接入 Grafana、LangSmith 等监控平台。

5. 标准化项目结构

• 采用清晰的目录分层（如 agents/, tools/, tests/, configs/）；
• 无论团队规模或项目数量，新成员均可快速理解架构并上手开发。

6. MCP 工具预配置

• 自动生成 .mcp.json 文件，列出当前框架下推荐的 Model Context Protocol（MCP）；
• 使 Cursor、Windsurf、Claude Code 等代码助手能直接调用正确工具，无需手动查阅文档。

与现有开发方式的对比

适用人群

• Agent 应用开发者：希望快速启动可维护、可评估的项目；
• 技术负责人：需要统一团队 Agent 项目结构与开发规范；
• 开源贡献者：为新框架提供高质量参考实现；
• 代码助手用户（如 Cursor、Windsurf）：通过 .mcp.json 让 AI 助手更懂你的技术栈。