用途：Mastra 是 TypeScript AI 框架，用于构建智能体、工作流、工具与 AI 应用，统一注册智能体、工作流、工具、记忆、MCP 等资源。
主要能力：Agent 支持指令、模型字符串与工具，可 generate() 或 stream()，maxSteps 默认 5；Workflow 用 createWorkflow/createStep 构建，支持 then、branch、dountil/dowhile、parallel、foreach，末尾必须 commit()；Tool 用 createTool 配合 Zod 定义输入输出；Memory 含消息历史、工作记忆、观察记忆与语义召回；MCPClient 连接外部工具服务器，MCPServer 暴露 Mastra 能力；支持 RAG、语音、评估与可观测性。
使用方式：新项目运行 npm create mastra@latest，已有项目运行 npx mastra init --components agents,tools,workflows --llm openai。需配置至少一个 LLM 密钥，如 OPENAI_API_KEY。CLI 包括 mastra dev（Studio 位于 localhost:4111）、mastra build、mastra start、mastra lint、mastra migrate。智能体应通过 mastra.getAgent('id') 访问，直接导入会绕过日志与遥测。
适用场景：构建带工具与记忆的智能体、多步骤工作流、RAG 管道、MCP 集成与部署到 Node.js 22+、Bun、Deno、Cloudflare、Vercel、Netlify、AWS、Azure。
限制：不适用于与 Mastra 无关的通用 TypeScript/Node.js 问题或其他 AI 框架。工作流缺少 commit() 会静默失效；步骤 schema 不匹配在运行时才报错；listTools() 在初始化时缓存工具；资源 ID 不唯一可能导致跨用户数据泄漏；动态 listToolsets() 后需 disconnect()。详细子领域内容见 references/ 下文件，按需加载。