Model Garden でモデルの機能をテストする

Model Garden には、モデルの機能をすばやく表示してテストするためのオプションがいくつか用意されています。サポートされているモデルでは、デモ プレイグラウンドを試したり、Model Garden Spaces というデモ アプリケーションを起動して、モデルの機能を他のユーザーに紹介したりできます。

プレイグラウンドは、あらかじめデプロイされた Gemini Enterprise Agent Platform オンライン予測エンドポイントによって動作し、料金は発生しません。サポートされているモデルのモデルカードを開くと、[試す] パネルを使用して、テキスト プロンプトを送信してモデルの機能をすばやくテストできます。temperature（温度）や出力トークン数など、よく使用されるパラメータの一部を設定することもできます。プレイグラウンドは、テキストの入力と出力のみに制限されています。

Spaces を起動すると、すぐにウェブ アプリケーションを利用できるようになるため、モデルをデプロイして、そのモデルのエンドポイントを使用するアプリを構築する場合に比べて、必要な手作業を大幅に削減できます。Model Garden は、選択したモデルを Gemini Enterprise Agent Platform にデプロイし、デプロイされたモデルのエンドポイントを使用するサンプルアプリを Cloud Run インスタンスにデプロイします。アプリケーションで既存のエンドポイントや MaaS エンドポイントを使用することもできます。

始める前に

このチュートリアルでは、 Google Cloud プロジェクトを設定し、Agent Platform API を有効にする必要があります。

Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform, Artifact Registry, Cloud Build, Cloud Logging, and Cloud Run Admin APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform, Artifact Registry, Cloud Build, Cloud Logging, and Cloud Run Admin APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Model Garden Space を試す場合は、Compute Engine のデフォルトのサービス アカウントに Space を起動するために必要な権限があることを確認します。

必要なロール

Model Garden でモデルの機能をテストするには、ユーザーと Compute Engine のデフォルト サービス アカウントの両方に必要な IAM ロールがあることを確認してください。

ユーザーに必要なロール

Model Garden でモデルの機能をテストするために必要な権限を取得するには、 Google Cloud プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

• Service Usage 管理者（roles/serviceusage.serviceUsageAdmin）
• Artifact Registry 管理者（roles/artifactregistry.admin）
• Cloud Run 管理者 （roles/run.admin）
• ストレージ管理者（roles/storage.admin）
• Agent Platform ユーザー （roles/aiplatform.user）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Compute Engine のデフォルト サービス アカウントに必要なロール

Compute Engine のデフォルトのサービス アカウントは、Space の起動に使用されます。

Compute Engine のデフォルト サービス アカウントに Space を起動するために必要な権限があることを確認するには、 Google Cloud プロジェクトに対する次の IAM ロールを Compute Engine のデフォルト サービス アカウントに付与するよう管理者に依頼してください。

重要: これらのロールは、ユーザー アカウントではなく、Compute Engine のデフォルトのサービス アカウントに付与する必要があります。正しいプリンシパルにロールを付与しないと、権限エラーが発生する可能性があります。

• Agent Platform サービス エージェント （roles/aiplatform.serviceAgent）
• Cloud Build サービス アカウント （roles/cloudbuild.builds.builder）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

管理者は、カスタムロールや他の事前定義ロールを使用して、Compute Engine のデフォルト サービス アカウントに必要な権限を付与することもできます。

プレイグラウンドを試す

1. Google Cloud コンソールで、サポートされているモデルのモデルカード（Gemma 2 モデルカードなど）に移動します。

   Gemma 2 に移動

2. [試す] パネルで次の操作を行います。

   1. [リージョン] で、デフォルトをそのまま使用するか、リージョンを選択します。
   2. [エンドポイント] で [デモ プレイグラウンド] を選択します。
   3. [プロンプト] ボックスに「Why is the sky blue?」と入力します。
   4. [詳細オプション] セクションを開き、デフォルトのパラメータを確認します。

   

3. [送信] をクリックします。出力は [送信] ボタンの下に表示されます。

Spaces を試す

