הגדרת ביסוס (grounding) ל-Gemini Cloud Assist

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

סוגי ההארקה הזמינים:

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

  • עיגון בנתונים מהאינטרנט לארגונים: מתבסס על קבוצת משנה מוגבלת של תוכן באינטרנט. יכול להיות שהתשובות שיתקבלו יהיו באיכות נמוכה יותר בהשוואה ל<b>עיגון באמצעות חיפוש Google</b>, אבל זו האפשרות המועדפת לתעשיות עם רגולציה מחמירה שדורשות עמידה בדרישות מחמירות לגבי מיקום הנתונים, כמו פיננסים, בריאות והמגזר הציבורי.

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

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

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

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

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

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

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • אם אתם משתמשים בבקשות API ישירות, ההרשאה הזו נדרשת במיוחד עבור TARGET_PROJECT.

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

    • cloudaicompanion.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate

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

הגדרת ביסוס (grounding) ל-Gemini Cloud Assist

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

המסוף

  1. במסוף Google Cloud , עוברים אל Gemini Cloud Assist ולוחצים על הגדרות.

    כניסה לדף Settings

  2. בוחרים את אפשרות ההארקה שרוצים להשתמש בה.

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

API

כדי להגדיר את ההארקה של Gemini Cloud Assist באמצעות ה-API, יוצרים משאב geminiGcpEnablementSettings שמגדיר את סוג ההארקה באמצעות ה-method‏ geminiGcpEnablementSettings.create. לאחר מכן, משתמשים בשיטה המשויכת settingBindings.create כדי לקשר את ההגדרה לפרויקט.

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

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

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

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

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

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "webGroundingType": GROUNDING_TYPE
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

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

      • ‫CONTAINER_PROJECT: מזהה הפרויקט שבו מאוחסנים נתוני ההגדרות.
      • ‫GROUNDING_TYPE: סוג ההצמדה, שהוא GROUNDING_WITH_GOOGLE_SEARCH או WEB_GROUNDING_FOR_ENTERPRISE.
      • ‫GROUNDING_SETTING_ID: שם ייחודי לזיהוי של נתוני ההגדרה הספציפיים האלה, למשל gt1.

      אם הפקודה מצליחה, היא מחזירה גוף תגובה שמציג את webGroundingType שמוגדר לבחירה שלכם:

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "webGroundingType": GROUNDING_TYPE
}

  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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

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

    • ‫TARGET_PROJECT: מזהה הפרויקט שאליו רוצים להחיל את ההגדרה. בדרך כלל פרויקט היעד ופרויקט הקונטיינר הם אותו פרויקט.
    • ‫CONTAINER_PROJECT: מזהה הפרויקט שבו מאוחסנים נתוני ההגדרות.
    • ‫GROUNDING_SETTING_ID: GROUNDING_SETTING_ID שציינתם כשנוצרה ההגדרה.
    • ‫GROUNDING_BINDING_ID: מזהה ייחודי לזיהוי משאב מסוים של הגדרת הקישור, כמו b1.

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

    {
  "name": "projects/<var>CONTAINER_PROJECT</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</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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