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

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

כשההגדרה הזו מופעלת, Google מעבדת את ההנחיות והתשובות של כל המשתמשים ב-Gemini Cloud Assist בפרויקט, כדי לשפר את המוצר. כך 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.instance.queryEffectiveSetting
  • cloudaicompanion.instance.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • settingBindings.dataSharingWithGoogleSettingsUpdate
  • 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_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=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.

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

      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?settingBindingId=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
}

השבתת שיתוף ההנחיות והתשובות ב-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_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=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
}

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