設定 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. 如要取得設定 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.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate

您或許還可透過其他預先定義的角色或自訂角色取得這些權限。

設定 Gemini Cloud Assist 的基礎

選取下列選項之一：

控制台

  1. 在 Google Cloud 控制台中，前往「Gemini Cloud Assist」，然後點選「設定」。

    前往「設定」

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

  3. 按一下 [儲存]。

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/<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
}

後續步驟