Mastra

Mastra 是一个用于构建 AI 驱动型应用和 Agent 的框架，采用现代 TypeScript 技术栈。

它包含了你从早期原型到生产级应用所需的一切。Mastra 可以与 React、Next.js 和 Node.js 等前端和后端框架集成，或者作为独立服务器部署在任何地方。它是构建、调优和扩展可靠 AI 产品的最简单方式。

为什么选择 Mastra？

Mastra 专为 TypeScript 构建，并围绕成熟的 AI 模式进行设计，为你开箱即用地提供构建出色 AI 应用所需的一切。

主要亮点包括：

• 模型路由 (Model routing) - 通过一个标准接口连接 40 多家模型供应商，包括 OpenAI、Anthropic、Gemini 等。

• Agent - 构建自主 Agent，利用 LLM 和工具解决开放式任务。Agent 会针对目标进行推理、决定使用哪些工具，并在内部迭代，直到模型得出最终答案或满足可选的停止条件。

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

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

• 上下文管理 - 在正确的时间为你的 Agent 提供正确的上下文。包括 对话历史 (conversation history)、从数据源 检索 (retrieve) 信息（API、数据库、文件），并添加类似人类的 工作记忆 (working memory) 和 语义记忆 (semantic recall)，让你的 Agent 表现得更加连贯。

• 集成 - 将 Agent 和工作流打包到现有的 React、Next.js 或 Node.js 应用中，或者作为独立的 API 端点发布。在构建 UI 时，可以与 Vercel 的 AI SDK UI 和 CopilotKit 等 Agentic 库集成，让你的 AI 助手在网页上栩栩如生。

• MCP 服务器 - 开发 Model Context Protocol 服务器，通过 MCP 接口暴露 Agent、工具和其他结构化资源。任何支持该协议的系统或 Agent 都可以访问这些资源。

• 生产环境必备 - 交付可靠的 Agent 需要持续的洞察、评估和迭代。通过内置的 评估 (evals) 和 可观测性 (observability)，Mastra 为你提供了持续观察、衡量和完善产品的工具。

快速开始

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

npm create mastra@latest

请参阅 安装指南 (Installation guide)，获取使用 CLI 或手动安装的详细步骤。

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

文档

访问我们的 官方文档 (official documentation)。

使用 AI 进行构建

学习如何通过 使用 AI 构建指南 (Build with AI guide) 让你的 Agent 成为 Mastra 专家。

贡献

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

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