Mastra智能体应用开发与调试
接收 Mastra 业务需求或接口报错信息,依据最新嵌入文档与规范生成 TypeScript 智能体与工作流代码,并提供 CLI 链路追踪与排障方案。
功能与用途
本功能专门面向 Mastra TypeScript 全栈 AI 框架。针对该框架版本更迭快、易出现废弃 API 的特性,遵循严格的文档验证优先级(优先 node_modules 嵌入文档,次选类型定义与源码,最后拉取远程官方文档),杜绝过时代码。它能协助开发者正确创建 Agent、Workflow、Tool 与 Memory 模块,规范配置 provider/model-name 模型路由,并通过 mastra api 命令行对本地与远程实例进行状态检查、Trace 链路追踪与执行质量排查。
适用场景
- 智能体与多步骤工作流构建:根据业务目标与输入输出要求,遵循 ES2022 规范与最新 API,编写包含工具调用、记忆持久化和步骤编排的 Mastra 代码。
- 框架升级与类型报错修复:针对 Mastra 版本升级中出现的参数不匹配、类型丢失及模块导入异常,核对实际安装版本的类型定义并给出迁移改写方案。
- Trace 链路追踪与健康度分析:运用 mastra api CLI 指令检索指定运行批次的 Trace、Span 与 Log,结合 Trace Intelligence 排查失败原因并优化提示词与工具定义。
适用人群
- 使用 TypeScript 开发 LLM 应用的全栈开发者
- 基于 Mastra 构建复杂 Agent 与 Workflow 的架构师
- 需要对智能体执行链路与错误 Trace 进行分析定位的运维开发人员
使用步骤
- 检查本地项目是否已安装 `@mastra/*` 依赖并确认版本环境。
- 提出具体的智能体架构需求(如 Agent、Workflow、Tool、Memory)或粘贴当前编译报错与版本迁移诉求。
- 根据指示通过 provider-registry 脚本核验可用模型标识,获取符合最新 API 签名的 TypeScript 模块代码。
- 启动 npm run dev 打开 Mastra Studio 进行交互式调试,或使用 mastra api CLI 进行 Trace 链路监控与排障。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Comprehensive Mastra framework guide for building agents, workflows, tools, memory, workspaces, and storage with current APIs. Use for documentation lookup, API verification, TypeScript setup, common errors, migrations, and `mastra api` CLI tasks: inspect or call resources on local, Mastra platform, Trace Intelligence, or remote servers. For Mastra Factory operations, discover and activate the companion mastra-factory skill.
依赖与权限
- 读取用户主动提供的内容