Menetapkan versi filter untuk template

Dokumen ini menjelaskan cara kerja versi filter Model Armor dan cara menginstruksikan Model Armor untuk menggunakan versi filter atau alias versi filter tertentu dalam operasi.

Model Armor menggunakan filter untuk mendeteksi dan memblokir konten berbahaya, data sensitif, URL berbahaya, dan serangan injeksi prompt dalam prompt dan respons LLM. Untuk mengetahui informasi selengkapnya, lihat Filter Model Armor.

Versi filter Model Armor memberikan stabilitas untuk workload produksi dan akses ke model deteksi ancaman terbaru. Anda mengonfigurasi satu versi filter di tingkat template. Anda tidak dapat menentukan versi yang berbeda untuk setiap filter.

Alias versi

Dalam template Model Armor, Anda dapat menggunakan alias untuk menentukan versi filter pilihan. Alias mewakili tahap dalam siklus proses versi. Setiap alias ditetapkan ke versi yang sesuai saat siklus proses berlangsung.

Jika Anda memilih alias, template akan menggunakan versi yang ditetapkan ke alias tersebut. Saat versi yang mendasarinya untuk alias tersebut diupdate (misalnya, saat versi baru dipromosikan ke Stable), template yang menggunakan alias akan otomatis menggunakan versi baru. Jika Anda tidak ingin versi filter berubah, arahkan template ke versi filter tertentu.

Anda dapat memilih dari alias berikut:

  • Latest: Alias dengan model dan perlindungan terbaru, dengan update yang sering terhadap ancaman yang muncul. Alias ini menawarkan sasaran tingkat layanan (SLO) standar, tetapi stabilitasnya dapat bervariasi di seluruh versi. Alias ini cocok untuk pengujian, penahapan, dan workload yang memprioritaskan model deteksi terbaru daripada perilaku filter yang konsisten.
  • Stable: Alias default untuk versi dengan template yang tersedia. Alias ini memberikan logika deteksi yang andal dan tidak berubah, serta cocok untuk lingkungan produksi dan workload yang memerlukan perilaku filter yang tidak berubah. Saat versi baru menjadi Stable, versi Stable sebelumnya akan menjadi Legacy.
  • Legacy: Alias untuk versi Stable sebelumnya yang tetap tersedia selama 90 hari setelah versi Stable baru dirilis. Anda dapat memigrasikan sistem produksi ke versi Stable baru kapan saja selama periode ini. Anda tidak dapat membuat template baru menggunakan versi Legacy.
  • Retired: Alias untuk versi yang melampaui periode lama 90 hari dan tidak lagi tersedia. Model Armor menggunakan versi Stable untuk membersihkan panggilan ke template yang masih menggunakan versi Retired.

Filter yang tidak menggunakan versi filter

Setelan versi filter tidak memengaruhi filter Sensitive Data Protection dan URL berbahaya.

Siklus proses versi

Google Cloud memberikan notifikasi tentang perubahan siklus proses versi, termasuk saat versi menjadi Legacy dan tanggal penghentiannya yang akan datang di setiap respons API pembersihan. Anda harus memigrasikan template apa pun yang menggunakan versi Legacy ke Stable atau Latest dalam jangka waktu 90 hari.

Contoh berikut menjelaskan siklus proses versi:

  1. Rilis (Latest): Google merilis versi filter baru (v2) sebagai Latest.
  2. Promosi (Latest ke Stable): Saat kami mempromosikan versi Latest ke Stable (v2 menjadi Stable), kami melakukan hal berikut:
    1. Kami memindahkan versi Stable sebelumnya (v1) ke Legacy.
    2. Versi baru (v3) menjadi Latest baru. Kami mempromosikan versi setelah menjalani pengujian ketat, menunjukkan penggunaan harian yang konsisten, dan memiliki masalah pelanggan yang minimal, atau saat perlindungan ancaman penting menjadi diperlukan.
  3. Penghentian (Legacy ke Retired): Setelah versi filter tetap dalam status Legacy selama 90 hari, kami akan menghentikannya, dan versi tersebut tidak lagi tersedia.

Linimasa rilis versi

Tabel berikut membagikan detail tentang versi filter, termasuk alias, region yang didukung, dan tanggal rilisnya.

Versi Alias Region yang didukung
v1 Stable asia-northeast1

asia-northeast3

asia-south1

asia-southeast1

australia-southeast1

australia-southeast2

europe-southwest1

europe-west9

northamerica-northeast2

us

us-central1

us-east4

us-west1
v2 Stable

eu

europe-west1

europe-west2

europe-west3

europe-west4

us-east1
v3 Latest

asia-south1

asia-southeast1

eu

europe-west1

europe-west2

europe-west3

europe-west4

europe-southwest1

