Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

フィルタバージョンを設定する

このドキュメントでは、Model Armor フィルタのバージョンの仕組みと、オペレーションで特定のフィルタバージョンまたはフィルタバージョンエイリアスを使用するように Model Armor に指示する方法について説明します。

Model Armor は、フィルタを使用して、LLM のプロンプトとレスポンス内の有害なコンテンツ、センシティブデータ、悪意のある URL、プロンプトインジェクション攻撃を検出してブロックします。詳細については、Model Armor フィルタをご覧ください。

Model Armor フィルタバージョンは、本番環境のワークロードの安定性と、最新の脅威検出モデルへのアクセスを提供します。テンプレートレベルで 1 つのフィルタバージョンを構成します。個々のフィルタに異なるバージョンを指定することはできません。

バージョンのエイリアス

Model Armor テンプレートでは、エイリアスを使用して優先するフィルタバージョンを指定できます。エイリアスは、バージョンのライフサイクルのステージを表します。各エイリアスは、ライフサイクルの進行に合わせて適切なバージョンに設定されます。

エイリアスを選択すると、テンプレートではエイリアスが設定されているバージョンが使用されます。そのエイリアスの基盤となるバージョンが更新されると（たとえば、新しいバージョンが Stable に昇格されると）、エイリアスを使用するテンプレートは自動的に新しいバージョンを使用します。フィルタバージョンを変更しない場合は、テンプレートを特定のフィルタバージョンに指定します。

次のエイリアスから選択できます。

Latest: 最新のモデルと保護機能を含むエイリアス。新しい脅威に対して頻繁に更新されます。このエイリアスは標準のサービスレベル目標（SLO）を提供しますが、安定性はバージョンによって異なる場合があります。テスト、ステージング、一貫したフィルタ動作よりも最新の検出モデルを優先するワークロードに適しています。
Stable: 使用可能なテンプレートを含むバージョンのデフォルトエイリアス。このエイリアスは、信頼性が高く、変更されない検出ロジックを提供します。変更されないフィルタ動作を必要とする本番環境とワークロードに適しています。新しいバージョンが Stable になると、以前の Stable バージョンは Legacy になります。
Legacy: 新しい Stable バージョンのリリース後 90 日間利用可能な、以前の Stable バージョンのエイリアス。この期間中は、いつでも本番環境システムを新しい Stable バージョンに移行できます。Legacy バージョンを使用して新しいテンプレートを作成することはできません。
Retired: 90 日間のレガシー期間を超過し、使用できなくなったバージョンのエイリアス。Model Armor は、Stable バージョンを使用して、Retired バージョンをまだ使用しているテンプレートへの呼び出しをサニタイズします。

フィルタバージョンを使用しないフィルタ

フィルタバージョンの設定は、Sensitive Data Protection フィルタと悪意のある URL フィルタには影響しません。

バージョンのライフサイクル

Google Cloud は、バージョンが Legacy になったときや、今後の廃止日など、バージョンのライフサイクルの変更に関する通知をすべてのサニタイズ API レスポンスで提供します。Legacy バージョンを使用するテンプレートは、90 日以内に Stable または Latest に移行する必要があります。

次の例では、バージョンのライフサイクルについて説明します。

リリース（Latest）: Google は、新しいフィルタバージョン（v2）を Latest としてリリースします。
プロモーション（Latest から Stable）: Google が Latest バージョンを Stable にプロモーションすると（v2 が Stable になる）、次のようになります。
1. Google は以前の Stable バージョン（v1）を Legacy に移動します。
2. 新しいバージョン（v3）が新しい Latest になります。Google は、厳格なテストを経て、日常的な使用が安定しており、お客様の問題が最小限に抑えられているバージョン、または重大な脅威からの保護が必要になったバージョンをリリースします。
廃止（Legacy から Retired）: フィルタバージョンが 90 日間 Legacy 状態のままであると、Google はそのバージョンを廃止し、使用できなくなります。

バージョンのリリーススケジュール

次の表に、エイリアス、リリース日、サポート終了日、サポートされているリージョンなど、フィルタバージョンの詳細を示します。

バージョン	エイリアス	リリース日	廃止日	サポート対象の地域
`v1`	`Legacy` （`asia-northeast3` の `Stable`。`australia-southeast2` の 2026 年 9 月 25 日以降の `Legacy`）	2025-01-30	2026-12-17	`asia-northeast1` `asia-northeast3`（`Stable`） `asia-south1` `asia-southeast1` `australia-southeast2`（`Legacy` は 2026 年 9 月 25 日から） `europe-southwest1` `europe-west9` `northamerica-northeast2` `us` `us-central1` `us-east4` `us-west1`
`v2`	`Legacy`	2025-06-19	2026-12-17	`eu` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `us-east1`
`v3`	`Stable` （`australia-southeast2` の 2026 年 9 月 25 日以降の `Stable`）	2026-05-25	—	`asia-northeast1` `asia-south1` `asia-southeast1` `australia-southeast2`（`Stable` は 2026 年 9 月 25 日から） `eu` `europe-southwest1` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `europe-west9` `northamerica-northeast2` `us` `us-central1` `us-east1` `us-east4` `us-west1`
`v4`	`Latest`	2026-09-18	—	`asia-northeast1` `asia-south1` `asia-southeast1` `eu` `europe-southwest1` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `europe-west9` `northamerica-northeast2` `us` `us-central1` `us-east1` `us-east4` `us-west1`

