הנחיות לפריסה של Gemini for Government

Last reviewed 2026-09-24 UTC

במסמך הזה מפורטות הנחיות טכניות לסוכנויות פדרליות ולמחלקות של משרד ההגנה בארה"ב, בנוגע לפריסה ולשימוש ב-Gemini for Government בהתאם לדרישות של FedRAMP High ושל רמת ההשפעה 4 (IL4) של משרד ההגנה. במסמך הזה מתוארים השירותים והתכונות שנכללים בגבולות ההרשאה, והשלבים שיעזרו לכם לעמוד בהתחייבויות שלכם לתאימות.

‫Gemini for Government משתמש ב-Assured Workloads כדי לעזור לעמוד בדרישות התאימות. אתם צריכים לפרוס את כל המשאבים של Gemini for Government בתיקיית Assured Workloads שמוגדרת למשטר התאימות הספציפי שלכם (FedRAMP High או IL4).

יחסי תלות במוצרי ליבה

‫Gemini for Government מסתמך על כמה שירותיGoogle Cloud . בטבלה הבאה מפורט סטטוס התאימות של כל שירות.

שירותGoogle Cloud	סטטוס FedRAMP High	סטטוס IL4
Gemini Enterprise	מורשה	מורשה
‫AI גנרטיבי ב-Gemini Enterprise Agent Platform (לשעבר AI גנרטיבי ב-Vertex AI)	מורשה	מורשה
BigQuery	מורשה	מורשה
Cloud Storage	מורשה	מורשה
Looker (Google Cloud core)‎	מורשה	נשלחה

הערה: מכיוון ש-Looker (Google Cloud core) עדיין לא קיבל אישור IL4, תכונות תלויות כמו Gemini ב-Looker לא מאושרות ל-IL4, כפי שמתואר בקטע תכונות לא מורשות שצריך להשבית באופן ידני.

שירותים ותכונות מורשים

בטבלה הבאה מפורטים השירותים והתכונות שאפשר להשתמש בהם ב-Gemini for Government לפריסות של FedRAMP High ו-IL4.

תכונה	FedRAMP High	IL4
השלמה אוטומטית	מורשה	מורשה
אמצעי בקרה על הצגת מודעות	מורשה	מורשה
מאגרי נתונים מורשים כמו Cloud Storage ו-BigQuery	מורשה	מורשה
Web Grounding for Enterprise	מורשה	מורשה
העלאת מסמכים ממכשירים מקומיים	מורשה	מורשה
היכולת של משתמשי הקצה לבחור מודלים	מורשה	מורשה
שמירת נתונים במטמון בזיכרון	מורשה	מורשה
סוכן Deep Research	מורשה	בדיקת DISA
יצירת סוכנים שנוצרו בלי תכנות באמצעות Agent Designer	מורשה	בדיקת DISA
גלריית הסוכנים	מורשה	בדיקת DISA
יצירת תמונות באמצעות Nano Banana	מורשה	בדיקת DISA
‫Gemini Notebook Enterprise (לא כולל סקירה קולית, אינפוגרפיקה, מצגת וסקירה בווידאו)	מורשה	בדיקת DISA
הגנה מוגברת על המודל	מורשה	בדיקת DISA
מחברים מאוחדים של Google Workspace (כולל Gmail, ‏Google Drive ויומן Google)	מורשה	בדיקת DISA
מחברים מאוחדים של צד שלישי (כמו Microsoft Office 365 Government Community Cloud (GCC),‏ Office GCC High ו-DoD ו-Salesforce)	מורשה	בדיקת DISA
Canvas	מורשה	בדיקת DISA
פרויקטים	מורשה	בדיקת DISA
מיומנויות	מורשה	בדיקת DISA

תמיכה במודלים

בקטע הזה מוסבר על התמיכה במודלים של Google ושל צד שלישי.

תמיכה במודלים של Google

רק מודלים של Google שתומכים בנקודות קצה במספר אזורים בארה"ב, כולל מודלים של Gemini שזמינים לכלל המשתמשים, מציעים התחייבויות למיקום אחסון הנתונים (DRZ) ויכולים לתמוך בדרישות של FedRAMP High,‏ DoD IL4,‏ DOD IL5,‏ ITAR ו-CJIS בלי שתצטרכו לקבוע הגדרות נוספות.

אם אתם צריכים התחייבויות ל-DRZ, אתם צריכים להגביל את הגישה למודלים של Google שתומכים רק בנקודות קצה גלובליות. במאמר הגבלת השימוש בנקודות קצה (endpoint) מוסבר איך להגביל את הגישה למודלים האלה.

