Mastra基于TypeScript 技术栈的AI开发框架

Mastra 是一个面向现代 TypeScript 技术栈的全栈 AI 应用与智能体(Agent)开发框架。它旨在帮助开发者快速构建、部署和优化由大语言模型(LLM)驱动的生产级应用。


1. 核心核心特性 (Core Features)

  • 模型路由 (Model Routing): 通过统一的标准接口,Mastra 允许你轻松连接超过 40 家主流的 LLM 供应商(如 OpenAI、Anthropic、Google Gemini、DeepSeek 等)。你可以自由切换模型或提供商,支持流式传输和动态选择。
  • 智能体系统 (Agents): 可以构建具备自主能力的 Agent。这些 Agent 能够根据设定的目标进行推理、自主选择并调用工具(Tools),并内部迭代直到生成最终答案。
  • 基于图的工作流引擎 (Workflows): 当需要对 AI 的执行流程进行精细控制时,Mastra 提供了基于图形的流式引擎。它支持直观的语法,可以轻松管理复杂的多步骤流程(例如通过 .then(), .branch(), .parallel() 实现控制流)。
  • 上下文与记忆管理 (Context & Memory): Mastra 提供了长期对话历史记录和“观察记忆(Observational Memory)”,能让 Agent 像人类一样拥有长短期记忆,并可以高效提取外部 API、数据库和文件(RAG,检索增强生成)中的数据。
  • 全栈生态与无缝集成 (Integrations): Mastra 可以直接嵌入到现有的现代 TypeScript 框架中(如 Next.js、React、Astro、Hono、Node.js、Express 等),也可以作为独立的后端服务独立部署。此外,它还与 Vercel 的 AI SDK UI 和 CopilotKit 等前端 Agent 库良好兼容。
  • 支持 MCP 协议 (Model Context Protocol): Mastra 支持快速编写 MCP 服务器,将 Agent、工具和结构化资源通过 MCP 接口暴露,以便其他支持该协议的系统(如 Cursor 等 AI 编辑器)直接调用。
  • 生产级观测与评估 (Observability & Evals): 自带完整的可观测性工具,包含自动化评估(Evals)、指标追踪(Metrics)、数据集管理(Datasets)以及执行追踪(Traces),让你能清楚看到 Agent 在每一步做了什么并持续优化。

2. 常见应用场景 (What you can build)

使用 Mastra,开发者通常用来构建以下应用:

  • 嵌入式 AI 副驾驶 (Copilots): 为现有 SaaS 软件或平台提供领域特定的 AI 助手(如编码、财务、法律、文档研究等)。
  • 复杂工作流自动化 (Workflow Automation): 多步骤的自动化数据路由与处理。例如,模板中包含的“GitHub PR 自动代码审查助手”,能自动读取代码库、拉取 PR 并生成详细的审查报告。
  • 客户服务与交互助手: 能够处理预约、发送通知并支持多渠道(网页、WhatsApp、语音)的客服 Agent。
  • 自然语言数据分析: 允许用户用大白话查询数据库、CSV 或仪表盘,自动分析并生成图表或报告。

3. 如何快速开始 (Quickstart)

Mastra 提供了非常开箱即用的脚手架工具。在你的终端中运行以下命令即可快速创建一个 Mastra 项目:

1
npx create-mastra@latest

创建后,运行以下命令启动本地的 Mastra 游乐场(Playground)和开发服务器:

1
mastra dev

通过内置的可视化 Playground,你可以直观地调试和测试你的 Agent、工作流和工具集。