各バージョンで変更された内容については、フィルタの変更履歴をご覧ください。

テンプレートの動作

テンプレートの動作は、使用されるフィルタバージョンによって異なり、次の特性があります。

バージョンなしのテンプレート: バージョンが指定されていないテンプレート（新規または既存）は、デフォルトで Stable バージョンになります。
Latest または Stable エイリアスを含むテンプレート: これらのテンプレートは、これらのエイリアスに割り当てられたバージョンを自動的に使用します。たとえば、新しいフィルタバージョンが Stable バージョンになると、Stable エイリアスを使用するテンプレートは、テンプレートの変更を必要とせずに新しいバージョンに移行します。

注: テンプレートのフィルタバージョンを Legacy または Retired に設定することはできません。
特定のバージョンを使用するテンプレート:
- バージョンが Latest バージョンまたは Stable バージョンに対応している場合、テンプレートは想定どおりに動作します。
- バージョンが Legacy バージョンに対応している場合、90 日間のサニタイズオペレーションに使用すると、テンプレートは想定どおりに動作します。90 日が経過すると、バージョンは Retired フェーズに移行します。このフェーズでは、テンプレートを Latest バージョンまたは Stable バージョンに移行する必要があります。

フロア設定のデフォルトのフィルタバージョンをオーバーライドする

フロア設定では、デフォルトで Stable フィルタバージョンが使用されます。Gemini Enterprise Agent Platform の統合の場合、この設定をオーバーライドする場合は、Gemini モデルへの generateContent 呼び出しでテンプレートを指定します。これを行うには、Gemini リクエストを送信する予定のリージョンと同じリージョンに、特定のフィルタバージョンまたはエイリアスを含むテンプレートを作成します。

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d "$TEMPLATE_CONFIG" \
  "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

次のように置き換えます。

FILTER_VERSION_ALIAS: 目的のフィルタバージョンのエイリアス。FILTER_VERSION_ALIAS_STABLE または FILTER_VERSION_ALIAS_LATEST を使用します。
PROJECT_ID: テンプレートが属するプロジェクトの ID。
TEMPLATE_ID: 作成するテンプレートの ID。
LOCATION: Model Armor テンプレートを保存するリージョン。このリージョンは、Gemini リクエストを送信する予定のリージョンと同じにする必要があります。そうしないと、Agent Platform で Template not found エラーが発生します。この統合でサポートされているリージョンの一覧については、Gemini Enterprise Agent Platform との統合をご覧ください。

Gemini 呼び出しの model_armor_config オブジェクトでテンプレート ID を指定します。テンプレートで指定されたフィルタ構成が、プロジェクトレベルのフロア設定の代わりに適用されます。

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/gemini-2.5-flash:generateContent" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Your prompt here"
        }
      ]
    }
  ],
  "model_armor_config": {
    "prompt_template_name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
    "response_template_name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID"
  }
}'

次のように置き換えます。

PROJECT_ID: Google Cloud プロジェクト ID。
REGION: Gemini エンドポイントのGoogle Cloud リージョン。
LOCATION: Model Armor テンプレートが保存されているリージョン。これは、REGION に指定されたリージョンと同じにする必要があります。
TEMPLATE_ID: Model Armor テンプレート ID。

テンプレートのフィルタバージョンを構成する

テンプレートのフィルタバージョンは、次のいずれかの方法で構成できます。

エイリアスを使用する: Stable や Latest などの動的エイリアスを使用すると、テンプレートで優先エイリアスに対応するバージョン番号が自動的に使用されます。これにより、基盤となるバージョンが変更されたときに手動で更新する必要がなくなります。
バージョン番号を使用する: v1 などのバージョン番号を使用して、テンプレートが指定されたバージョンに設定されていることを確認します。これにより、エイリアスが更新されても、動作が固定され、変更されません。

バージョンエイリアスを使用してテンプレートを作成する

特定のバージョンエイリアスを使用してテンプレートを作成するには、次のコマンドを実行します。

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

次のように置き換えます。

FILTER_VERSION_ALIAS: 目的のフィルタバージョンのエイリアス。FILTER_VERSION_ALIAS_STABLE または FILTER_VERSION_ALIAS_LATEST を使用します。
PROJECT_ID: テンプレートが属するプロジェクトの ID。
TEMPLATE_ID: 作成するテンプレートの ID。
LOCATION: テンプレートのロケーション。