תמיכה במודלים של צד שלישי

Google Cloud אחראית לתחזק את ההרשאות לתשתית להצגת מודעות ולמאגרים בהתאמה אישית, כדי שתוכלו לפרוס מודלים של צד שלישי ל-FedRAMP High ול-DoD IL4 ו-IL5.

‫Google לא מאמתת את סטטוס התאימות של פריסת מודלים של צד שלישי או את השימוש במודלים האלה, אבל אתם יכולים להשתמש בשירותים מורשים (כמו בינה מלאכותית גנרטיבית ב-Gemini Enterprise Agent Platform ו-Gemini Enterprise Agent Platform Inference: Batch and Online) כדי להשתמש ביותר מ-200 מודלים של שפה גדולים (LLM) של Google, של צד שלישי ושל קוד פתוח שזמינים ב-Model Garden. באחריותכם לוודא שהמודלים של צד שלישי נפרסים, מוגדרים ומאובטחים בהתאם לדרישות התאימות של FedRAMP ושל DoD IL4 ו-IL5. מידע נוסף זמין במאמרים סקירה כללית על מודלים בפריסה עצמית ושליטה בגישה למודלים ב-Model Garden.

תמיכה במחברים

המחברים מאחזרים נתונים ממקורות נתונים של Google או של צד שלישי אל Gemini Enterprise. יש שני סוגים של מחברים: מחברים מאוחדים ומחברים להטמעת נתונים.

מחברים מאוחדים מאחזרים נתונים ממקורות נתונים נתמכים של Google או של צד שלישי. כשמשתמש מריץ שאילתה, Gemini Enterprise מעביר את הבקשה למקור הנתונים המקושר, מאחזר תוצאות תואמות בזמן אמת ומחזיר אותן בתשובה לשאילתה. הנתונים ממקור הנתונים המקושר לא נשמרים באינדקס של Gemini Enterprise.

מחברי הטמעה מעתיקים נתונים ממערכת המקור ומוסיפים אותם לאינדקס ב-Google Cloud. כשמשתמש מריץ שאילתה, Gemini Enterprise מאחזר תוצאות מהאינדקס הקבוע הזה כדי לספק את התשובה. הנתונים שנטמעו נשארים באינדקס עד שמסירים או מעדכנים אותם באופן מפורש.

אתם יכולים להפעיל ולהגדיר מחברים דרך מסוף Gemini Enterprise. כדי להגביל את מקורות הנתונים ויעדי היציאה המותרים, אתם יכולים להשתמש באילוצים של מדיניות הארגון.

תמיכה במחברים של צד שלישי

מחברים מאוחדים של צד שלישי (זמינים בגרסת GA או בגרסת טרום-השקה ציבורית) נכללים בהרשאת FedRAMP High של Google. ההרשאה ברמת IL5 לקישורים מאוחדים באמצעות Gemini Enterprise נמצאת בהמתנה.

תמיכה במחבר של Google

המחבר המשותף של Google ל-Google Workspace (שכולל את Gmail, ‏Google Drive ויומן Google) נכלל בהרשאת FedRAMP High של Google. הרשאת IL5 בהמתנה.

בנוסף, אתם יכולים להשתמש במחברים הבאים של Google להטמעת נתונים כדי לעמוד בדרישות של FedRAMP High ו-IL5:

• BigQuery
• Cloud Storage

כדי לוודא שהחיבור עומד בדרישות, צריך ליצור חיבור שמשתמש בנקודות קצה אזוריות ונמצא באותו ארגון ובאותו גבול של VPC Service Controls.

מידע נוסף על מחברים זמין במאמר מבוא למחברים ולמאגרי נתונים.

תכונות לא מורשות שצריך להשבית באופן ידני

השירותים והתכונות הבאים לא מאושרים ל-FedRAMP High או ל-IL4. עם זאת, הם לא נחסמים על ידי חבילות הבקרה של Assured Workloads והם זמינים בפרויקט שלכם. כחלק מהערכת הסיכונים, יכול להיות שתצטרכו להעריך את השימוש בשירות ביחס לנתונים רגישים ולכל אמצעי בקרה זמין להפחתת סיכונים. יכול להיות שתצטרכו להשבית באופן ידני את התכונות שברשימה הזו בהגדרות של אפליקציית Gemini Enterprise, בהתאם להערכה שלכם.

