הגדרת שיתוף של הנחיות ותשובות ב-Gemini Cloud Assist

במאמר הזה נסביר איך להגדיר את השיתוף של ההנחיות והתשובות של Gemini Cloud Assist בפרויקט באמצעות מסוף Google Cloud או API.

לפני שמתחילים

  • מוודאים שהפרויקט Google Cloud מחובר לחשבון לחיוב.

(אופציונלי) הענקת הרשאות IAM

כדי להגדיר שיתוף של הנחיות ותשובות ב-Gemini Cloud Assist, נדרשות הרשאות ספציפיות לניהול זהויות והרשאות גישה (IAM), שמפורטות בקטעים הבאים. חשוב לוודא שההרשאות האלה מתווספות לתפקידים בהתאמה אישית ב-IAM.

לחלופין, אפשר להקצות את התפקיד המוגדר מראש ב-IAM‏ אדמין ההגדרות של Gemini for Google Cloud (roles/cloudaicompanion.settingsAdmin), שכולל את כל ההרשאות הנדרשות לכל ההגדרות של אדמין ב-Gemini for. Google Cloud

(אופציונלי) קישור הרשאות להגדרות וליעדים

אם אתם מגדירים את Gemini להגדרות אדמין Google Cloudבמסוף Google Cloud , אתם יכולים לדלג על הקטע הזה.

כדי להגדיר את Google Cloud הגדרות האדמין של Gemini באמצעות Gemini for Google Cloud API, קודם צריך ליצור הגדרות, ואז ליצור קישורים כדי 'לקשר' את ההגדרות והיעדים האלה (כמו מכונה, נושא או פרויקטים) למוצרים ספציפיים (כמו Gemini Cloud Assist או Gemini Code Assist).

כל ההרשאות ליצירה ולעדכון של הגדרות הן ברמת הפרויקט.

הגדרת שיתוף ההנחיות והתשובות של Gemini Cloud Assist

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

כברירת מחדל, ל-Google אין גישה לרישום ביומן או לבדיקה של ההנחיות שהמשתמשים מקלידים ושולחים ל-Gemini Cloud Assist, או של התשובות שנשלחות בחזרה. כך אנחנו לא יכולים להבין טוב יותר אילו נושאים חשובים לארגון שלכם ואיך התשובות שלנו טובות, ולכן אנחנו לא יכולים לשפר את Gemini Cloud Assist. אם מפעילים את השיתוף של ההנחיות והתשובות בפרויקט, Google שומרת את ההנחיות והתשובות שנשלחו מהפרויקט באופן אנונימי למשך 180 יום לכל היותר. ההנחיות והתשובות של הארגון שלכם אף פעם לא משמשות לאימון או לשיפור של מודל LLM כלשהו.

אם מפעילים את השיתוף של ההנחיות והתשובות עם Google, אפשר להשבית אותו בכל שלב בדף ניהול Gemini במסוף Google Cloud .

הפעלת שיתוף ההנחיות והתשובות ב-Gemini Cloud Assist

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. צריך לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בפרויקט שבבעלותו המינוי:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. במסוף Google Cloud , עוברים לדף Admin for Gemini.

    כניסה לדף Gemini for Google Cloud

    הדף Gemini for Google Cloud נטען.

  3. לוחצים על הגדרות בתפריט הניווט הימני.

    הדף הגדרות נטען.

  4. לוחצים על הפעלת שיתוף הנתונים כדי לשתף עם Google את ההנחיות והתשובות של כל המשתמשים ב-Gemini Cloud Assist בפרויקט.

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

API

כדי להפעיל את שיתוף הנתונים של Gemini Cloud Assist, משתמשים ב-method‏ CreateDataSharingWithGoogleSetting.

  1. צריך לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בפרויקט שבבעלותו המינוי:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. יוצרים את ההגדרה ואת הערך הספציפי להגדרה:

    1. מקבלים אסימון אימות:

      TOKEN=$(gcloud auth print-access-token)

    2. מריצים את הפקודה הבאה כדי ליצור את ההגדרה:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_customer_data_sharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

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

      • CONTAINER_PROJECT_NAME: מזינים את מזהה הפרויקט ההורה.
      • SETTING_ID: מזינים שם הגדרה ייחודי, למשל dswg1 עבור Data Sharing with Google.

      אם הפקודה מסתיימת ללא שגיאות, היא מחזירה גוף תגובה שבו enablePreviewDataSharing מוגדר ל-true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

      למידע נוסף על אימות, ראו אימות לשימוש ב-REST.

  3. יוצרים את קישור ההגדרה:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

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

    • TARGET_PROJECT_NAME: מזינים את הפרויקט היעד שאליו רוצים להחיל את ההגדרה.
    • SETTING_ID: משתמשים באותו SETTING_ID שיצרתם את ההגדרה, אבל מוסיפים לו את b1. לדוגמה, משתמשים ב-dswg1b1 עבור Data Sharing with Google.

    אם הפקודה מסתיימת ללא שגיאות, היא מחזירה את המטא-נתונים של הפעולה בפורמט הבא:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

השבתת שיתוף ההנחיות והתשובות ב-Gemini Cloud Assist

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. עליכם לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בפרויקט שבו אתם רוצים לשנות את ההגדרות:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. במסוף Google Cloud , עוברים לדף Admin for Gemini.

    כניסה לדף Gemini for Google Cloud

    הדף Gemini for Google Cloud נטען.

  3. לוחצים על הגדרות בתפריט הניווט הימני.

    הדף הגדרות נטען.

  4. לוחצים על השבתת שיתוף הנתונים כדי להפסיק את השיתוף של ההנחיות והתשובות עם Google לכל המשתמשים ב-Gemini Cloud Assist בפרויקט.

API

כדי להשבית את שיתוף הנתונים של Gemini Cloud Assist, משתמשים ב-method‏ DeleteDataSharingWithGoogleSetting.

  1. עליכם לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בפרויקט שבו אתם רוצים לשנות את ההגדרות:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. משביתים את שיתוף ההנחיות והתשובות בהגדרה שצוינה:

    1. מקבלים את האסימון:

      TOKEN=$(gcloud auth print-access-token)

    2. כדי להשבית את ההגדרה, מריצים את הפקודה הבאה:

      curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_customer_data_sharing": false
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      הפקודה PATCH פועלת רק אם משאב ההגדרה כבר קיים מהרגע שבו הפעלתם את שיתוף ההנחיות והתשובות.

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

      • CONTAINER_PROJECT_NAME: מזינים את מזהה הפרויקט ההורה.
      • SETTING_ID: מזינים את שם ההגדרה הקיים, למשל dswg1 עבור Data Sharing with Google.

      אם הפקודה מסתיימת ללא שגיאות, היא מחזירה גוף תגובה שבו enablePreviewDataSharing מוגדר ל-false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

המאמרים הבאים