Mastra 平台

Mastra 平台为使用 Mastra 框架构建的 AI 应用提供了三类产品，用于部署、监控和管理：

- Observability：每个平台项目的基础产品，提供跨项目和跨部署的可搜索 traces、日志和指标 - Studio：托管的可视化环境，用于测试 agent 和运行 workflow，并附带检查 traces 的工具。使用 Studio 即自动包含 Observability - Server：生产环境部署目标，将你的 Mastra 应用作为 API server 运行。使用 Server 即自动包含 Observability

只需一条命令 `mastra deploy` 即可部署，或者连接 GitHub 仓库实现推送即部署。仓库关联的部署流程请参阅 GitHub integration 文档。

每个项目可以运行多个 Environment（例如 production 和 staging），并通过 CLI 或项目设置配置 Hosted 数据库来持久化应用数据。每个环境还自带一个托管 Workspace，为 agent 提供文件系统和沙箱，无需任何手动配置。

组织级别的 Alerts 会在部署失败或运行中的服务停止时通知你的团队。Alerts 可以覆盖所有项目或选定的项目和环境，通知可发送到 Slack、邮件或 webhook。

Connect 用于存储你在 Linear、Slack、GitHub 等平台上的账号，让 agent 可以直接将它们作为工具和聊天渠道使用，无需你创建第三方应用或管理 API 密钥。

Trace Intelligence 能在 agent traces 中发现反复出现的目标、结果、行为和情感倾向。该功能目前处于 private beta 阶段，面向部分项目开放。

开始使用

根据你想做的事情选择对应路径：

- 添加托管可观测性：使用 Observability 跨项目和部署收集可搜索的 traces、日志和指标。如果你只想先做监控、暂不部署 Studio 或 Server，从这里开始。 - 部署 Studio：使用 Studio 为你的团队托管可视化开发环境。如果你想要一个共享界面来测试 agent、运行 workflow 并检查 traces，从这里开始。 - 部署 Server：使用 Server 将你的 Mastra 应用作为生产环境 API server 运行。当你准备好从云端提供 agent、工具和 workflow 服务时，从这里开始。 - 构建软件工厂：将 Mastra Factory 部署到 Mastra 平台并连接你的仓库，把 issue 转化为计划、实现和经过评审的 pull request。

核心概念

Project 是所有产品共用的上层实体。一个项目可以包含全部三类产品：Observability、Studio 和 Server。Project 隶属于 Organization，后者是面向团队的.multi-tenant 容器。

你的 Mastra 应用由三个基本模块构成：

- Agents：可以使用工具、遵循指令并保持上下文的 AI agent - Tools：可供 agent 调用的函数和集成 - Workflows：协调 agent 和工具的多步骤编排管道

走向生产

在本地使用 `mastra dev` 开发项目，并打开 Studio 在可视化环境中测试你的 agent、workflow 和工具。

应用准备好上生产环境后，运行 `mastra deploy` 将其推送到云端。

具体操作步骤请参阅 Deploy 文档。

如果你在自己的基础设施上托管 Mastra 应用，仍然可以通过 MastraPlatformExporter 将可观测性数据发送到 Mastra 平台。