レスポンスは次の例のようになります。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T17:57:46.976854398Z",
  "updateTime": "2026-04-05T17:57:46.976854398Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}

特定のフィルタバージョンを使用してテンプレートを作成する

フィルタの不変性が必要な場合は、特定のバージョンに対応するテンプレートを作成できます。これを行うには、次のコマンドを実行します。

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "version": "FILTER_VERSION_NUMBER"
    }
  }
}'

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

次のように置き換えます。

PROJECT_ID: テンプレートが属するプロジェクトの ID。
TEMPLATE_ID: 作成するテンプレートの ID。
LOCATION: テンプレートのロケーション。
FILTER_VERSION_NUMBER: 優先するフィルタバージョン番号（例: v1）。

レスポンスは次の例のようになります。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T18:03:29.134974974Z",
  "updateTime": "2026-04-05T18:03:29.134974974Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "version": "FILTER_VERSION_NUMBER"
    }
  }
}

テンプレートのフィルタバージョンを更新する

既存のテンプレートのフィルタバージョンまたはエイリアスを更新するには、次のコマンドを実行します。

export TEMPLATE_CONFIG='{
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID?updateMask=templateMetadata.filterVersionSelector"

次のように置き換えます。

FILTER_VERSION_ALIAS: 目的のフィルタバージョンのエイリアス。FILTER_VERSION_ALIAS_STABLE または FILTER_VERSION_ALIAS_LATEST を使用します。
PROJECT_ID: テンプレートが属するプロジェクトの ID。
TEMPLATE_ID: 作成するテンプレートの ID。
LOCATION: テンプレートのロケーション。

レスポンスは次の例のようになります。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T18:03:29.134974974Z",
  "updateTime": "2026-04-05T18:04:07.711205953Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}

サニタイズオペレーションで使用されるフィルタバージョンを表示する

Sanitize API のレスポンスメタデータには、サニタイズ中に使用されたフィルタバージョンに関する情報が含まれます。Google がバージョンを廃止する 30 日前に、サニタイズ API レスポンスで非推奨の警告が表示されます。

次の例は、フィルタバージョンを含む API レスポンスを示しています。

"sanitizationResult": {
    "filterMatchState": "NO_MATCH_FOUND",
    "invocationResult": "SUCCESS",
    "filterResults": {
      "csam": {
        "csamFilterFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "malicious_uris": {
        "maliciousUriFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "rai": {
        "raiFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND",
          "raiFilterTypeResults": {
            "sexually_explicit": {
              "matchState": "NO_MATCH_FOUND"
            },
            "hate_speech": {
              "matchState": "NO_MATCH_FOUND"
            },
            "harassment": {
              "matchState": "NO_MATCH_FOUND"
            }
          }
        }
      },
      "pi_and_jailbreak": {
        "piAndJailbreakFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "sdp": {
        "sdpFilterResult": {
          "inspectResult": {
            "executionState": "EXECUTION_SUCCESS",
            "matchState": "NO_MATCH_FOUND"
          }
        }
      }
    },
  "sanitizationMetadata": {
    "filterVersionConfig": {
      "filterVersion": "v2",
      "filterVersionAlias": "FILTER_VERSION_ALIAS_LEGACY",
      "releaseDate": {
        "year": 2025,
        "month": 6,
        "day": 19
      },
      "projectedDeprecationDate": {
        "year": 2026,
        "month": 12,
        "day": 17
      },
      "messageItems": [
        {
          "messageType": "WARNING",
          "message": "This filter version (v2) is in LEGACY state and will be
          RETIRED on 2026-12-17. Please migrate your template to the STABLE or
          LATEST version to ensure continued protection."
        }
      ]
   }
  },
}

Model Armor は、サニタイズリクエストとそのレスポンスのプラットフォームログを Cloud Logging に生成します。自動生成された監査ログの詳細については、Model Armor の監査ロギングをご覧ください。

フィルタ バージョンを設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

バージョンのエイリアス

フィルタ バージョンを使用しないフィルタ

バージョンのライフサイクル

バージョンのリリース スケジュール

テンプレートの動作

フロア設定のデフォルトのフィルタ バージョンをオーバーライドする

テンプレートのフィルタ バージョンを構成する

バージョン エイリアスを使用してテンプレートを作成する

特定のフィルタ バージョンを使用してテンプレートを作成する

テンプレートのフィルタ バージョンを更新する

サニタイズ オペレーションで使用されるフィルタ バージョンを表示する

フィルタバージョンを設定する

フィルタバージョンを使用しないフィルタ

バージョンのリリーススケジュール

フロア設定のデフォルトのフィルタバージョンをオーバーライドする

テンプレートのフィルタバージョンを構成する

バージョンエイリアスを使用してテンプレートを作成する

特定のフィルタバージョンを使用してテンプレートを作成する

テンプレートのフィルタバージョンを更新する

サニタイズオペレーションで使用されるフィルタバージョンを表示する