Mastra

Mastra是由Gatsby团队打造的面向TypeScript开发者的开源智能体框架，核心定位是通过统一API和工具链，帮助开发者快速构建、测试、部署具备记忆、工具调用、工作流编排等能力的AI应用。核心功能包括统一模型路由，支持一键切换多家大模型无需改动业务逻辑；内置完整RAG链路，可一站式实现文档向量化与检索；配套本地Playground支持实时调试，还能一键部署到多个Serverless平台。目标用户为TypeScript全栈开发者、AI应用开发人员、企业技术团队，可应用于企业知识问答机器人搭建、SaaS产品AI助理嵌入、多步骤业务流程自动化等多个场景。

主要功能

• 统一模型路由：开发者仅需编写一行代码，即可在OpenAI、Anthropic、Google、Ollama等不同大模型服务商之间切换，无需修改已编写的业务逻辑。该功能适配各厂商API差异，自动处理请求格式转换与异常重试，开发者无需单独适配不同模型的接口规范，可根据成本、效果需求灵活更换底层模型，降低模型切换的开发成本。
• 智能体记忆系统：支持长期记忆存储、语义召回、会话线程管理三类能力，开发者无需自行搭建记忆存储结构。系统会自动记录智能体与用户的历史交互内容，可根据当前对话语义自动召回相关历历年下文，同时支持多会话线程独立隔离，让智能体能够记住不同用户的历史交互信息，提升对话连贯性与用户体验。
• 工具与MCP调用：内置Zod运行时校验能力，开发者可快速封装REST接口、数据库、文件系统等外部能力为智能体可调用工具。只需按照规范编写函数逻辑与输入输出Schema，框架会自动完成参数校验、错误处理、调用日志记录，无需额外开发适配层，即可让智能体具备调用外部系统能力，扩展应用功能边界。
• 工作流引擎：基于XState的图状状态机构建，支持顺序、并行、分支、循环、暂停/恢复等复杂流程配置。开发者通过可视化配置或代码定义工作流节点，可将大模型调用、工具执行、人工审核等不同环节按业务逻辑串接，框架自动处理节点流转与状态持久化，适合搭建多步骤的自动化业务流程，降低复杂逻辑的开发难度。
• RAG完整链路：提供文档分块、向量化、存储、检索、重排一站式API，兼容Pinecone、pgvector等主流向量数据库。开发者上传文档后，框架自动完成文本预处理、向量化计算与存储，查询时自动执行检索与结果重排，无需自行对接不同向量库接口，也无需单独开发文档处理流程，可快速搭建基于私有知识库的检索增强应用。
• 可观测与评估：自动采集OpenTelemetry全链路追踪数据，内置毒性、幻觉、相关性等多个AI应用评估指标，同时支持自定义评分脚本。开发者可查看每一次大模型调用、工具执行的详细日志与耗时，也可通过内置或自定义指标对智能体的输出质量进行批量评估，及时发现应用异常与效果问题，便于迭代优化。

怎么使用

1. 第一步，安装框架CLI，在终端执行`npm create mastra@latest my-agent`命令，按照终端提示选择需要的组件与默认大模型服务商，完成项目初始化。第二步，配置服务密钥，在项目根目录的`.env`文件中写入`OPENAI_API_KEY`或其他大模型提供商的访问密钥，确保框架可以正常调用大模型服务。第三步，定义自定义工具，在`src/mastra/tools/`目录下，使用`createTool`函数编写工具逻辑与输入输出Schema，封装需要的外部系统调用能力。第四步，创建智能体实例，在`src/mastra/agents/`目录下，通过`new Agent`语法绑定指定模型、系统指令、已定义的工具与记忆配置，完成智能体核心逻辑搭建。第五步，注册实例入口，在`src/mastra/index.ts`文件中通过`new Mastra({ agents: { yourAgent } })`语句导出实例，完成核心代码编写。第六步，本地调试验证，执行`npm run dev`命令启动本地服务，打开`http://localhost:4111`进入Playground页面，与智能体对话测试功能是否符合预期。第七步，构建部署上线，执行`npm run build`命令生成部署产物，根据业务需求选择Vercel、Cloudflare等平台一键推送，或打包为Docker镜像部署到自有服务器。

适合什么人群

• TypeScript全栈开发者(搭建AI应用)
• AI应用开发工程师(开发智能体产品)
• 企业技术团队(搭建内部知识问答系统)
• SaaS产品开发者(嵌入AI助理功能)
• HR技术负责人(开发自动化招聘流程)
• 内容生产团队(搭建AI内容创作工具)

总结

这是一款专门面向TypeScript生态的开源智能体开发框架，由Gatsby团队研发，采用Apache 2.0开源协议，商业使用无限制。不同于其他语言的智能体框架，它深度适配JavaScript/TypeScript技术栈，开发者可以用熟悉的语法完成智能体开发，无需额外学习新的编程语言。框架将智能体开发所需的模型适配、记忆管理、工具调用、RAG能力、调试工具、部署链路全部集成在内，无需开发者对接零散的第三方工具，大大降低了AI应用的开发门槛。它还兼容Vercel AI SDK，可直接在React、Next.js、Astro、SvelteKit等主流前端框架中调用智能体能力，方便开发者将AI功能直接嵌入现有Web应用。对于熟悉TypeScript技术栈，想要快速落地AI智能体应用的开发者而言，该框架是一个值得尝试的选择，活跃的社区也能为开发过程中遇到的问题提供及时的支持。

价格与免费额度

Mastra采用完全开源免费的模式，所有核心功能均面向所有开发者开放，无功能限制，也无使用配额限制，个人与企业均可免费使用全部框架能力。官方不提供直接的付费版本，若企业需要定制化开发、技术支持、部署服务等增值服务，可联系官方团队协商定制服务方案，费用根据需求复杂度单独评估。建议个人开发者、中小型团队直接使用开源版本即可满足开发需求，有定制需求的大型企业可联系官方获取商业支持服务。

优点与不足

能帮你做的 8 件事

1. 01统一模型路由
2. 02智能体记忆系统
3. 03工具与MCP调用
4. 04工作流引擎
5. 05开源AI框架场景的常用方案
6. 06智能体开发场景的常用方案
7. 07TypeScript全栈开发者(搭建AI应用)的日常效率工具
8. 08零成本体验完整核心功能

更新历史

• 2026.09.17页面资料核验与信息更新
• 2026.06.14Mastra 收录进 Toolifai 目录

常见问题