Mastra Studio Demo：一站式体验 Mastra 全功能特性的演示项目

Mastra Studio Demo 是一个功能完整的一站式演示项目，通过一条命令即可启动包含智能体、工具、工作流、评估、追踪和记忆功能的完整 Studio UI，是学习和评估 Mastra 框架的理想起点。

• 原作者/维护者：Pierre-Mike
• 来源平台：github
• 原始标题：mastra-studio-demo
• 原始链接：https://github.com/Pierre-Mike/mastra-studio-demo
• 来源发布时间/更新时间：2026-06-10T20:15:40Z

Mastra 是近期在 AI 智能体开发领域崭露头角的一个 TypeScript 框架。它定位为"构建 AI 应用的 TypeScript 框架"，提供了从智能体定义、工具集成到工作流编排的完整能力。与 Python 生态的 LangChain、LlamaIndex 相比，Mastra 让前端和全栈开发者能够用熟悉的 TypeScript/JavaScript 技术栈构建 AI 应用。

然而，学习一个新框架最好的方式是"看到它运行"。Mastra Studio Demo 正是为此而生——它是一个精心设计的演示项目，展示了 Mastra 的所有核心特性，让用户可以在几分钟内启动一个功能完整的 AI 应用并与之交互。

项目的最大卖点是"one command, full Studio UI"。只需运行：

npx mastra@latest init
# 或
npm run dev

即可启动一个包含以下功能的完整开发环境：

• 智能体交互界面：与预配置的智能体实时对话
• 工具调试面板：测试和调试自定义工具
• 工作流可视化：查看和触发工作流，监控执行过程
• 评估指标仪表板：查看智能体性能的量化评估
• 追踪与日志：详细的执行追踪和日志查看
• 记忆管理：查看和管理智能体的记忆状态

这种"开箱即用"的体验大大降低了 Mastra 的入门门槛。

演示项目包含多个预配置的智能体，展示不同的能力组合：

基础对话智能体：展示最基本的 LLM 调用、系统提示词配置和上下文管理。用户可以直接在界面中与智能体对话，观察其响应。

工具增强智能体：演示如何为智能体绑定自定义工具。例如，一个可以查询天气、搜索网页或执行计算的智能体。用户可以看到工具调用的详细过程，包括参数传递和结果返回。

多智能体协作：展示多个智能体如何协同工作。例如，一个智能体负责信息收集，另一个负责分析总结，第三个负责生成最终输出。

Mastra 的工具系统是其核心能力之一。演示项目包含丰富的工具示例：

内置工具：

• 网页搜索工具
• 文件读写工具
• HTTP 请求工具
• 数据库查询工具

自定义工具示例：

• 天气查询工具（展示 API 集成）
• 计算器工具（展示同步执行）
• 图像生成工具（展示异步处理和回调）
• 数据转换工具（展示复杂输入输出模式）

每个工具都有完整的类型定义和文档，展示了 Mastra 对 TypeScript 类型安全的重视。

工作流是 Mastra 的编排层，演示项目展示了多种工作流模式：

顺序工作流：最简单的线性流程，步骤按顺序执行，前一步的输出作为后一步的输入。

并行工作流：多个步骤同时执行，最后合并结果。适用于需要同时处理多个独立任务的场景。

条件工作流：根据中间结果动态选择执行路径。展示 if/else 逻辑和循环结构。

人机协作工作流：在工作流中插入人工审核点，展示如何在自动化流程中融入人工判断。

Mastra 内置了智能体评估框架，演示项目展示了如何量化智能体性能：

内置评估指标：

• 相关性评分：评估输出与用户查询的相关程度
• 准确性评分：评估事实性陈述的正确性
• 完整性评分：评估输出是否涵盖了所有必要信息
• 安全性评分：检测潜在的有害或不当内容

自定义评估器：演示如何编写特定领域的评估逻辑，如代码质量评估、风格一致性检查等。

评估结果以可视化方式呈现，包括分数分布、趋势图表和详细分析。