europe-west9

northamerica-northeast2

us

us-central1

us-east1

us-east4

us-east7

us-west1

Untuk mengetahui informasi tentang perubahan pada versi terbaru, lihat Histori versi.

Perilaku template

Perilaku template bergantung pada versi filter yang digunakan dan mengikuti karakteristik berikut:

  • Template tanpa versi: Template tanpa versi yang ditentukan, baik baru maupun yang sudah ada, akan ditetapkan secara default ke versi Stable.

  • Template dengan alias Latest atau Stable: Template ini akan otomatis menggunakan versi yang ditetapkan ke alias ini. Misalnya, saat versi filter baru menjadi versi Stable, template yang menggunakan alias Stable akan berpindah ke versi baru tanpa memerlukan perubahan template apa pun.

  • Template yang menggunakan versi tertentu:

    • Jika versi sesuai dengan versi Latest atau Stable, template akan berperilaku seperti yang diharapkan.
    • Jika versi sesuai dengan versi Legacy, template akan berperilaku seperti yang diharapkan saat digunakan untuk operasi pembersihan selama periode 90 hari. Setelah 90 hari, versi akan berpindah ke fase Retired. Selama fase ini, Anda harus memigrasikan template ke versi Latest atau Stable.

Mengonfigurasi versi filter

Anda dapat mengonfigurasi versi filter untuk template dengan salah satu dari dua cara berikut:

  • Dengan menggunakan alias: Gunakan alias dinamis seperti Stable atau Latest agar template otomatis menggunakan nomor versi yang sesuai dengan alias pilihan Anda. Dengan demikian, Anda tidak perlu melakukan update manual saat versi yang mendasarinya berubah.
  • Dengan menggunakan nomor versi: Gunakan nomor versi seperti v1 untuk memastikan template ditetapkan ke versi tertentu, sehingga memastikan perilaku yang tetap dan tidak berubah meskipun alias diupdate.

Membuat template menggunakan alias versi

Untuk membuat template menggunakan alias versi tertentu, jalankan perintah berikut:

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"

Ganti kode berikut:

  • FILTER_VERSION_ALIAS: alias versi filter pilihan Anda. Gunakan FILTER_VERSION_ALIAS_STABLE atau FILTER_VERSION_ALIAS_LATEST.
  • PROJECT_ID: ID project tempat template berada.
  • TEMPLATE_ID: ID template yang akan dibuat.
  • LOCATION: lokasi template.

Responsnya mirip dengan hal berikut ini:

{
  "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"
    }
  }
}

Membuat template menggunakan versi filter tertentu

Jika memerlukan imutabilitas filter, Anda dapat membuat template yang sesuai dengan versi tertentu. Untuk melakukannya, jalankan perintah berikut:

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"

Ganti kode berikut:

  • PROJECT_ID: ID project tempat template berada.
  • TEMPLATE_ID: ID template yang akan dibuat.
  • LOCATION: lokasi template.
  • FILTER_VERSION_NUMBER: nomor versi filter pilihan Anda (misalnya, v1).

Responsnya mirip dengan hal berikut ini:

{
  "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"
    }
  }
}

Mengupdate versi filter template

Untuk mengupdate versi filter atau alias untuk template yang ada, jalankan perintah berikut:

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"

Ganti kode berikut:

  • FILTER_VERSION_ALIAS: alias versi filter pilihan Anda. Gunakan FILTER_VERSION_ALIAS_STABLE atau FILTER_VERSION_ALIAS_LATEST.
  • PROJECT_ID: ID project tempat template berada.
  • TEMPLATE_ID: ID template yang akan dibuat.
  • LOCATION: lokasi template.

Responsnya mirip dengan hal berikut ini:

{
  "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"
    }
  }
}

Melihat versi filter yang digunakan dalam operasi pembersihan

Metadata respons Sanitize API mencakup informasi tentang versi filter yang digunakan selama pembersihan. Anda akan menerima peringatan penghentian dalam respons API pembersihan 30 hari sebelum Google menghentikan versi tersebut.

Contoh berikut menunjukkan respons API yang menyertakan versi filter:

"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": 5,
        "day": 1
      },
      "projectedDeprecationDate": {
        "year": 2026,
        "month": 5,
        "day": 1
      },
      "messageItems": [
        {
          "messageType": "WARNING",
          "message": "This filter version (v2) is in LEGACY state and will be
          RETIRED on 2026-05-01. Please migrate your template to the STABLE or
          LATEST version to ensure continued protection."
        }
      ]
   }
  },
}

Model Armor membuat log platform untuk permintaan pembersihan dan responsnya di Cloud Logging. Untuk mengetahui informasi selengkapnya tentang log audit yang dibuat otomatis, lihat Pencatatan log audit Model Armor.