סוכנים וגלריות	מאגר ההנחיות
עיגון	Grounding with Google Maps Platform עיגון באמצעות חיפוש Google ביסוס באמצעות העלאות מ-Google Drive (לתרחישים לדוגמה של IL4) ביסוס באמצעות העלאות מ-Microsoft OneDrive (לתרחישי שימוש ב-IL4)
תכונות גנרטיביות	יצירת תמונות באמצעות Imagen יצירת סרטון באמצעות Veo
תכונות שקשורות למשתמשים, לסשנים ולממשק המשתמש	אירועי משתמשים באפליקציות Gemini Enterprise התאמה אישית וזיכרון ב-Gemini Enterprise ‫Gemini Notebook Enterprise (לתרחישי שימוש ב-IL4 וב-IL5) ‫Gemini Notebook Enterprise עצמאי
תכונות אחרות	‫Knowledge Graph פרטי ב-Gemini Enterprise ‫Model Armor (לתרחישים לדוגמה של IL4 ו-IL5) שמירה עמידה במטמון

מידע נוסף על שמירה במטמון לטווח ארוך זמין במאמר Gemini Enterprise Agent Platform ואפס שמירת נתונים.

תכונות לא מורשות שאי אפשר להשבית

השירותים והתכונות הבאים זמינים בחבילת אמצעי הבקרה של Assured Workloads. אי אפשר להשבית אותן. אם אתם משתמשים בתכונות האלה, מומלץ לבצע הערכת סיכונים מתאימה לפני שאתם נותנים את האישור שלכם, כדי לוודא שהשימוש בשירות מתאים לפריסה של FedRAMP High או IL4. לדוגמה, אתם יכולים להעריך את השימוש בשירות ביחס לרגישות הנתונים. אתם יכולים גם לבדוק אם יש לכם אמצעי בקרה להפחתת סיכונים שמבוססים על הצפנת נתונים, כדי לקבל שליטה בלעדית על הגישה לנתונים.

ניתוח נתונים ותכונות תלויות	הצגת נתוני ניתוח הקשר של סוכן הנתונים למקורות נתונים של Looker הקשר של סוכן הנתונים למקורות נתונים ב-BigQuery סוכני נתונים שאתם יוצרים באמצעות Conversational Analytics API Gemini ב-BigQuery ‫‏Gemini ב-Looker
מחברי נתונים ומאגרי נתונים	Google Cloud מאגרי נתונים כמו Cloud SQL ו-Firestore
תכונות שקשורות למשתמשים, לסשנים ולממשק המשתמש	צ'יפים של הנחיות
תכונות אחרות	Gemini Code Assist

פריסת הסביבה

כדי לפרוס סביבה שעומדת בדרישות התאימות, פועלים לפי השלבים הבאים:

1. פריסת Assured Workloads:
   1. יוצרים תיקיית Assured Workloads שמשתמשת ב-Data Boundary ל-FedRAMP High או ב-Data Boundary ל-IL4.
   2. יוצרים את הפרויקט ב- Google Cloud בתוך התיקייה הזו.
   3. מוודאים שלכל המשתמשים וחשבונות השירות יש את ההרשאות הנדרשות לניהול זהויות והרשאות גישה (IAM).
2. מגדירים את הרשת בהתאם ל-FedRAMP High או ל-IL4. מידע נוסף זמין במאמר הגדרת הרשת ל-FedRAMP ול-DoD ב-Google Cloud.
   1. יוצרים אפליקציית Gemini Enterprise ובוחרים במיקום מספר אזורים בארה"ב. מדיניות מיקום אחסון הנתונים של Assured Workloads אוכפת את האפשרות הזו.

3. מתחברים למקור נתונים של Google שנמצא בתיקיית Assured Workloads. מאגרי הנתונים המורשים ל-FedRAMP High ול-IL4 הם קטגוריות של Cloud Storage ומערכי נתונים של BigQuery.

   הערה: אל תתחברו למקור נתונים לא מורשה (לדוגמה, Cloud SQL או Google Drive) או למשאב שנמצא מחוץ לתיקיית Assured Workloads.

4. להגדיר תכונות תאימות מורשות.

5. משביתים את התכונות הלא מורשות שמתוארות בקטע תכונות לא מורשות שצריך להשבית באופן ידני.

6. להדריך את הצוות לא להשתמש בתכונות לא מורשות שאי אפשר להשבית.

השבתת תכונות לא מורשות

כדי להשבית את התכונות הלא מורשות שאפשר להשבית באופן ידני, צריך לבצע את המשימות שבקטע הזה.

