尧图网站建设 
5 步上手 Mastra从工具定义到 Studio 里跑通 AI Agent【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra你希望 AI 助手不只是聊天还能调接口取数据、按流程办事。Mastra 就是一个 TypeScript 的 AI Agent 框架用一套代码定义工具、智能体和工作流再在浏览器里直接调试。读完本文你能从零生成一个项目、写出自定义工具并在 Studio 中完成一次工具调用的完整验证。30 秒看懂项目Mastra 是面向 AI 应用的 TypeScript 框架把开发 Agent 的核心积木一次性给全模型路由用统一接口接入 40 多家模型提供商、Agents会自己选工具、循环执行直到给出答案的智能体、Workflows图式的多步流程引擎、记忆与存储持久化对话记录和运行状态。它可以嵌进现有的 React 或 Next.js 项目也可以作为独立服务器运行。Studio 是自带的 Web 界面在浏览器里构建、测试和管理这些资源。运行时数据都会汇入 Mastra Storage智能体的会话记录、评测数据集、追踪日志以及工作流执行的快照状态都存在这里这也是流程可以暂停、稍后恢复的基础。动手前准备环境与密钥清单逐项对照Node.js ≥ 22.13.0终端执行 node -v 查看不满足先升级一个 LLM 提供商的 API KeyOpenAI、Anthropic、Google、xAI 任选其一npm随 Node.js 附带约 10 分钟时间如要运行本仓库里的完整示例单仓另需 pnpm ≥ 10.18.0不需要 Docker仅部分测试用到5 步跑起来从脚手架到 Studio 验证1. 生成项目脚手架目标不写代码拿到可运行骨架。终端执行npm create mastralatest my-agent-app -- --llm openaicreate-mastra 这个 CLI 工具会生成目录并装好依赖--llm指定模型提供商可选 openai、anthropic、google、xai。成功标志新目录下有 src/mastra/ 目录组装 Mastra 实例的入口。项目刚有壳没有密钥模型不会应答下面先加燃料。2. 配置模型 API Key目标让 Agent 能真正调用模型。在项目根目录建.env文件按OPENAI_API_KEYsk-...的形式写入密钥其他提供商用对应变量名改完重启开发服务器生效。成功标志服务器启动不再报缺密钥的错误。模型就绪接下来把服务跑起来到浏览器里看界面。3. 启动开发服务器打开 Studio目标看到本地 AI 应用界面。在项目目录执行npm run dev浏览器打开 http://localhost:4111这就是 Mastra Studio 界面包含 Agents、工具、Workflows 的列表页。成功标志Studio 正常打开脚手架自带的示例 Agent 出现在列表里。示例 Agent 只是占位接下来换成自己的第一个工具。4. 定义你的第一个工具目标给 Agent 一个具体能力比如查天气。工具是用createToolmastra/core 提供创建的 TypeScript 对象四件套唯一 id、给模型看的用途描述、输入输出 schema用 zod 声明参数与返回类型、真正干活的execute函数定义后挂到 Agent 的 tools 列表里注册。示例项目里就有现成的天气工具可对照。成功标志开发服务器热更新后工具出现在 Studio 的工具列表。单个工具只干一件事把多个能力串成流程要靠工作流。5. 用对话做端到端验证目标确认模型决策→工具执行→结果回填整条链路。在 Studio 进入 Agent 页面对话输入北京天气怎么样观察它调用你的工具并组织答案。成功标志回复里有工具返回的城市和温度字段执行记录里能看到工具调用轨迹。踩坑与排障5 个高频问题现象可能原因处理办法Agent 回复缺密钥或 401 错误.env 没写对应提供商的 Key或改后没重启核对变量名与拼写重启开发服务器Studio 打不开、提示端口占用另一个 Mastra 进程占着 4111 端口停掉占用进程或改用其他端口工具写了但 Studio 里看不到没挂到 Mastra 实例或 Agent 的 tools 没引用对照示例的组装文件确认两处注册npm create mastra 报 Node 版本错误Node.js 低于 22.13.0升级到 22.13 以上再执行构建示例单仓时内存溢出默认堆内存不够构建命令前加 NODE_OPTIONS--max-old-space-size4096接下来往哪走3 条进阶路线 想编排多步业务工作流引擎用 .then()、.branch()、.parallel() 表达顺序、分支与并行也支持 foreach 循环源码见 workflows/。 想把 Agent 暴露给其他系统用 MCP 包 把 Agent 和工具打包成 MCPModel Context ProtocolAI 连接外部工具的标准接口服务器支持该协议的客户端都能接入。 想部署生产环境在 deployers 目录 里选目标平台Cloudflare、Vercel、Netlify 等都有对应适配层。现在就打开终端执行npm create mastralatest10 分钟内让一个 Mastra 项目跑起来。跑通后顺着 examples/agent/ 的示例和 DEVELOPMENT.md 继续往下搭。【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5 步上手 Mastra：从工具定义到 Studio 里跑通 AI Agent
5 步上手 Mastra从工具定义到 Studio 里跑通 AI Agent【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra你希望 AI 助手不只是聊天还能调接口取数据、按流程办事。Mastra 就是一个 TypeScript 的 AI Agent 框架用一套代码定义工具、智能体和工作流再在浏览器里直接调试。读完本文你能从零生成一个项目、写出自定义工具并在 Studio 中完成一次工具调用的完整验证。30 秒看懂项目Mastra 是面向 AI 应用的 TypeScript 框架把开发 Agent 的核心积木一次性给全模型路由用统一接口接入 40 多家模型提供商、Agents会自己选工具、循环执行直到给出答案的智能体、Workflows图式的多步流程引擎、记忆与存储持久化对话记录和运行状态。它可以嵌进现有的 React 或 Next.js 项目也可以作为独立服务器运行。Studio 是自带的 Web 界面在浏览器里构建、测试和管理这些资源。运行时数据都会汇入 Mastra Storage智能体的会话记录、评测数据集、追踪日志以及工作流执行的快照状态都存在这里这也是流程可以暂停、稍后恢复的基础。动手前准备环境与密钥清单逐项对照Node.js ≥ 22.13.0终端执行 node -v 查看不满足先升级一个 LLM 提供商的 API KeyOpenAI、Anthropic、Google、xAI 任选其一npm随 Node.js 附带约 10 分钟时间如要运行本仓库里的完整示例单仓另需 pnpm ≥ 10.18.0不需要 Docker仅部分测试用到5 步跑起来从脚手架到 Studio 验证1. 生成项目脚手架目标不写代码拿到可运行骨架。终端执行npm create mastralatest my-agent-app -- --llm openaicreate-mastra 这个 CLI 工具会生成目录并装好依赖--llm指定模型提供商可选 openai、anthropic、google、xai。成功标志新目录下有 src/mastra/ 目录组装 Mastra 实例的入口。项目刚有壳没有密钥模型不会应答下面先加燃料。2. 配置模型 API Key目标让 Agent 能真正调用模型。在项目根目录建.env文件按OPENAI_API_KEYsk-...的形式写入密钥其他提供商用对应变量名改完重启开发服务器生效。成功标志服务器启动不再报缺密钥的错误。模型就绪接下来把服务跑起来到浏览器里看界面。3. 启动开发服务器打开 Studio目标看到本地 AI 应用界面。在项目目录执行npm run dev浏览器打开 http://localhost:4111这就是 Mastra Studio 界面包含 Agents、工具、Workflows 的列表页。成功标志Studio 正常打开脚手架自带的示例 Agent 出现在列表里。示例 Agent 只是占位接下来换成自己的第一个工具。4. 定义你的第一个工具目标给 Agent 一个具体能力比如查天气。工具是用createToolmastra/core 提供创建的 TypeScript 对象四件套唯一 id、给模型看的用途描述、输入输出 schema用 zod 声明参数与返回类型、真正干活的execute函数定义后挂到 Agent 的 tools 列表里注册。示例项目里就有现成的天气工具可对照。成功标志开发服务器热更新后工具出现在 Studio 的工具列表。单个工具只干一件事把多个能力串成流程要靠工作流。5. 用对话做端到端验证目标确认模型决策→工具执行→结果回填整条链路。在 Studio 进入 Agent 页面对话输入北京天气怎么样观察它调用你的工具并组织答案。成功标志回复里有工具返回的城市和温度字段执行记录里能看到工具调用轨迹。踩坑与排障5 个高频问题现象可能原因处理办法Agent 回复缺密钥或 401 错误.env 没写对应提供商的 Key或改后没重启核对变量名与拼写重启开发服务器Studio 打不开、提示端口占用另一个 Mastra 进程占着 4111 端口停掉占用进程或改用其他端口工具写了但 Studio 里看不到没挂到 Mastra 实例或 Agent 的 tools 没引用对照示例的组装文件确认两处注册npm create mastra 报 Node 版本错误Node.js 低于 22.13.0升级到 22.13 以上再执行构建示例单仓时内存溢出默认堆内存不够构建命令前加 NODE_OPTIONS--max-old-space-size4096接下来往哪走3 条进阶路线 想编排多步业务工作流引擎用 .then()、.branch()、.parallel() 表达顺序、分支与并行也支持 foreach 循环源码见 workflows/。 想把 Agent 暴露给其他系统用 MCP 包 把 Agent 和工具打包成 MCPModel Context ProtocolAI 连接外部工具的标准接口服务器支持该协议的客户端都能接入。 想部署生产环境在 deployers 目录 里选目标平台Cloudflare、Vercel、Netlify 等都有对应适配层。现在就打开终端执行npm create mastralatest10 分钟内让一个 Mastra 项目跑起来。跑通后顺着 examples/agent/ 的示例和 DEVELOPMENT.md 继续往下搭。【免费下载链接】mastraMastra is the modern TypeScript framework for AI-powered applications and agents.项目地址: https://gitcode.com/GitHub_Trending/ma/mastra创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考