Mastra Agents 教程

Appearance

运行环境 ​

本地要求 ​

当前项目使用：

  • Node.js 22+
  • npm 10+
  • TypeScript
  • VitePress
  • Mastra 1.x

先安装依赖：

bash
npm install

启动教程站点：

bash
npm run docs:dev

构建静态站点：

bash
npm run docs:build

运行离线 Demo ​

这些 Demo 不需要模型密钥：

bash
npm run demo:01
npm run demo:02
npm run demo:03
npm run demo:04
npm run demo:05

最终项目的离线链路：

bash
npm run final:offline

运行真实 Mastra 项目 ​

复制环境模板：

bash
cp .env.example .env

编辑 .env，填入所选 provider 对应的模型密钥。然后启动：

bash
npm run final:dev

Mastra Studio 默认打开：

text
http://localhost:4111

注意

不要把 .env 内容复制到聊天窗口，也不要提交到代码仓库。教程只需要 .env.example，真实密钥留在本机。

最快验收 ​

如果只需要确认项目是否完整，按这个顺序跑：

bash
npm install
npm run docs:build
npm run demo:01
npm run demo:05
npm run final:offline
npm run final:eval