从机制开始
先讲 Agent Loop、模型策略、工具调用、上下文、状态和编排，再进入 Mastra API。
使用 Mastra 构建 Agents从原理到实践
面向 vibe coding 开发者的渐进式中文教程：先理解 Agent 的运行机制，再一步步做出可运行的学习助手。
Skip to content
学习内容
这不是 Mastra 源码逐行翻译，而是一套可复现的工程教程。课程先用很小的 TypeScript Demo 解释 Agent 为什么要拆成模型、工具、记忆、工作流和检索，再把这些机制映射到 Mastra 的真实项目结构。
最终你会得到一个教学版 Study Agent：
- 可以搜索本地课程资料。
- 可以根据目标生成学习计划。
- 可以生成练习题。
- 可以保存对话线程和学习偏好。
- 可以在无 API Key 的情况下离线演示核心链路。
- 可以在配置模型密钥后通过 Mastra Studio 调试真实 Agent。
- 可以继续扩展模型路由、RequestContext、Streaming、Scorers 和服务化 API。
推荐学习方式
- 先读 学习路线，理解每章解决的问题。
- 运行 Demo 01，确认本地环境可用。
- 每读完一章都运行对应 Demo，不要只看代码。
- 阅读 天气与旅行 Agent 案例，理解 Tool 复用、Memory 和 Workflow 的取舍。
- 到 最终项目 时，用
npm run final:offline先跑通离线链路。 - 准备好模型密钥后，再用
npm run final:dev进入 Mastra Studio。
资料来源
教程以官方资料为主，包括 Mastra GitHub、Mastra Docs、Mastra Reference 和 VitePress Docs。