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

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

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

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

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

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

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

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

  2. מוודאים ש-Gemini Cloud Assist מוגדר בפרויקט Google Cloud .

  3. כדי לקבל את ההרשאות הנדרשות להגדרת ביסוס העובדות ב-Gemini Cloud Assist, צריך לבקש מהאדמין להקצות לכם את התפקיד Gemini for Google Cloud Settings Admin (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.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

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

הגדרת ביסוס ל-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. בוחרים את אפשרות ההארקה שרוצים להשתמש בה.

  5. לוחצים על 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/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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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