Dokumen ini menjelaskan cara mengaktifkan Model Armor untuk Gemini Notebook Enterprise. Model Armor adalah layanan yang meningkatkan keamanan dan keselamatan aplikasi AI Anda dengan secara proaktif menyaring perintah dan respons yang diberikan menggunakan Gemini Notebook Enterprise. Google Cloud Hal ini membantu melindungi dari berbagai risiko dan memastikan praktik AI yang bertanggung jawab. Model Armor didukung di Gemini Notebook Enterprise tanpa biaya tambahan.
Respons Model Armor terhadap potensi masalah dalam kueri pengguna atau respons dari Gemini Notebook Enterprise diatur oleh jenis penegakan template.
Jika jenis penegakan adalah Periksa dan blokir, Gemini Notebook Enterprise akan memblokir permintaan dan menampilkan pesan error. Ini adalah jenis penerapan default saat Anda membuat template Model Armor menggunakan konsol.
Jika jenis penegakan adalah Periksa saja, Gemini Notebook Enterprise tidak memblokir permintaan atau respons.
Untuk mengetahui informasi selengkapnya, lihat Menentukan jenis penerapan.
Sebelum memulai
Pastikan Anda memiliki peran yang diperlukan yang ditetapkan kepada Anda dan akun layanan:
Untuk mengaktifkan Model Armor di Gemini Notebook Enterprise, Anda memerlukan peran Admin Gemini Enterprise (
roles/discoveryengine.agentspaceAdmin).Untuk membuat template Model Armor, Anda memerlukan peran Admin Model Armor (
roles/modelarmor.admin).Untuk memanggil API Model Armor, Anda memerlukan peran Pengguna Model Armor (
roles/modelarmor.user).Jika template Model Armor Anda berada dalam project yang berbeda dengan notebook Anda di Gemini Notebook Enterprise, project template harus memberikan peran Pengguna Model Armor (
roles/modelarmor.user) ke akun layanan notebook. ID akun layanan adalahservice-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com, denganPROJECT_NUMBERadalah nomor project instance Gemini Notebook Enterprise Anda.
Membuat template Model Armor
Anda dapat membuat dan menggunakan template Model Armor yang sama untuk perintah pengguna dan respons dari asisten, atau Anda dapat membuat dua template Model Armor terpisah. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola template Model Armor.
Saat membuat template Model Armor untuk Gemini Notebook Enterprise, pertimbangkan konfigurasi berikut:
Anda dapat membuat template Model Armor secara terpusat dalam satu project dan menggunakannya kembali di berbagai project. Jika Anda menggunakan template lintas project, pastikan izin lintas project dikonfigurasi seperti yang dijelaskan dalam Sebelum Anda memulai.
Pilih Multi-region di kolom Regions. Tabel berikut menunjukkan cara memetakan region template Model Armor ke region Gemini Notebook Enterprise:
Multi-region Gemini Notebook Enterprise Multi-region Model Armor Global - US (beberapa wilayah di Amerika Serikat)
- EU (beberapa wilayah di Uni Eropa)
US (beberapa wilayah di Amerika Serikat) US (beberapa wilayah di Amerika Serikat) EU (beberapa wilayah di Uni Eropa) EU (beberapa wilayah di Uni Eropa) Google tidak merekomendasikan konfigurasi Cloud Logging di template Model Armor untuk Gemini Notebook Enterprise. Konfigurasi ini dapat mengekspos data sensitif kepada pengguna dengan peran IAM Private Logs Viewer (
roles/logging.privateLogViewer). Sebagai gantinya, pertimbangkan opsi berikut:Jika perlu mencatat data yang melewati template Model Armor, Anda dapat mengalihkan log ke penyimpanan yang aman seperti BigQuery, yang menawarkan kontrol akses yang lebih ketat. Untuk mengetahui informasi selengkapnya, lihat Merutekan log ke tujuan yang didukung.
Anda dapat mengonfigurasi log audit Akses Data untuk menganalisis dan melaporkan hasil penyaringan permintaan dan respons yang dihasilkan oleh Model Armor. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi log audit.
Mengonfigurasi Gemini Notebook Enterprise dengan template Model Armor
Langkah-langkah berikut menjelaskan cara menambahkan template Model Armor ke Gemini Notebook Enterprise.
REST
Untuk menambahkan template Model Armor ke Gemini Notebook Enterprise, jalankan perintah berikut :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER?update_mask=customerProvidedConfig" \
-d '{
"customerProvidedConfig": {
"notebooklmConfig": {
"modelArmorConfig": {
"userPromptTemplate": "QUERY_PROMPT_TEMPLATE",
"responseTemplate": "RESPONSE_PROMPT_TEMPLATE"
}
}
}
}'
Ganti kode berikut:
PROJECT_ID: ID project Anda.PROJECT_NUMBER: jumlah project Google Cloud Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
QUERY_PROMPT_TEMPLATE: Nama resource template Model Armor yang Anda buat.Untuk mendapatkan Nama resource, ikuti langkah-langkah dalam dokumentasi Melihat template Model Armor, dan salin nilai Nama resource.
RESPONSE_PROMPT_TEMPLATE: Nama resource template Model Armor yang Anda buat. Anda dapat menggunakan template Model Armor yang dibuat dalam project yang sama atau dari project yang berbeda.
Menguji apakah template Model Armor diaktifkan
Setelah mengonfigurasi template Model Armor, uji apakah Gemini Notebook Enterprise secara proaktif menyaring dan memblokir perintah dan respons pengguna sesuai dengan tingkat keyakinan yang ditetapkan dalam filter Model Armor.
Jika template Model Armor dikonfigurasi untuk Memeriksa dan memblokir permintaan yang melanggar kebijakan, pesan pelanggaran kebijakan berikut akan ditampilkan:
Konsol
Misalnya, Anda melihat pesan pelanggaran kebijakan:
REST
Respons JSON yang mencakup hal berikut:
Contoh:
json
"answer.state": "SKIPPED",
"answer.assist_skipped_reasons": "CUSTOMER_POLICY_VIOLATION_REASON"
Menghapus template Model Armor dari Gemini Notebook Enterprise
Untuk menghapus template Model Armor dari Gemini Notebook Enterprise, jalankan perintah berikut:
REST
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER?update_mask=customerProvidedConfig" \
-d '{
"customerProvidedConfig": {
"notebooklmConfig": {
"modelArmorConfig": {}
}
}
}'
Ganti kode berikut:
PROJECT_ID: ID project Anda.PROJECT_NUMBER: jumlah project Google Cloud Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
Mengonfigurasi log audit
Model Armor mencatat log audit Akses Data yang dapat Anda gunakan untuk menganalisis permintaan dan hasil penyaringan respons. Log ini tidak berisi kueri pengguna atau respons dari Gemini Notebook Enterprise, sehingga aman untuk pelaporan dan analisis. Untuk mengetahui informasi selengkapnya, lihat Logging audit untuk Model Armor.
Untuk mengakses log ini, Anda harus memiliki peran IAM
Private Logs Viewer
(roles/logging.privateLogViewer).
Mengaktifkan log audit Akses Data
Untuk mengaktifkan log audit Akses Data, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka IAM & Admin > Audit Logs.
Pilih Model Armor API.
Di bagian Jenis izin, pilih jenis izin Baca data.
Klik Simpan.
Memeriksa log audit Akses Data
Untuk memeriksa log audit Akses Data, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka Logs Explorer.
Telusuri log untuk nama metode berikut:
google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPromptuntuk melihat permintaan pengguna yang telah disaring.google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponseuntuk melihat respons yang disaring.