Model Armor の使用を開始する

このページでは、Model Armor に必要な権限について詳しく説明し、Model Armor の有効化と無効化の手順を示します。

必要な権限

Model Armor へのアクセスは、IAM ロールを使用して制御します。次のロールにより、Model Armor の機能へのアクセス権を付与します。

ロール	権限
管理者とオーナー modelarmor.admin	resourcemanager.projects.get resourcemanager.projects.list modelarmor.templates.create modelarmor.templates.update modelarmor.templates.delete resourcemanager.projects.get resourcemanager.projects.list modelarmor.templates.useToSanitizeUserPrompt modelarmor.templates.useToSanitizeModelResponse resourcemanager.projects.get resourcemanager.projects.list modelarmor.templates.get modelarmor.templates.list
プロンプトとレスポンスのスクリーニングを計画しているユーザーとアプリケーション modelarmor.user	resourcemanager.projects.get resourcemanager.projects.list modelarmor.templates.useToSanitizeUserPrompt modelarmor.templates.useToSanitizeModelResponse
テンプレート ビューア（検出機能としきい値） modelarmor.viewer	resourcemanager.projects.get resourcemanager.projects.list modelarmor.templates.get modelarmor.templates.list
管理者とオーナー modelarmor.floorSettingsAdmin	resourcemanager.projects.get resourcemanager.projects.list resourcemanager.folders.get resourcemanager.folders.list resourcemanager.organizations.get modelarmor.floorSettings.get modelarmor.floorSettings.update
フロア設定の閲覧者 modelarmor.floorSettingsViewer	resourcemanager.projects.get resourcemanager.projects.list resourcemanager.folders.get resourcemanager.folders.list resourcemanager.organizations.get modelarmor.floorSettings.get

Model Armor を有効にする

Model Armor を使用するには、Model Armor API を有効にする必要があります。

コンソール

1. Google Cloud コンソールで、[Model Armor] ページに移動します。
2. [Enable Model Armor APIs] をクリックします。

gcloud

始める前に、Google Cloud CLI コマンドライン ツールで Model Armor API を使用して、次の処理を行います。

1. gcloud auth login コマンドを実行して Google Cloudアカウントを認証し、Google Cloud CLI ツールがユーザーに代わって Google Cloudサービスを操作できるようにします。

2. 次のコマンドを実行して、Google Cloud CLI ツールのデフォルトの Google Cloud プロジェクトを設定します。

   gcloud config set project PROJECT_ID

   PROJECT_ID は、実際のプロジェクトの ID に置き換えます。

3. 次のコマンドを実行して、Model Armor サービスの API エンドポイントを設定します。

   gcloud config set api_endpoint_overrides/modelarmor "https://modelarmor.LOCATION.rep.googleapis.com/"

   LOCATION は、Model Armor を使用するリージョンに置き換えます。

Model Armor を有効にする

次のコマンドを実行して、Model Armor を有効にします。

  gcloud services enable modelarmor.googleapis.com --project=PROJECT_ID
   

PROJECT_ID は、プロジェクトの ID に置き換えます。

Model Armor を無効にする

次のコマンドを実行して、Model Armor を無効にします。

  gcloud services disable modelarmor.googleapis.com --project=PROJECT_ID
   

PROJECT_ID は、プロジェクトの ID に置き換えます。

Python で Model Armor クライアントを初期化する

次のコマンドを実行して、Model Armor API とのやり取りを行うクライアントを初期化します。

• modelarmor.LOCATION.rep.googleapis.com エンドポイントの場合:

  from google.cloud import modelarmor_v1
  client = modelarmor_v1.ModelArmorClient(transport="rest", client_options = {"api_endpoint" : "modelarmor.LOCATION.rep.googleapis.com"})

• modelarmor.googleapis.com エンドポイントの場合:

  from google.cloud import modelarmor_v1
  client = modelarmor_v1.ModelArmorClient(transport="rest", client_options = {"api_endpoint" : "modelarmor.googleapis.com"})

次のステップ

• Model Armor テンプレートについて確認する。
• Model Armor のフロア設定について確認する。
• プロンプトとレスポンスをサニタイズする。
• Model Armor に関する問題のトラブルシューティングを行う。