Mastra

Mastra 是一个基于现代 TypeScript 技术栈构建 AI 应用和智能体的框架，由 Gatsby 团队打造。

Mastra 提供了从早期原型开发到生产级应用所需的一切工具。它能与 React、Next.js 和 Node 等前端及后端框架无缝集成，也可以作为独立服务器部署在任何地方。这是构建、调优和扩展可靠 AI 产品的最简途径。

为什么选择 Mastra？

Mastra 专为 TypeScript 构建，围绕成熟的 AI 模式设计，开箱即用地提供了构建优秀 AI 应用所需的一切。

主要亮点包括：

• 模型路由 (Model routing) - 通过统一的标准接口连接 40 多种模型提供商。你可以使用 OpenAI、Anthropic、Gemini 等各类模型。

• 智能体 (Agents) - 构建能够使用 LLM 和工具解决开放式任务的自主智能体。智能体会根据目标进行推理、决定使用哪些工具，并进行内部迭代，直到模型输出最终答案或满足预设的停止条件。

• 工作流 (Workflows) - 当你需要精确控制执行过程时，可以使用 Mastra 的基于图 (graph-based) 的工作流引擎来编排复杂的多步流程。Mastra 工作流使用直观的语法进行流程控制（如 .then()、.branch()、.parallel()）。

• 人机协作 (Human-in-the-loop) - 挂起智能体或工作流，等待用户输入或批准后再恢复执行。Mastra 利用 storage 记录执行状态，因此你可以无限期暂停并在中断处继续执行。

• 上下文管理 - 在正确的时间为智能体提供正确的上下文。支持 对话历史、从你的数据源（API、数据库、文件）中进行 检索，并添加类似人类的 工作记忆 和 语义记忆，让你的智能体表现得更加连贯。

• 集成 (Integrations) - 将智能体和工作流整合到现有的 React、Next.js 或 Node.js 应用中，或者作为独立的端点发布。在构建 UI 时，可以与 Vercel 的 AI SDK UI 和 CopilotKit 等智能体库集成，让你的 Web 端 AI 助手栩栩如生。

• MCP 服务器 - 构建模型上下文协议 (Model Context Protocol) 服务器，通过 MCP 接口暴露智能体、工具和其他结构化资源。任何支持该协议的系统或智能体均可访问这些资源。

• 生产环境必备 - 构建可靠的智能体需要持续的洞察、评估和迭代。通过内置的 评估 (evals) 和 可观测性 (observability)，Mastra 为你提供了持续观察、衡量和改进的工具。

快速开始

开始使用 Mastra 的推荐方式是运行以下命令：

npm create mastra@latest

请按照 安装指南 进行操作，了解如何通过 CLI 进行设置或手动安装。

如果你是 AI 智能体开发的新手，可以查看我们的 模板 (templates)、课程 (course) 和 YouTube 视频，立即开始使用 Mastra 进行构建。

文档

请访问我们的 官方文档。

用 AI 构建

通过阅读 “用 AI 构建”指南 (Build with AI guide)，了解如何让你的智能体成为 Mastra 专家。

贡献

想要参与贡献？我们欢迎各种形式的帮助，无论是代码编写、测试还是功能规范建议。请阅读 CONTRIBUTING.md 以了解如何参与。

如果你是开发者并希望贡献代码，请在提交 Pull Request 之前先开启一个 Issue 进行讨论。

项目设置相关信息