השבתת גלריית ההנחיות

צריך לבצע את המשימה הזו לכל אפליקציה שפורסים ב-Gemini Enterprise.

מוודאים שיש לכם אחד מהתפקידים הבאים:

• אדמין ב-Discovery Engine (roles/discoveryengine.admin)
• אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin)

• תפקיד בהתאמה אישית עם ההרשאה discoveryengine.engines.update

המסוף

1. במסוף Google Cloud , נכנסים לדף אפליקציות Gemini Enterprise.

מעבר אל "אפליקציות"

1. בוחרים את האפליקציה.
2. בתפריט הניווט, לוחצים על Configurations ובוחרים בכרטיסייה Feature Management.
3. משביתים את האפשרות הפעלת גלריית ההנחיות.
4. לוחצים על Save.

REST

כדי לעדכן את מפת בקרת התכונות של האפליקציה, משתמשים ב-method‏ engines.patch בנקודת הקצה ל-API‏ discoveryengine.googleapis.com.

מגדירים את המפתח prompt-gallery לערך FEATURE_STATE_OFF בהגדרות של features במנוע.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט
• ‫APP_ID: מזהה האפליקציה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features

תוכן בקשת JSON:

{
  "features": {
    "prompt-gallery": "FEATURE_STATE_OFF"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID",
  "features": {
    "prompt-gallery": "FEATURE_STATE_OFF"
  }
}

איך משביתים את העיגון בעזרת הפלטפורמה של מפות Google

כדי להשבית את הביסוס בעזרת הפלטפורמה של מפות Google לכל הבקשות, אתם יכולים להשבית את Maps Grounding API (mapsgrounding.googleapis.com) באחת מהדרכים הבאות:

• בדף APIs & Services במסוף, מאתרים את Map Grounding API (mapsgrounding.googleapis.com) ולוחצים על Disable API. מידע נוסף מופיע במאמר הפעלה והשבתה של שירותים.

• ב-Google Cloud CLI, מריצים את הפקודה:

  gcloud services disable mapsgrounding.googleapis.com
  

השבתת העיגון באמצעות חיפוש Google

כדי להשבית את העיגון באמצעות חיפוש Google בכל הבקשות, מגדירים את האילוץ הבוליאני של מדיניות הארגון constraints/vertexai.disableGenAIGoogleSearchGrounding לערך true ברמת התיקייה של Assured Workloads. מידע נוסף זמין במאמר עדכון כללי מדיניות באמצעות כללים בוליאניים.

השבתת הביסוס באמצעות העלאות מ-Google Drive (רק ב-IL4)

הקטע הזה רלוונטי רק ללקוחות DoD IL4.

העיגון ב-Google Drive מופעל רק כשמקשרים לאפליקציה מאגר נתונים ב-Google Drive. כדי להשבית את העיגון בהעלאות ל-Google Drive:

• לוודא שאין מאגרי נתונים של Google Drive שמוגדרים באפליקציות Gemini Enterprise. אם אפליקציה כבר מקושרת למאגר נתונים ב-Google Drive, צריך להסיר אותה מהגדרות האפליקציה במסוף או למחוק את מאגר הנתונים באמצעות השיטה dataStores.delete ב-Discovery Engine API.

• כדי למנוע מהמחבר לגשת למסמכי המשתמשים ב-Google Drive, צריך להשבית את יכולות שיתוף הנתונים של Workspace במסוף Google Admin, או להשבית את התכונות החכמות וההתאמה האישית ב-Google Workspace.

השבתת הביסוס באמצעות העלאות מ-Microsoft OneDrive (רק ב-IL4)

הקטע הזה רלוונטי רק ללקוחות DoD IL4.

העיגון ב-Microsoft OneDrive מופעל רק כשמחברים לאפליקציה מאגר נתונים של Microsoft OneDrive. כדי להשבית את העיגון בהעלאות מ-Microsoft OneDrive:

• מוודאים שלא מוגדרים מאגרי נתונים של Microsoft OneDrive באפליקציות Gemini Enterprise. אם אפליקציה כבר מקושרת למאגר נתונים ב-Microsoft OneDrive, צריך להסיר אותה מהגדרות האפליקציה במסוף או למחוק את מאגר הנתונים באמצעות השיטה dataStores.delete ב-Discovery Engine API.
• כדי לחסום את הגישה של המחבר, צריך לבטל את פרטי הכניסה או למחוק את מזהה הלקוח ופרטי הכניסה של אפליקציית OAuth 2.0 הרשומה ב-Microsoft Entra ID (Azure AD) שמשמשת לקישוריות של Microsoft OneDrive.

השבתת Imagen ו-Veo

כדי להשבית את יצירת התמונות באמצעות Imagen ואת יצירת הסרטונים באמצעות Veo:

• מגדירים את האילוץ constraints/vertexai.allowedModels או constraints/vertexai.allowedGenAIModels ברשימת כללי המדיניות של הארגון ברמת התיקייה או הארגון, כדי לדחות את המודלים imagen ו-veo (לדוגמה, publishers/google/models/imagen-4.0-ultra-generate-001) או כדי לאשר רק מודלים שאושרו. מידע נוסף זמין במאמר שליטה בגישה למודלים של Model Garden.

• כדי להגביל את הגישה לחיזוי במודלים של Imagen או Veo, מגדירים מדיניות דחייה של IAM שדוחה את הרשאת ה-IAM‏ aiplatform.endpoints.predict בנתיב המשאב של המודל. נתיב המשאב של המודל הוא projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_NAME.

  מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט
  • ‫LOCATION: המיקום של האפליקציה
  • ‫MODEL_NAME: שם המודל שרוצים לאשר או לדחות

השבתת אירועי משתמשים באפליקציות של Gemini Enterprise

אירועי משתמשים נשלחים על ידי כלי מעקב אחר אירועים בצד הלקוח או מיובאים בכמות גדולה. כדי להשבית את האיסוף של אירועי משתמשים, צריך לבצע אחת מהפעולות הבאות:

• כשמגדירים את ווידג'ט חיפוש Google לאפליקציה, משביתים את רישום האירועים ביומן על ידי הגדרת המאפיין disableUserEventsCollection לערך true בתוך מרחב השמות של ההגדרות האישיות של uiSettings. לדוגמה:

  "uiSettings": {
  "disableUserEventsCollection": true
  }
  

• אל תפעילו את נקודות הקצה להזרקת אירועים (במיוחד את השיטה userEvents.collect ואת השיטה userEvents.write) וודאו שסקריפטים של פיקסלים לחיפוש (כמו v1beta_event.js) לא פעילים בדפי הלקוח.

• מעדכנים את ההגדרה ברמת האפליקציה, באופן הבא:

  1. במסוף Google Cloud , נכנסים לדף אפליקציות Gemini Enterprise.

  מעבר אל "אפליקציות"

  1. בוחרים את האפליקציה.
  2. בתפריט הניווט, לוחצים על Configurations.
  3. משביתים את האפשרות הפעלת איסוף אירועי משתמשים.
  4. לוחצים על Save.

איך להשבית את ההתאמה האישית והזיכרון ב-Gemini Enterprise

צריך לבצע את המשימה הזו לכל אפליקציה שפורסים ב-Gemini Enterprise.

מוודאים שיש לכם אחד מהתפקידים הבאים:

• אדמין ב-Discovery Engine (roles/discoveryengine.admin)
• אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin)

