Mastra platform

Mastra platform 提供三个产品，用于部署、监控和管理使用 Mastra 框架构建的 AI 应用：

• Observability：每个平台项目的基线产品，提供跨 Mastra 项目和部署的可搜索 traces、logs 和 metrics
• Studio：用于测试 agents 和运行 workflows 的托管可视化环境，附带检查 traces 的工具。从 Studio 开始也会获得 Observability。
• Server：生产部署目标，将你的 Mastra 应用作为 API 服务器运行。从 Server 开始也会获得 Observability。

使用单条命令 mastra deploy 部署，或连接 GitHub 仓库实现推送即部署。仓库关联流程请参阅 GitHub 集成。

每个项目可以运行多个 Environments（例如 production 和 staging），并可通过 CLI 或项目设置配置 托管数据库以持久化应用数据。每个环境还会获得一个托管的 Workspace，无需手动配置即可为 agents 提供文件系统和 sandbox。

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

Connect 存储你在 Linear、Slack、GitHub 等提供器上的账户，使 agents 可以将它们用作工具和聊天渠道，而无需你创建供应商应用或管理 API 密钥。

Trace Intelligence 可在 agent traces 中发现反复出现的目标、结果、行为和情绪。Trace Intelligence 目前以私有 beta 形式提供给选定项目。

开始使用

选择与你的目标匹配的路径：

• 添加托管 observability：使用 Observability 跨项目和部署收集可搜索的 traces、logs 和 metrics。如果你希望先监控而不部署 Studio 或 Server，请从这里开始。
• 部署 Studio：使用 Studio 为团队托管可视化开发环境。如果你希望有一个共享 UI 来测试 agents、运行 workflows 并检查 traces，请从这里开始。
• 部署 Server：使用 Server 将你的 Mastra 应用作为生产 API 服务器运行。当你准备从云端提供 agents、工具和 workflows 时，请从这里开始。
• **构建软件工厂：**将 Mastra Factory 部署到 Mastra platform 并连接你的仓库，将 issues 转化为计划、实现和经过审查的 pull requests。

核心概念

Projects 是所有产品共享的父实体。单个项目可以包含所有产品：Observability、Studio 和 Server。Projects 属于一个 Organization，即你团队的多租户容器。

你的 Mastra 应用由三个构建块组成：

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

走向生产

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

准备好将应用部署到生产后，运行 mastra deploy 将应用推送到云端。

按照部署文档获取分步说明。

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