注: スペースは、組織の親を持たないプロジェクトでのみ使用できます。組織なしでプロジェクトを作成する方法については、プロジェクトを作成するをご覧ください。

モデルを起動するには、サポートされているモデルのモデルカードを開き、[Try out Spaces] パネルで Spaces をクリックして起動します。デプロイに使用されるマシンと、アプリをホストする Cloud Run インスタンスに対して課金されます。

Gemini、Gemma、Llama、Stable Diffusion などのモデルを使用して Spaces を起動できます。

Spaces を起動する

Spaces を起動して、Gradio サンプル アプリケーションからモデルを試してテストします。

1. Google Cloud コンソールで、Model Garden に移動してモデルのモデルカードを表示します。

   Model Garden に移動

2. 使用するモデルを選択します。サポートされているモデル（Gemma 3 モデルカードなど）には [スペースを試す] パネルがあります。

   Gemma 3 に移動

3. rocket_launch [実行] をクリックして Spaces を起動します。

   1. [認証が必要]（Identity-Aware Proxy 経由）または [一般公開アクセスを許可] を選択できます。詳細については、最初のデプロイで API を有効にして権限を付与するをご覧ください。
   重要: アプリを使用する際は、プロンプトに機密情報や個人を特定できる情報を含めないでください。
   1. [新しいサービスを作成] をクリックして、デプロイを開始します。デプロイのステータスは、モデルカードでモニタリングできます。

4. Spaces のステータスが [準備完了] に変わったら、クリックしてデプロイの詳細を表示します。

   基本的な保護のために、ウェブ アプリケーションには秘密鍵が必要で、プロンプトを送信するときに URL に追加する必要があります。この秘密鍵は、[秘密鍵] フィールドに表示されます。

   1. [開く] をクリックして、アプリの使用を開始します。アプリ内からモデルにプロンプトを送信し、その回答を表示できます。

   URL を共有して、他のユーザーもアプリを試せるようにすることができます。

   1. アプリへのアクセスを閉じるには、[アクセス制御] フィールドで [編集] をクリックします。

   Cloud Run アプリケーションの [セキュリティ] タブで、[認証が必要] を選択し、[保存] をクリックします。これで、このアプリケーションは URL からアクセスできなくなります。URL にアクセスすると 403 エラー（Forbidden）が発生します。

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、次の操作を行います。

Spaces を削除する

Spaces をクリーンアップするには、モデルのリソースと Cloud Run 上のサンプル アプリケーションのリソースの両方を削除する必要があります。

モデルリソースを削除する

Gradio アプリ内からモデル エンドポイントを削除して、Gemini Enterprise Agent Platform リソースをクリーンアップできます。その後、Cloud Run サービスを削除して、Gradio アプリを停止して削除する必要があります。

Gemini Enterprise Agent Platform リソースを手動で削除するには、モデルのデプロイを解除してリソースを削除するをご覧ください。

Cloud Run サービスを削除する

サービスのすべてのリビジョンなど、サービスに関連するリソースを削除します。サービスを削除しても、Artifact Registry のコンテナ イメージなどのアイテムは削除されません。詳細については、Cloud Run ドキュメントのサービスを管理するをご覧ください。

1. Google Cloud コンソールで、Cloud Run サービスのリストを表示します。

   Cloud Run に移動

2. 削除するサービスを見つけて選択します。

3. delete [削除] をクリックします。これにより、サービスのすべてのリビジョンが削除されます。

プロジェクトを削除する

課金されないようにする最も簡単な方法は、チュートリアル用に作成したプロジェクトを削除することです。

プロジェクトを削除するには:

注意: プロジェクトを削除すると、次のような影響があります。

• プロジェクト内のすべてのものが削除されます。既存のプロジェクトを使用してこのドキュメントのタスクを行った場合、そのプロジェクトを削除すると、プロジェクト内で行った他の作業もすべて削除されます。
• カスタム プロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタム プロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（例: appspot.com）を保持するには、プロジェクト全体ではなく、プロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

1. Google Cloud コンソールで [リソースの管理] ページに移動します。

   [リソースの管理] に移動

2. プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
3. ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

次のステップ

Model Garden の概要をご覧ください。