Framework mastra 面向生产级的 TypeScript AI 应用框架

用 TypeScript 做 AI 应用，从原型到生产之间隔着模型接入、工具调用、工作流编排、评估与部署一堆工程问题。东拼西凑不同库，往往走不到稳定上线。
Mastra 是现代 TypeScript 栈的 AI 应用与智能体框架，提供模型路由、Agent、工作流、人在回路、上下文管理等完整能力，并可与 React、Next.js、Node 集成，也能作为独立服务部署。

项目基本信息

一、项目介绍

mastra（Mastra is the modern TypeScript framework for AI-powered applications and agents.），面向生产级的 TypeScript AI 应用框架。它把相关能力封装成开箱即用的形态，让开发者无需从零搭建即可直接落地，下文从优势、场景到安装使用逐一展开。

二、核心优势

• 统一接口接入 40+ 模型提供商（OpenAI/Anthropic/Gemini 等）
• 内置 Agent 与工作流引擎，支持 .then/.branch/.parallel 编排
• 支持人类在回路（暂停/恢复）与多种记忆/检索
• 可对接前端框架，也能独立部署为服务

三、适用场景

• 用 TypeScript 构建生产级 AI 产品
• 需要 Agent + 工作流 + 评估一体化方案
• 想在 Next.js/Node 中落地 AI 功能的团队

四、安装教程

推荐用官方脚手架快速创建：

npm create mastra@latest

或单独安装核心包：

npm install @mastra/core

常见报错：npm create mastra 卡在交互提示。可在 CI 或脚本中用非交互参数，或确保 Node 版本满足要求后重试。

五、使用示例

定义一个 Agent 并用工作流编排：

import { Agent } from '@mastra/core';
const agent = new Agent({
  name: 'assistant',
  model: 'openai/gpt-4o',
  instructions: '你是一个简洁的助手',
});
const { text } = await agent.generate('用一句话解释工作流。');

输入：声明 Agent 并调用 generate。
输出：返回模型生成的文本；后续可把多个 Agent 用 .then() 串成工作流，并接入评估与记忆。

六、常见问题

问：Mastra 和 LangChain 的 JS 版怎么选？

答：Mastra 更偏 TypeScript 一体式体验与生产特性（eval、deploy），适合纯 TS 栈团队。

问：必须上云吗？

答：不必，可本地开发，也能作为独立服务部署到自有环境。

七、总结

Mastra 是 TypeScript 团队做生产级 AI 应用的一站式框架，模型、Agent、工作流与评估齐备，落地效率高。