昆
昆仑AI工具大全KUN.NET
提交工具

Mastra 入门：用官方 Quickstart 搭出可调用工具的 TypeScript Agent

按 Mastra 官方文档，用 create-mastra CLI 脚手架或手工 createTool + Agent，跑通 generate 调用，并打开 Studio 交互界面。

入门2 课时40 分钟图文实操

免费学习无需登录

开始学习 查看课程目录
Mastra 入门：用官方 Quickstart 搭出可调用工具的 TypeScript Agent 课程封面

你将学会

  • 用 npm create mastra@latest 脚手架出可运行的 Agent 工程
  • 用 createTool 定义带 zod 校验的工具并挂到 Agent
  • 用 provider/model 字符串配置模型并设置 API Key
  • 调用 agent.generate 并在 Studio 验证

适合谁

  • 熟悉 TypeScript / Node.js 的开发者；想用官方框架快速搭 AI Agent 的人

课前准备

  • 已安装 Node.js（建议 20+）；有任一模型供应商 API Key；会用终端执行 npm

课程目录

2 课时 · 40 分钟
  1. 01用 create-mastra CLI 脚手架项目并打开 Studio非交互或交互方式创建 Mastra 工程，安装依赖，启动 Studio，在浏览器里与首个 Agent 对话。图文18 分钟开始本课
  2. 02手工 createTool + Agent，并调用 generate按官方 condensed 指南手写 weather tool 与 weather agent，注册到 Mastra，用 generate 打出第一句回复。图文22 分钟开始本课

课程说明

本课依据 Mastra 官方 Get started / Quickstart，走完两条最短可复现路径：

  1. 用 npm create mastra@latest 脚手架，并打开 Studio 与首个 Agent 对话
  2. 手工用 createTool、Agent、Mastra 注册后调用 agent.generate

命令、模型 ID 与 API 签名均对照当前官方文档，不以二手教程为准。

完成判据

  • 本地能启动 Studio，并对默认 Agent 收到回复
  • 手工工程里 node run.mjs 能打印 response.text
  • model 使用 provider/model 字符串，且对应 API Key 环境变量已设置

先决条件

  • Node.js（脚手架建议 20+；直接跑官方 TS 示例需 22.18.0+）
  • 任一模型供应商 API Key（如 OPENAI_API_KEY）
  • 会在终端执行 npm / node

官方来源

Mastra 是开源 TypeScript Agent 框架：把 agents、workflows、memory、workspaces、observability 收在一套原语里，可嵌入 Next.js / React / Node，也可独立部署。