Studio
Studio 提供交互式 UI，用于构建、测试和管理你的 agents、workflows 和工具。你可以在开发期间本地运行，添加身份验证，或部署到生产环境，让团队管理 agents、监控性能，并通过内置可观测性获得洞察。
观看 Mastra Studio 概览，快速了解如何在 Studio 中构建、测试和管理 agents。
启动 Studio启动 Studio的直接链接
如果你使用 create mastra 创建应用，可通过 dev 脚本启动开发服务器，也可以直接使用 mastra dev 运行。
- npm
- pnpm
- Yarn
- Bun
npm run dev
pnpm run dev
yarn dev
bun run dev
服务器启动后，你可以：
- 打开 Studio UI：
localhost:4111，与 agents、workflows 和工具交互。 - 访问
localhost:4111/swagger-ui，发现并调用底层 REST API。
Studio 让你实时编辑 agents、workflows 以及 Mastra 应用的其他部分。
部署 Studio部署 Studio的直接链接
当你准备与团队共享 Studio 时，可以使用 Mastra 平台上的 Studio 或自己的基础设施将其部署到生产环境。具体方法参见部署文档。
原语原语的直接链接
AgentsAgents的直接链接
直接与 Agent 聊天，切换模型，并调整 temperature、top-p 等设置，以了解它们对输出的影响。
与 Agent 交互时，你可以跟踪其推理过程并查看工具调用输出。还可以观察 traces 和日志，了解响应是如何生成的。
对于响应中的 markdown 表格，点击表格上方的 Copy table as markdown，即可复制表格而不包含周围消息。复制的表格会保留 markdown 格式，并包含其使用的链接和脚注定义。若要下载为 CSV，请打开复制按钮旁的箭头并选择 Download CSV。只有当包含该表格的文本段完成流式传输并显示后，这两个操作才可用。此时 Agent 可能仍在运行工具或撰写后续片段。
CSV 导出包含纯单元格文本，其中包括链接标签而非 URL。脚注标记会保留，但其定义不会包含在 CSV 中。可能被解释为电子表格公式的值会加上前导单引号，使电子表格应用将其视为文本。普通的带符号数字会保持不变。
你还可以附加 scorers，衡量并比较随时间变化的响应质量。
在 Agent 响应流式传输期间，你可以在同一线程中发送后续消息。Studio 会将该消息显示为待处理，直到流确认后再在该后续消息下方继续响应。其他打开了同一线程的 Studio 标签页可以观察活跃的流。
使用 Editor，让非技术团队成员迭代 agents、为每次变更创建版本，并在无需重新部署的情况下运行实验。
使用 Agent Builder，通过独立的浏览器界面创建和管理完全存储的 agents。
Models 面板Models 面板的直接链接
打开 Agent 的 Models 面板，可按优先级查看其主模型和备用模型。对于静态模型列表，你可以重排模型、启用或禁用备用模型，以及更改提供商或模型。Studio 重新获取 Agent 时，该面板会保持同步。
这些编辑会修改运行中服务器的内存中 Agent，并在服务器重启后丢失。持久化的模型列表编辑功能在 GitHub issue #27089 中跟踪。
函数式模型列表可能因请求上下文而异，因此 Studio 将其显示为只读。请改为在代码中修改动态模型列表。
WorkflowsWorkflows的直接链接
以图表形式可视化 workflow，并使用自定义输入逐步运行。执行期间，界面会实时更新，显示活跃步骤和所走路径。
Workflow traces 会显示工具调用、原始 JSON 输出以及任何执行错误。
点击运行按钮旁的 Run Options，可为你启动的运行设置 Resource ID。Studio 会按 workflow 记住该值，其创建的运行可通过 GET /api/workflows/:workflowId/runs?resourceId=... 列出。留空则创建不带资源的运行。当服务器从已认证用户推导 resource ID 时，该值优先于你输入的值。
ProcessorsProcessors的直接链接
查看附加到每个 Agent 的输入和输出 processors。Agent 详情面板会按名称和类型列出所有 processors，让你在测试前确认 guardrails、token 限制器和自定义 processors 已正确接入。
配置细节参见 processors 和 guardrails。
MCP 服务器MCP 服务器的直接链接
列出附加到 Mastra 实例的 MCP 服务器，并查看其可用工具。
工具工具的直接链接
单独运行工具以观察行为，并在分配给 Agent 之前进行测试。如果出现问题，可单独重新运行工具以调试。
WorkspacesWorkspaces的直接链接
使用内置文件浏览器，浏览 Agent workspace 文件系统中的文件。你可以在 workspace 挂载点之间切换、创建目录，并以语法高亮查看文件内容。可写 workspace 允许创建目录和删除文件；只读 workspace 会有相应标记。Skills 标签页列出所有已发现的 skills 及其指令、参考和元数据。可从 skills.sh 安装社区 skills，或移除已有 skills。
配置细节参见 workspaces。
请求上下文请求上下文的直接链接
设置运行时变量，通过依赖注入流入 Agent 的指令和工具。可用 JSON 编辑请求上下文；当 Agent 定义了 requestContextSchema 时，也可使用由 schema 驱动的表单。这些值会在测试聊天和实验之间保留，因此你无需重启即可触发条件流程。
配置细节参见请求上下文。
评估评估的直接链接
使用日期筛选器，将分数指标限制在预设或自定义时间范围内。
ScorersScorers的直接链接
Scorers 标签页显示 Agent 的 scorers 运行结果。当消息经过 Agent 时，已定义的 scorers 会异步评估每个输出，并在此处渲染结果。你可以了解 scorers 如何响应不同交互、比较各测试用例的表现，并找出需要改进的地方。
DatasetsDatasets的直接链接
创建和管理测试用例集合，以评估 agents 和 workflows。从 CSV 或 JSON 导入条目，定义输入和 ground-truth schemas，并固定到特定版本，从而精确复现实验。使用 scorers 运行实验，比较不同 prompts、模型或代码变更下的质量。
完整 API 和版本控制细节参见 datasets 概览。
实验实验的直接链接
针对 Agent、workflow 或 scorer 运行 dataset 中的所有条目，并将结果集中收集。选择目标，可选地附加 scorers，然后触发实验。结果视图显示每个条目的输入、输出、状态和单独分数明细。可将 2 到 10 个实验与基线并排比较，衡量 prompt、模型或代码变更的影响。
设置细节参见 datasets 概览。
可观测性可观测性的直接链接
更多信息参见 Studio 可观测性文档。
设置设置的直接链接
配置 Studio 与 Mastra 服务器之间的连接。设置页面包括：
- Mastra 实例 URL：Mastra 服务器的基础 URL（例如
http://localhost:4111）。 - API 前缀：所有 API 请求的可选路径前缀（默认为
/api）。 - 自定义 headers：添加随每个请求发送的键值对，适用于身份验证 tokens 或路由 headers。
- 主题：在深色、浅色或跟随系统主题之间切换。
代码配置代码配置的直接链接
除了设置 UI，你还可以在 src/mastra/index.ts 中通过 server 选项配置本地开发服务器和 Studio。
默认情况下，Studio 运行在 http://localhost:4111。你可以更改 host 和 port。
Mastra 还支持通过 --https 标志进行 HTTPS 开发，该标志会为你的项目自动创建和管理证书。运行 mastra dev --https 时，会为 localhost（或你配置的 host）生成私钥和证书。更多信息参见 HTTPS 参考。
后续步骤后续步骤的直接链接
- 了解如何为生产环境部署 Studio。
- 添加身份验证，控制对已部署 Studio 的访问。
- 探索 Studio 可观测性，通过指标、traces 和日志监控 Agent 性能。