Mastra

产品简介

Mastra AI是一款面向 TypeScript 开发者的开源智能体框架，由Gatsby团队打造，旨在用一套统一的API 和工具链帮助开发者快速构建、测试、部署具备记忆、工具调用、工作流编排等能力的AI应用。产品内置了模型路由、向量检索、可观测性、评估指标、持久化存储等“全家桶”能力，支持在本地 Playground 中实时调试，也能一键打包到 Vercel、Cloudflare、Netlify 等 Serverless 平台。借助 Vercel AI SDK，开发者可以在 React、Next.js、Astro、SvelteKit 等前端框架中直接调用智能体，实现流式对话、结构化输出、前端动作触发等高级交互。Mastra 采用 Apache 2.0 协议，商业友好，社区活跃，被众多开发者评价为“TypeScript 生态中最易用的 Agent 框架”。

主要功能

• 统一模型路由：一行代码切换 OpenAI、Anthropic、Google、Ollama 等任意 LLM，无需改动业务逻辑。
• 智能体记忆系统：支持长期记忆、语义召回、会话线程管理，让 Agent 记得住用户上下文。
• 工具与 MCP 调用：内置 Zod 运行时校验，可快速封装 REST、数据库、文件系统等外部能力。
• 工作流引擎：基于 XState 的图状状态机，支持顺序、并行、分支、循环、暂停/恢复等复杂流程。
• RAG 完整链路：文档分块、向量化、存储、检索、重排一站式 API，兼容 Pinecone、pgvector 等主流向量库。
• 可观测与评估：自动采集 OpenTelemetry 追踪，内置毒性、幻觉、相关性等评估指标，可自定义评分脚本。
• 本地 Playground：实时聊天、记忆查看、工具调用追踪，零配置启动，所见即所得。
• 一键部署：CLI 生成 Hono 服务或 Serverless Bundle，支持边缘函数、Docker、传统服务器多形态发布。

使用方法

1. 安装 CLI：npm create mastra@latest my-agent 并按提示选择组件与模型。
2. 配置密钥：在 .env 中写入 OPENAI_API_KEY 或其他提供商密钥。
3. 定义工具：在 src/mastra/tools/ 下用 createTool 编写函数与输入输出 Schema。
4. 创建智能体：在 src/mastra/agents/ 下用 new Agent 绑定模型、指令、工具与记忆。
5. 注册入口：在 src/mastra/index.ts 中 new Mastra({ agents: { yourAgent } }) 导出实例。
6. 本地调试：运行 npm run dev，打开 http://localhost:4111 进入 Playground 进行对话测试。
7. 构建部署：执行 npm run build 生成产物，选择 Vercel/Cloudflare 等平台一键推送或自建容器。

应用场景

• 企业知识问答：将内部文档、Wiki、工单系统向量化，打造可记忆、可追溯的企业级 ChatBot。
• 多步骤业务流程自动化：如简历筛选、面试安排、Offer 发放等 HR 流程，通过工作流节点串接 LLM 与内部系统。
• AI 助理嵌入 SaaS：在现有 Web 应用里通过 Vercel AI SDK 的 useChat 快速集成智能客服或数据洞察助手。
• 内容创作与摘要：利用 RAG 检索最新资料，自动生成文章、报告、播客摘要，并支持多语言输出。
• 实时语音交互：结合语音转文字、文字转语音模块，在直播、会议场景中提供实时字幕与多语言同传。