Mastra AI框架入门：4步跑通你的第一个AI应用
【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra
想给产品接上AI Agent能力，却不知从哪下手？Mastra是一个基于TypeScript的AI框架，把Agent、工具调用、工作流引擎和存储集成在一起，让AI应用从建项目到在浏览器里对话只走4步。下面把全程走一遍。
30秒看懂这个项目
- 它是什么：TypeScript的AI框架，内置Agent、工具、工作流、记忆和存储等核心模块
- 解决什么问题：不用自己拼一堆SDK搭AI应用，一套标准接口接入40多个模型供应商，选个模型就能用
- 适合谁：熟悉TypeScript的前端或Node开发者，目标是把AI应用或Agent真正跑上线
动手前的准备
装什么、从哪来，一张清单：
- Node.js ≥ v22.13.0，用
node -v确认当前版本 - npm（日常开发够用）；如果要从源码开发，仓库用 pnpm ≥ v10.18，可配合 corepack 启用
- 一个模型服务的API Key，如OpenAI或Anthropic
- 想边跑边看源码的话，先克隆仓库：
git clone https://gitcode.com/GitHub_Trending/ma/mastra
跟着做：跑通第一个AI应用
第1步：用CLI创建项目
目标：拿到一个能直接运行的项目骨架。
- 在空目录里运行下面的命令
- 按提示输入项目名，选择模型供应商（openai / anthropic / google / xai）
- CLI会自动装好依赖，并生成默认的Agent与工具
npm create mastra@latest验证方式：项目里出现src/mastra/目录，里面就是Agent的定义。
第2步：配置模型API Key
目标：让Agent能真正调通模型。
- 从模型供应商后台复制API Key
- 在根目录
.env文件里写入对应变量，OpenAI用OPENAI_API_KEY，Anthropic用ANTHROPIC_API_KEY - 脚手架已按你选的供应商配好默认模型，不用改别的
验证方式：打开.env能看到刚才写入的Key。
第3步：启动开发服务器，在Studio里对话AI Agent
目标：在浏览器里给Agent发消息，收到回复。
- 在项目根目录启动开发服务器
- 打开 http://localhost:4111 进入Mastra Studio
- 给默认Agent发一句话，回复会实时流式返回，工具调用也能在这里看到
npm run dev第4步：看懂工作流控制流
目标：知道多步骤任务怎么写。
- 打开脚手架里的workflow文件，认准三个原语：
.then()顺序执行、.branch()分支、.parallel()并行 .foreach()会对同一步骤循环执行多次，再进入下一步- 想抄完整写法，直接翻仓库里的示例项目
新手大概率踩的坑
- Studio打不开，提示端口被占用→ 4111端口被别的进程占了 → 停掉旧的
npm run dev进程，或换端口 - 第一次调用报401认证错误→ API Key没写进
.env，或Key与所选供应商不匹配 → 对照检查变量名和Key来源 - 安装时报Node版本过低→ 本机Node低于22.13 → 用nvm切到v22以上再重启终端
- 从源码开发时找不到pnpm命令→ 仓库用pnpm加corepack管理 → 执行
corepack enable，再跑pnpm run setup
从跑通到真正用上
- 本地验证：用Studio覆盖基本对话与工具调用；回归测试可以接内置的evals评估模块
- 部署上线：仓库在
deployers/下提供了Vercel、Cloudflare、Netlify等部署适配器，按其中对应说明发布即可 - 上线后看什么：日志和全链路trace交给observability可观测模块，evals数据集的通过率用来盯质量
下一步去哪
- 深入API与用法：仓库内的官方文档目录 docs/，Agent、工具、工作流的章节都能直接查
- 读核心实现：Agent、工具与工作流引擎都在 核心模块 packages/core/
- 照着示例改：示例项目 examples/agent/ 是一个可运行的完整AI应用，适合当练习场
【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