• תפקיד בהתאמה אישית עם ההרשאה discoveryengine.engines.update

המסוף

איך משביתים את ההתאמה האישית והזיכרון

REST

כדי לעדכן את מפת בקרת התכונות של האפליקציה, משתמשים ב-method‏ engines.patch בנקודת הקצה ל-API‏ discoveryengine.googleapis.com.

מגדירים את המפתחות personalization-memory ו-personalization-suggested-highlights לערך FEATURE_STATE_OFF בfeaturesהגדרות של המנוע.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט
• ‫APP_ID: מזהה האפליקציה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features

תוכן בקשת JSON:

{
  "features": {
    "personalization-memory": "FEATURE_STATE_OFF",
    "personalization-suggested-highlights": "FEATURE_STATE_OFF"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID",
  "features": {
    "prompt-gallery": "FEATURE_STATE_OFF",
    "personalization-memory": "FEATURE_STATE_OFF",
    "personalization-suggested-highlights": "FEATURE_STATE_OFF"
  }
}

השבתת Knowledge Graph פרטי

כדי להשבית את Private Knowledge Graph, אתם יכולים להשתמש במסוף או ב-API.

מוודאים שיש לכם אחד מהתפקידים הבאים:

• אדמין ב-Discovery Engine (roles/discoveryengine.admin)
• אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin)

• תפקיד בהתאמה אישית עם ההרשאה discoveryengine.engines.update

המסוף

הוראות מופיעות במאמר ניהול ההגדרות של Knowledge Graph.

REST

