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

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

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

כדי לקבל את ההרשאות שנדרשות להגדרת שיתוף של הנחיות ותשובות ב-Gemini Cloud Assist, צריך לבקש מהאדמין להקצות לכם את התפקיד המוגדר מראש Gemini Cloud Assist Admin (roles/geminicloudassist.admin) ב-IAM. התפקיד הזה כולל את כל ההרשאות שנדרשות לצפייה בהגדרות האדמין של Gemini Cloud Assist ולשינוי שלהן.

כדי לראות את ההרשאות הנדרשות, מרחיבים את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • cloudaicompanion.dataSharingWithGoogleSettings.update
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
    • אם אתם משתמשים בבקשות API ישירות, אתם צריכים את ההרשאה הזו במיוחד בשביל TARGET_PROJECT.

אם אתם משתמשים במסוף Google Cloud , נדרשות גם ההרשאות הבאות:

  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsDelete

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

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

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

המסוף

  1. פותחים את המסוף Google Cloud .

    כניסה למסוף Google Cloud

  2. בכל דף במסוף Google Cloud , לוחצים על סמל הנצנוץ Open or close Gemini Cloud Assist chat.

    החלונית Cloud Assist תיפתח.

  3. לוחצים על פעולות נוספות () ואז על הגדרות Cloud Assist בתפריט הנפתח.

    נפתחת חלונית ההגדרות ניהול Gemini Cloud Assist.

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

  5. לוחצים על Save.

API

כדי להפעיל את שיתוף הנתונים ב-Gemini Cloud Assist, צריך ליצור הגדרה באמצעות השיטה dataSharingWithGoogleSettings.create ולהחיל את ההגדרה באמצעות השיטה המשויכת settingBindings.create.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    {
  "name": "projects/CONTAINER_PROJECT/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/TARGET_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

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

המסוף

  1. פותחים את המסוף Google Cloud .

    כניסה למסוף Google Cloud

  2. בכל דף במסוף Google Cloud , לוחצים על סמל הנצנוץ Open or close Gemini Cloud Assist chat.

    החלונית Cloud Assist תיפתח.

  3. לוחצים על פעולות נוספות () ואז על הגדרות Cloud Assist בתפריט הנפתח.

    נפתחת חלונית ההגדרות ניהול Gemini Cloud Assist.

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

  5. לוחצים על Save.

API

כדי להשבית את שיתוף ההנחיות והתשובות ב-Gemini Cloud Assist, משתמשים בשיטה dataSharingWithGoogleSettings.patch.

  1. קבלת הטוקן:

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

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

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

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

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

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

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

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

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