設定 Gemini Cloud Assist 的基礎

基礎 功能可讓您透過 Vertex AI 將 Gemini Cloud Assist 連結至外部網路來源，提供更準確且符合現況的回覆。本文說明如何在 Google Cloud 控制台中或使用 API 設定基礎。

可用的基準比對類型：

• 以 Google 搜尋強化事實基礎 (建議)： 指示 Gemini Cloud Assist 使用 Google 搜尋，提供最全面且最新的回覆。請注意，這個選項不支援資料落地、資料存取透明化控管機制和客戶自行管理的加密金鑰 (CMEK) 等特定功能。

• 以企業適用的網路內容建立基準： 運用受限的網路內容子集。雖然與以 Google 搜尋強化事實基礎相比，這可能會導致回覆品質較低，但對於需要嚴格遵守資料落地法規的產業 (例如金融、醫療照護和公部門)，這是較好的選擇。

Gemini Cloud Assist 預設會透過「以 Google 搜尋強化事實基礎」功能，提升提示回覆的品質。使用「利用 Google 搜尋建立基準」功能時，系統會對提示和回覆進行特殊資料處理，詳情請參閱Google Cloud 服務條款。

事前準備

1. 確認 Google Cloud 專案已連結至帳單帳戶。

2. 確認您已為 Google Cloud 專案設定 Gemini Cloud Assist。

3. 如要取得設定 Gemini Cloud Assist 基礎資訊所需的權限，請要求管理員在專案中授予您「Gemini for Google Cloud 設定管理員」(roles/cloudaicompanion.settingsAdmin) Identity and Access Management (IAM) 角色。這個預先定義的角色具備管理 Gemini Cloud Assist 管理員設定所需的權限。

   如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

   所需權限

   • 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 控制台的任何頁面中，點選「火花」「開啟或關閉 Gemini Cloud Assist 對話」。

   「Cloud Assist」面板隨即開啟。

3. 按一下「更多動作」圖示 ()， 然後在下拉式選單中點按「Cloud Assist 設定」。

   「管理 Gemini Cloud Assist」設定面板隨即開啟。

4. 選取要使用的基礎選項。

5. 按一下 [儲存]。

API

如要使用 API 設定 Gemini Cloud Assist 的基礎知識，請使用 geminiGcpEnablementSettings.create 方法建立 geminiGcpEnablementSettings 資源，定義基礎知識類型。接著，您可以使用相關聯的 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：儲存設定資料的專案 ID。
      • 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：要套用設定的專案 ID。通常目標專案和容器專案相同。
   • CONTAINER_PROJECT：儲存設定資料的專案 ID。
   • GROUNDING_SETTING_ID：您在建立設定時指定的 GROUNDING_SETTING_ID。
   • GROUNDING_BINDING_ID：用來識別這個特定設定繫結資源的專屬 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
   }
   

後續步驟

• 查看其他 Gemini Cloud Assist 管理員設定。