メインコンテンツへ移動

Mastra クイックスタート

create-mastra CLI は、Mastra プロジェクトを始めるための最も手軽な方法です。Workspace Tool、Memory、タスク追跡、Web アクセス、Schedule、Storage、Observability を備えた Agent Harness を作成します。

より細かく設定する場合は、手動インストールガイドを参照してください。既存のプロジェクトに Mastra を追加するには、mastra init を使用します。

📹 動画を見る

Mastra AI Agent コースでは、Mastra で Agent を構築する方法を順を追って学べます。

始める前に
始める前にへの直接リンク

OpenAI、Anthropic、Google Gemini、または xAI の API キーが必要です。セットアップ時の入力は省略でき、後から .env に追加できます。

プロジェクトを作成する
プロジェクトを作成するへの直接リンク

対話形式のセットアップを実行します。

npm create mastra@latest

このコマンドでは、プロジェクト名、モデル Provider、任意の API キーの入力を求められます。その後、依存関係とコーディングアシスタント向けの Mastra Skill がインストールされます。既存のリポジトリ内でなければ、最初の Git コミットも作成されます。

生成された src/mastra ディレクトリには、Mastra のエントリーポイント、Agent、Workspace Tool、および関連するコードが含まれています。Mastra の標準的な構成については、プロジェクト構造のリファレンスを参照してください。

ヒント

テンプレートから始めるには --template <template> を、Provider を含まない最小構成のプロジェクトを作成するには --empty を使用します。自動セットアップを省略するには、--no-skills または --no-git を使用します。すべてのフラグについては、create-mastra リファレンスを参照してください。

Agent をテストする
Agent をテストするへの直接リンク

ターミナルの指示に従ってプロジェクトディレクトリに移動し、開発サーバーを起動します。

npm run dev

localhost:4111 の Studio を開き、Agent を選択してメッセージを送信します。セットアップ時に Provider の API キーの入力を省略した場合は、.env.example に記載されている API キーを .env ファイルに追加してください。

Studio を使用すれば、別途 UI を作成することなく Agent を構築してテストできます。

次のステップ
次のステップへの直接リンク

On this page