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 / xaiCLI会自动装好依赖并生成默认的Agent与工具npm create mastralatest验证方式项目里出现src/mastra/目录里面就是Agent的定义。第2步配置模型API Key目标让Agent能真正调通模型。从模型供应商后台复制API Key在根目录.env文件里写入对应变量OpenAI用OPENAI_API_KEYAnthropic用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），仅供参考 
长河君 · 2026/9/4 10:29:27 · 阅读 1.2k Mastra AI框架入门：4步跑通你的第一个AI应用
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 / xaiCLI会自动装好依赖并生成默认的Agent与工具npm create mastralatest验证方式项目里出现src/mastra/目录里面就是Agent的定义。第2步配置模型API Key目标让Agent能真正调通模型。从模型供应商后台复制API Key在根目录.env文件里写入对应变量OpenAI用OPENAI_API_KEYAnthropic用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），仅供参考