Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Memecahkan masalah

Halaman ini menunjukkan cara menyelesaikan masalah terkait Model Armor.

Bagian ini berisi langkah-langkah pemecahan masalah yang mungkin berguna jika Anda mengalami masalah saat menggunakan Model Armor.

Semua panggilan API ke Model Armor menampilkan error 404 Not Found

Buat Private Service Connect ke Model Armor API. Error ini biasanya terjadi saat endpoint regional (REP) Model Armor diakses menggunakan Akses Google Pribadi atau tanpa Private Service Connect. Untuk mengetahui informasi selengkapnya, lihat Tentang mengakses endpoint regional melalui endpoint Private Service Connect.

Filter Sensitive Data Protection memberikan error atau dilewati

Pastikan hal berikut:

Template Sensitive Data Protection berada di region yang sama dengan endpoint Model Armor yang dipanggil.
Agen layanan yang membuat permintaan Model Armor memiliki peran dlp.User dan dlp.Reader dalam project yang berisi template Sensitive Data Protection.

Error ini terjadi karena error klien dalam permintaan SanitizeUserPrompt atau SanitizeModelResponse atau masalah pada template Sensitive Data Protection.

Error endpoint global Model Armor

Pastikan Anda membuat permintaan API ke endpoint regional yang sesuai, bukan endpoint global.

Model Armor hanya mendukung operasi berikut di endpoint regionalnya:

Operasi pembuatan, pembacaan, pembaruan, penghapusan, dan pencantuman pada template.
Permintaan API SanitizeUserPrompt dan SanitizeModelResponse.

Jika Anda membuat permintaan API untuk operasi tersebut ke endpoint global, Anda akan melihat error berikut:

{
  "error": {
    "code": 403,
    "message": "Write access to project '<PROJECT_ID>' was denied",
    "status": "PERMISSION_DENIED"
  }
}

Error sertifikat saat mengakses endpoint regional Model Armor

Error ini biasanya terjadi saat endpoint regional Model Armor diakses dari dalam jaringan VPC menggunakan Akses Google Pribadi atau Kontrol Layanan VPC, dan verifikasi sertifikat gagal.

Misalnya, Anda mungkin melihat pesan error yang mirip dengan berikut ini:

curl: (60) SSL: no alternative certificate subject name matches target host name 'modelarmor.europe-west4.rep.googleapis.com'

Untuk mengatasi masalah ini, buat endpoint Private Service Connect ke Model Armor API. Untuk mengetahui informasi selengkapnya, lihat Tentang mengakses endpoint regional melalui endpoint Private Service Connect.

Region tidak mendukung kemampuan yang diminta

Anda mungkin melihat pesan error yang mirip dengan yang berikut ini:

Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'

Error ini terjadi saat Anda mencoba membuat atau memperbarui template di region dengan batasan fitur, dan permintaan mengaktifkan fitur yang tidak didukung di region tersebut.

Untuk menyelesaikan masalah ini:

Identifikasi kemampuan yang tidak didukung yang tercantum dalam pesan error.
Tinjau ketersediaan fitur menurut wilayah untuk mengonfirmasi fitur mana yang tidak tersedia untuk wilayah target Anda.
Hapus fitur yang tidak didukung dari template yang Anda buat atau perbarui.

Atau, gunakan region Model Armor lain yang mendukung fitur tersebut, jika persyaratan residensi data Anda mengizinkan.

Kepatuhan residensi data template wajib diisi

Anda mungkin melihat pesan error 400 (FAILED_PRECONDITION) yang mirip dengan berikut:

Template data residency compliance is required. The 'Enforce data residency' field must not be set to false.

Error ini terjadi saat batasan Organization Policy Service terkelola Require Model Armor Template Data Residency Compliance (constraints/modelarmor.managed.requireTemplateDataResidencyCompliance) diterapkan dan Anda membuat atau memperbarui template Model Armor dengan kepatuhan residensi data dinonaktifkan. Kepatuhan residensi data dinonaktifkan saat Anda menetapkan data_residency_compliant ke false atau menghapus opsi Terapkan residensi data. Karena batasan ini diterapkan secara default, mengedit setelan apa pun, seperti filter, pada template yang sudah ada dan sudah menetapkan data_residency_compliant ke false juga akan memicu error ini. Template dan permintaan yang ada untuk membersihkan perintah dan respons tidak akan terpengaruh kecuali jika Anda mengupdate template.

Untuk menyelesaikan masalah ini, lakukan salah satu tindakan berikut:

Aktifkan kepatuhan residensi data pada template dengan menetapkan data_residency_compliant ke true atau dengan memilih opsi Enforce data residency.
Jika Anda perlu menonaktifkan kepatuhan residensi data untuk template, ikuti langkah-langkah di Menonaktifkan batasan kebijakan organisasi untuk residensi data agar Administrator Kebijakan Organisasi Anda menonaktifkan batasan tersebut.

Kontrol atau filter kebijakan dilewati untuk perintah atau payload besar

Saat menyaring perintah atau respons yang besar—seperti payload retrieval-augmented generation (RAG) atau histori percakapan agen multi-langkah—filter individual mungkin tidak berjalan, atau hasil sanitasi mungkin menampilkan EXECUTION_SKIPPED dengan salah satu pesan peringatan berikut di kolom messageItems:

Detection skipped as token limit exceeded.

Input size exceeded the limit of 4194304 bytes.

Masalah ini terjadi saat permintaan sanitasi unary atau permintaan streaming yang di-buffer melebihi batas sistem token filter (65.536 token untuk prompt injection dan deteksi jailbreak, Responsible AI, dan CSAM; 130.000 token untuk Sensitive Data Protection) atau batas ukuran input 4 MB. Jika input melebihi batas token filter dan tidak ada kecocokan yang terdeteksi, filter akan menampilkan EXECUTION_SKIPPED dan NO_MATCH_FOUND, yang memungkinkan permintaan dilanjutkan dalam integrasi inline.

Untuk memverifikasi apakah filter dilewati karena batas ukuran token atau input, buat kueri log SanitizeOperation Anda di Cloud Logging:

jsonPayload.@type="type.googleapis.com/google.cloud.modelarmor.logging.v1.SanitizeOperationLogEntry"
"EXECUTION_SKIPPED"