設定 Gemini Cloud Assist 的基礎

本文說明如何使用 Google Cloud 控制台或 API，為 Gemini Cloud Assist 設定基礎。Vertex AI 提供基礎功能。

可用的基礎類型：

• 以 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. 按一下「更多動作」圖示 ()，然後在下拉式選單中點按「雲端輔助設定」。

   「管理 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 管理員設定。