Mastra使用教程

安装框架CLI，在终端执行`npm create mastra@latest my-agent`命令，按照终端提示选择需要的组件与默认大模型服务商，完成项目初始化。

配置服务密钥，在项目根目录的`.env`文件中写入`OPENAI_API_KEY`或其他大模型提供商的访问密钥，确保框架可以正常调用大模型服务。

定义自定义工具，在`src/mastra/tools/`目录下，使用`createTool`函数编写工具逻辑与输入输出Schema，封装需要的外部系统调用能力。

创建智能体实例，在`src/mastra/agents/`目录下，通过`new Agent`语法绑定指定模型、系统指令、已定义的工具与记忆配置，完成智能体核心逻辑搭建。

注册实例入口，在`src/mastra/index.ts`文件中通过`new Mastra({ agents: { yourAgent } })`语句导出实例，完成核心代码编写。

本地调试验证，执行`npm run dev`命令启动本地服务，打开`http://localhost:4111`进入Playground页面，与智能体对话测试功能是否符合预期。