Menetapkan versi filter untuk template

Dokumen ini menjelaskan cara kerja versi filter Model Armor dan cara memberi tahu 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 perintah dalam perintah dan respons LLM. Untuk mengetahui informasi selengkapnya, lihat Filter Model Armor.

Versi filter Model Armor memberikan stabilitas untuk beban kerja 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 Anda. Alias mewakili tahap dalam siklus proses versi. Setiap alias ditetapkan ke versi yang sesuai seiring berjalannya siklus proses.

Jika Anda memilih alias, template akan menggunakan versi yang ditetapkan alias. Saat versi pokok 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 pembaruan yang sering dilakukan untuk mengatasi ancaman baru. Alias ini menawarkan tujuan tingkat layanan (SLO) standar, tetapi stabilitasnya dapat bervariasi di berbagai versi. Mode ini cocok untuk pengujian, penyiapan, 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 URL berbahaya dan Sensitive Data Protection.

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 sanitize. Anda harus memigrasikan semua template 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 hingga Stable): Saat mempromosikan versi Latest ke Stable (v2 menjadi Stable), kita melakukan hal berikut:
    1. Kita memindahkan versi Stable sebelumnya (v1) ke Legacy.
    2. Versi baru (v3) menjadi Latest baru. Kami mempromosikan versi setelah menjalani pengujian yang ketat, menunjukkan penggunaan harian yang konsisten, dan memiliki masalah pelanggan yang minimal, atau saat perlindungan dari ancaman kritis diperlukan.
  3. Penghentian (Legacy hingga 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, wilayah yang didukung, dan tanggal rilisnya.

Versi Alias Wilayah yang didukung Tanggal rilis
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

 30-01-2025
v2 Stable

eu

europe-west1

europe-west2

europe-west3

europe-west4

us-east1

 2025-06-19
v3 Latest

eu

europe-west1

europe-west2

europe-west3

europe-west4

europe-southwest1

europe-west9

us

us-central1

us-east1

us-east4

us-east7

us-west1

 2026-05-25

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, secara default menggunakan versi Stable.

  • Template dengan alias Latest atau Stable: Template ini 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.

  • 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 begitu, Anda tidak perlu melakukan update manual saat versi pokok berubah.
  • Dengan menggunakan nomor versi: Gunakan nomor versi seperti v1 untuk memastikan bahwa template disetel ke versi tertentu, sehingga memastikan perilaku yang tetap dan tidak berubah meskipun alias diperbarui.

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

Memperbarui versi filter template

Untuk memperbarui versi atau alias filter 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 sanitasi. Anda menerima peringatan penghentian penggunaan di respons API pembersihan 30 hari sebelum Google menghentikan penggunaan versi

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 sanitasi dan responsnya di Cloud Logging. Untuk mengetahui informasi selengkapnya tentang log audit yang dibuat secara otomatis, lihat Logging audit Model Armor.