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

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

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

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

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

フィルタバージョンとエイリアスを構成するタイミング

一般的なユースケースは次のとおりです。

決定論的なフィルタリング動作をロックする: ミッションクリティカルなシステムで脅威検出ロジックが変更されないように、テンプレートを特定のフィルタバージョンに設定します。
自動セキュリティアップデートを受け取る: Stable エイリアスを使用して、検証に合格した更新済みの脅威検出モデルを自動的に採用します。
今後の検出機能をテストする: Latest エイリアスを本番前環境で使用して、実際のトラフィックパターンに対して新しいフィルタルールを評価します。
予測可能なロールアウトサイクルを有効にする: 本番環境テンプレートを手動で更新する前に、新しくリリースされたフィルタバージョンに対してワークロードを検証します。

バージョンのエイリアス

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

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

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

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

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

フィルタバージョンの設定は、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`（2026 年 9 月 25 日から `Legacy`） `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` （では 2026 年 9 月 25 日から `Stableaustralia-southeast2`）	2026-05-25	—	`asia-northeast1` `asia-south1` `asia-southeast1` `australia-southeast2`（2026 年 9 月 25 日から `Stable`） `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 バージョンに移行する必要があります。

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

フロア設定では、 Gemini Enterprise Agent Platform 統合はデフォルトでStable フィルタバージョンを使用します。この設定をオーバーライドするには、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 の監査ロギングをご覧ください。

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

フィルタ バージョンとエイリアスを構成するタイミング

バージョンのエイリアス

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

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

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

テンプレートの動作

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

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

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

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

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

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

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

フィルタバージョンとエイリアスを構成するタイミング

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

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

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

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

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

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

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

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