Mastra 入门：脚手架、首个 Agent 与 createTool
按 Mastra 官方 Get started / Tools 文档，用 npm create mastra@latest 或手动脚手架搭好 TypeScript 项目；定义 Agent（provider/model 字符串）与 createTool 工具，注册到 Mastra 后用 agent.generate 跑通首调。模型示例与官方一致用 openai/gpt-5.6-sol。
入门·2 课时·45 分钟·图文实操
免费学习无需登录
你将学会
- 用 npm create mastra@latest（或手动 package.json + @mastra/core）搭好 ESM TypeScript 项目骨架
- 按官方 provider/model 字符串（如 openai/gpt-5.6-sol）创建 Agent，并配置对应 API Key 环境变量
- 用 createTool 定义带 Zod inputSchema 的工具，挂到 Agent，经 Mastra.getAgentById + generate 完成首调
适合谁
- 要用 TypeScript 从零搭 AI Agent / 工具调用应用的后端与全栈开发者
- 已会 Node.js，想跟官方 Mastra docs 走通脚手架与 createTool 的工程师
- 需要统一 model 路由字符串与工具签名、避免过时 AI SDK 写法的中文开发者
课前准备
- 本机 Node.js 18+（官方示例可用 Node 22.18+ 直接跑 .ts）；会用终端与 npm
- 至少一个模型提供商 API Key（OpenAI / Anthropic / Google 等，按所选 model 前缀配置）
- 熟悉基本 TypeScript / ESM import；不要求已用过 LangChain 或其他 Agent 框架
课程目录
2 课时 · 45 分钟- 01脚手架与首个 Agent：create mastra 与 provider/model用 npm create mastra@latest 或手动安装 @mastra/core；写 Agent（id/name/instructions/model），注册 Mastra，用 generate 完成首调。图文22 分钟开始本课
- 02工具：createTool + 挂载 Agent 再 generate按官方 Tools 文档用 createTool 定义天气工具（Zod schema + execute），挂到 Agent.tools，再 generate 触发工具调用并读出结果。图文23 分钟开始本课
课程说明
本课按 Mastra 官方 Get started 与 Tools 文档整理成中文可跟做讲义，不是原文搬运。
来源：Get started、llms.txt 文档索引、Tools、Models、Environment variables。脚手架命令：npm create mastra@latest。
官方强调：model 写成 provider/model 字符串（例如 openai/gpt-5.6-sol），不要用 openai: 前缀，也不要自行 import 提供商对象；工具必须用 createTool()，execute(inputData, context) 为现行签名。两课你会做完：搭好项目并跑通首个 Agent；再用 createTool 挂工具后 generate。