כדי לעדכן את הגדרות האפליקציה, משתמשים ב-method‏ engines.patch בנקודת קצה ל-API‏ discoveryengine.googleapis.com.

מגדירים את enablePrivateKnowledgeGraph ו-enableCloudKnowledgeGraph בתור false בתוך הפרמטר knowledgeGraphConfig.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט
• ‫APP_ID: מזהה האפליקציה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=knowledgeGraphConfig

תוכן בקשת JSON:

{
  "knowledgeGraphConfig": {
    "enableCloudKnowledgeGraph": false,
    "enablePrivateKnowledgeGraph": false
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=knowledgeGraphConfig"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=knowledgeGraphConfig" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID",
  "knowledgeGraphConfig": {
    "enableCloudKnowledgeGraph": false,
    "enablePrivateKnowledgeGraph": false
  }
}

השבתת Model Armor (רק IL4)

הקטע הזה רלוונטי רק ללקוחות DoD IL4.

כדי להשבית את Model Armor בסביבות DOD IL4, צריך להסיר את התבניות שלו מהאפליקציות ואז להשבית את ה-API.

כדי להסיר את התבניות, קראו את המאמר הסרת התבניות של Model Armor מאפליקציית Gemini Enterprise.

כדי להשבית את Model Armor API (modelarmor.googleapis.com), השתמשו באחת מהשיטות הבאות:

• בדף APIs & Services במסוף, מאתרים את Model Armor API (modelarmor.googleapis.com) ולוחצים על Disable API. מידע נוסף מופיע במאמר הפעלה והשבתה של שירותים.

• ב-Google Cloud CLI, מריצים את הפקודה:

  gcloud services disable modelarmor.googleapis.com
  

השבתת השמירה במטמון עמיד

כדי להשבית את השמירה במטמון לטווח ארוך, עיינו בקטע השבתת השמירה במטמון לטווח ארוך.

השבתת Gemini Notebook Enterprise (רק ב-IL4 וב-IL5)

הקטע הזה רלוונטי רק ללקוחות DoD IL4 ו-IL5.

צריך לבצע את המשימה הזו לכל אפליקציה שפורסים ב-Gemini Enterprise.

מוודאים שיש לכם אחד מהתפקידים הבאים:

• אדמין ב-Discovery Engine (roles/discoveryengine.admin)
• אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin)

• תפקיד בהתאמה אישית עם ההרשאה discoveryengine.engines.update

המסוף

1. במסוף Google Cloud , נכנסים לדף אפליקציות Gemini Enterprise.

מעבר אל "אפליקציות"

1. בוחרים את האפליקציה.
2. בתפריט הניווט, לוחצים על Configurations ובוחרים בכרטיסייה Feature Management.
3. משביתים את Notebook.
4. לוחצים על Save.

REST

כדי לעדכן את מפת בקרת התכונות של האפליקציה, משתמשים ב-method‏ engines.patch בנקודת הקצה ל-API‏ discoveryengine.googleapis.com. מגדירים את המפתח notebook-lm לערך FEATURE_STATE_OFF בהגדרות של features במנוע.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט
• ‫APP_ID: מזהה האפליקציה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features

תוכן בקשת JSON:

{
  "features": {
    "notebook-lm": "FEATURE_STATE_OFF"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID?updateMask=features" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID",
  "features": {
    "prompt-gallery": "FEATURE_STATE_OFF",
    "notebook-lm": "FEATURE_STATE_OFF"
  }
}

הסרת הגישה ל-Gemini Notebook Enterprise העצמאי

כדי להסיר את הגישה ל-Gemini Notebook Enterprise (https://notebooklm.cloud.google.com/)‎, צריך לבטל את התפקידים הבאים ב-IAM לכל המשתמשים והקבוצות:

• Cloud NotebookLM User ‏(roles/discoveryengine.notebookLmUser)
• אדמין ב-Cloud NotebookLM‏ (roles/discoveryengine.notebookLmOwner)

במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים מוסבר איך לבטל תפקידים.

אם הארגון שלכם רכש מינוי נפרד ועצמאי ל-Gemini Notebook Enterprise (ולא מינוי ל-Gemini Enterprise), אתם יכולים להשבית את החידוש האוטומטי:

1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage subscriptions.

   אל Gemini Enterprise

2. לוחצים על השם של המינוי העצמאי.

3. לוחצים על Edit.

4. מבטלים את הסימון בתיבה חידוש אוטומטי של המינוי.

5. לוחצים על שליחה.