הגדרת ערוצי הפצה של Gemini Code Assist

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

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

אלה ערוצי ההפצה שזמינים:

• זמינות לכלל המשתמשים (GA). ערוץ ההפצה שמוגדר כברירת מחדל. מאפשר שימוש במודלים ובתכונות שזמינים לכלל המשתמשים. שימו לב שאפשר לגשת לתכונות מסוימות של גרסת טרום-השקה בלי להצטרף לערוץ טרום-השקה, באמצעות מנגנונים חלופיים להרשמה לגרסת טרום-השקה. התכונות האלה יהיו נגישות בערוץ GA, אבל הן עדיין כפופות לתנאי השימוש במוצרים בגרסת טרום-GA.

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

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

בקטעים הבאים מפורטים השלבים שנדרשים כדי להגדיר או לשנות את ערוץ ההפצה של Gemini Code Assist.

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

• מוודאים ש Google Cloud הפרויקט מקושר לחשבון לחיוב. מידע נוסף זמין במאמר אימות סטטוס החיוב של פרויקטים.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות ליצירת הגדרות וקישורים ששולטים בערוץ ההפצה, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין הגדרות של Gemini for Google Cloud ‏ (roles/cloudaicompanion.settingsAdmin) בפרויקט.

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

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

• cloudaicompanion.releaseChannelSettings.create
• cloudaicompanion.releaseChannelSettings.delete
• cloudaicompanion.releaseChannelSettings.get
• cloudaicompanion.releaseChannelSettings.list
• cloudaicompanion.releaseChannelSettings.update
• cloudaicompanion.dataSharingWithGoogleSettings.create
• הגדרת ערוצי הפצה באמצעות API:
• cloudaicompanion.settingBindings.releaseChannelSettingsCreate
• cloudaicompanion.settingBindings.releaseChannelSettingsDelete
• cloudaicompanion.settingBindings.releaseChannelSettingsGet
• cloudaicompanion.settingBindings.releaseChannelSettingsList
• cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
• cloudaicompanion.settingBindings.releaseChannelSettingsUse
• הגדרת שיתוף של הנחיות ותשובות באמצעות API:
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
• הצגת הגדרות האדמין של Gemini ל- Google Cloud :
• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings

הגדרת ערוצי הפצה של Gemini Code Assist

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

המסוף

1. נכנסים לדף Admin for Gemini במסוף Google Cloud .

   אל Gemini ל- Google Cloud

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

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

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

3. בקטע ערוצי הפצה של Gemini Code Assist בסביבות פיתוח משולבות (IDE) מקומיות, בוחרים את ערוץ ההפצה שהכי מתאים לצרכים שלכם:

   תצוגה מקדימה

   1. בוחרים באפשרות תצוגה מקדימה.
   2. בודקים את הפרטים של ערוץ ההפצה של הגרסה המקדימה ואת התנאים של תוכנית הבודקים המהימנים, ואז לוחצים על שמירת השינויים.

   זמינות לכלל המשתמשים (GA)

   1. בוחרים באפשרות GA.
   2. לוחצים על שמירת השינויים.

API

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

   1. קבלת טוקן אימות. כדי לקבל את המזהה, צריך לבצע אימות באמצעות אימות של ה-CLI של gcloud:

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

   2. יוצרים את ההגדרה. בהוראות האלה נעשה שימוש ב-cURL כדי להפעיל שיטות API:

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
            "release_channel": "RELEASE_CHANNEL",
          } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"
      

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

      • ‫RELEASE_CHANNEL: ערוץ ההפצה, EXPERIMENTAL לתצוגה מקדימה או STABLE לזמינות כללית.
      • ‫CONTAINER_PROJECT_NAME: מזהה הפרויקט שבו מאוחסן משאב הקישור. זהו פרויקט האב של הקישור.
      • ‫RC_SETTING_ID: שם ייחודי להגדרה, לדוגמה rc1 עבור Release Channel.

      הפלט יראה את releaseChannel שמוגדר ל-RELEASE_CHANNEL:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/releaseChannelSettings/RC_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "releaseChannel": RELEASE_CHANNEL
      }
      

   3. יוצרים את הקישור של הגדרת ערוץ ההפצה:

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

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

      • ‫TARGET_PROJECT_NAME: פרויקט היעד שאליו צריך לקשר את הקישור. לרוב, זה אותו פרויקט כמו פרויקט הקונטיינר. עם זאת, אפשר לקשר הגדרה לכמה פרויקטים כדי שלא יהיה צורך לשכפל את משאב ההגדרה.
      • ‫CONTAINER_PROJECT_NAME: מזהה הפרויקט שבו מאוחסן משאב הקישור. זהו פרויקט האב של הקישור.
      • ‫RC_SETTING_ID: אותו RC_SETTING_ID שבו השתמשתם כשיצרתם את ההגדרה, אבל עם התוספת b1. לדוגמה, משתמשים ב-rc1b1 בשביל Release Channel.
      • ‫RC_BINDING_ID: שם ייחודי לקישור ההגדרות, לדוגמה rc_binding.

      הפלט כולל את המטא-נתונים של הפעולה בפורמט הבא:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
          "createTime": "2025-01-23T15:27:50.076075570Z",
          "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
          "verb": "create",
          "requestedCancellation": false,
          "apiVersion": "v1"
        },
        "done": false
      }
      

   4. אופציונלי: בדיקת הסטטוס של הקישור של הגדרת ערוץ ההפצה ליצירה:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID
      

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

      • ‫CONTAINER_PROJECT_NAME: מזהה הפרויקט שבו מאוחסן משאב הקישור. זהו פרויקט האב של הקישור.
      • ‫RC_BINDING_OPERATION_ID: מזהה הפעולה של יצירת הקישור של הגדרת ערוץ ההפצה שמופיע בתגובה בשלב הקודם.

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

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

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

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

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

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

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

      הפלט יראה את enablePreviewDataSharing שמוגדר ל-true:

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

   3. יוצרים את הקישור של הגדרת ההנחיה והתשובה:

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

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

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

      הפלט כולל את המטא-נתונים של הפעולה בפורמט הבא:

      {
      "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
        "createTime": "2025-01-23T15:27:50.076075570Z",
        "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
      }
      

   4. אופציונלי: בודקים את הסטטוס של יצירת הקישור בין ההגדרה של ההנחיה והתשובה:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID
      

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

      • ‫CONTAINER_PROJECT_NAME: מזהה הפרויקט שבו מאוחסן משאב הקישור. זהו פרויקט האב של הקישור.
      • ‫DSWG_BINDING_OPERATION_ID: המזהה של פעולת יצירת הקישור של ההגדרה של ההנחיה והתגובה שסופק בתגובה בשלב הקודם.

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

• מידע על התמחור של Gemini Code Assist
• הצגת הגדרות נוספות של Gemini Code Assist לאדמינים