メインコンテンツへ移動

Mastra platform

Mastra platform は、Mastra フレームワークで構築した AI アプリケーションをデプロイ、監視、管理するための 3 つのプロダクトを提供します。

  • Observability: すべての platform プロジェクトの基盤となるプロダクトで、Mastra のプロジェクトとデプロイ全体からトレース、ログ、メトリクスを検索できます。
  • Studio: Agent のテストや Workflow の実行に使用でき、トレースを調査するためのツールも備えたホスト型のビジュアル環境です。Studio から始める場合も Observability が含まれます。
  • Server: Mastra アプリケーションを API サーバーとして実行する本番環境向けのデプロイターゲットです。Server から始める場合も Observability が含まれます。

単一のコマンド mastra deploy でデプロイするか、GitHub リポジトリを接続してプッシュ時にデプロイできます。リポジトリを接続するフローについては、GitHub 連携を参照してください。

各プロジェクトでは複数の環境productionstaging など)を実行できます。また、アプリケーションデータを永続化するために、CLI またはプロジェクト設定からホスト型データベースをプロビジョニングできます。さらに、環境ごとにマネージド Workspace が提供されるため、手動設定なしで Agent がファイルシステムと Sandbox を利用できます。

Trace Intelligence は、Agent のトレース全体から繰り返し現れる目標、結果、動作、感情を検出します。Trace Intelligence は、一部のプロジェクトを対象としたプライベートベータで利用できます。

はじめに
はじめにへの直接リンク

目的に合った方法を選択してください。

  • ホスト型 Observability を追加する: Observability を使用して、プロジェクトとデプロイ全体から検索可能なトレース、ログ、メトリクスを収集します。Studio または Server を先にデプロイせずに監視を始めたい場合は、ここから開始してください。
  • Studio をデプロイする: Studio を使用して、チーム向けのビジュアル開発環境をホストします。Agent のテスト、Workflow の実行、トレースの調査を行う共有 UI が必要な場合は、ここから開始してください。
  • Server をデプロイする: Server を使用して、Mastra アプリケーションを本番 API サーバーとして実行します。Agent、Tool、Workflow をクラウドから提供する準備ができたら、ここから開始してください。

主な概念
主な概念への直接リンク

プロジェクトは、すべてのプロダクトで共有される親エンティティです。1 つのプロジェクトに Observability、Studio、Server のすべてのプロダクトを含めることができます。プロジェクトは、チーム用のマルチテナントコンテナである組織に属します。

Mastra アプリケーションは、次の 3 つの構成要素から作られます。

  • Agent: Tool を使用し、指示に従い、コンテキストを維持できる AI Agent
  • Tool: Agent が利用できる呼び出し可能な関数と連携機能
  • Workflow: Agent と Tool を連携させる複数ステップのオーケストレーションパイプライン

本番環境への移行
本番環境への移行への直接リンク

プロジェクトを mastra dev でローカル開発し、Studio を開いて、ビジュアル環境で Agent、Workflow、Tool をテストします。

アプリケーションを本番環境にデプロイする準備ができたら、mastra deploy を実行してアプリケーションをクラウドにプッシュします。

詳しい手順については、デプロイドキュメントを参照してください。

Mastra アプリケーションを独自のインフラストラクチャでホストする場合でも、MastraPlatformExporter を使用して Observability データを Mastra platform に送信できます。