連結至 Knowledge Catalog

本文件說明 Gemini Enterprise 如何與 Knowledge Catalog 整合，為代理提供唯讀工具，用於搜尋使用者有權存取的資料，以及查詢技術和業務背景資訊。

您不必建立獨立的資料儲存庫，即可連線至 Knowledge Catalog。當您在聯合查詢模式下，將 BigQuery、Spanner、Cloud SQL 或 AlloyDB for PostgreSQL 資料儲存庫連結至 Gemini Enterprise 應用程式時，系統會自動啟用 Knowledge Catalog 整合功能。Knowledge Catalog 不會顯示為資料儲存庫，而是 Gemini Enterprise 應用程式「Assistant」分頁中的設定選項。您也可以隨時手動開啟或關閉整合功能，即使在 Data Cloud 隨附連接器之外也沒問題。

Knowledge Catalog 和 Data Cloud 連接器如何搭配運作

在 Knowledge Catalog 中，Google Cloud 環境中每個編入目錄的資料資產，都會儲存為中繼資料記錄，稱為「項目」。在聯合查詢模式下，Data Cloud 連接器可廣泛存取已驗證使用者能查看的所有資源，而非僅限於單一資料集或資料表，因此代理一開始並不知道相關資料的位置。

Gemini Enterprise 應用程式啟用 Knowledge Catalog 後 (無論是附加聯合 Data Cloud 連接器時自動啟用，或是在「助理」分頁手動啟用)，這項整合功能會為代理提供內建技能和唯讀工具，可執行下列操作：

  • 搜尋可存取的資料：在 Knowledge Catalog 中，搜尋已驗證使用者有權存取的目錄資料資產。
  • 查詢技術和業務脈絡：擷取豐富的中繼資料，包括資料表結構定義、資料欄說明、組織詞彙和預先驗證的範例查詢 (精確查詢)。與 Data Cloud 連接器搭配使用時，代理會使用這些精確查詢，避免在複雜結構定義上發生彙整幻覺，並將這項脈絡傳遞至連接器，生成及執行準確的查詢。

工作流程範例

下圖說明 Knowledge Catalog 和聯合 Data Cloud 連接器如何搭配運作，回答使用者的問題：

圖表：顯示四個步驟的工作流程，從使用者問題、Knowledge Catalog 語意搜尋和內容擷取，到 BigQuery SQL 查詢執行。

在這個工作流程中，Gemini Enterprise 會完成下列步驟：

  1. 使用者問題：使用者在 Gemini Enterprise 中以自然語言提問：

    "How many sales did we have this month for all cold weather products?"

  2. 語意搜尋探索：Gemini Enterprise 根代理會使用從使用者問題中擷取的搜尋字詞，搜尋 Knowledge Catalog：

    ["cold weather", "products", "orders", "sales"]

  3. 擷取背景資訊：針對使用者有權存取的相符項目，代理會在 Knowledge Catalog 中查詢豐富的背景資訊 (衍生自技術中繼資料、使用模式、組織詞彙和 LLM 推論)：

    simpleName: my-project.ecomm.products
type: BigQuery Table
terms: "Cold Weather Products; category IN ('Sweaters', 'Coats & Jackets')"

  4. 執行查詢：代理會使用擷取的資料表中繼資料和業務定義，透過聯合 BigQuery 連接器，制定並執行唯讀 SQL 查詢：

    -- Execute BigQuery read-only SQL
SELECT COUNT(order_id) FROM `my-project.ecomm.orders`
WHERE product_id IN (
  SELECT id FROM `my-project.ecomm.products`
  WHERE category IN ('Sweaters', 'Coats & Jackets')
);

事前準備

Knowledge Catalog 整合功能為唯讀，並使用內部 API，因此您不必啟用 Dataplex API 或授予 MCP 工具權限，使用者也不必具備在 Knowledge Catalog 建立或修改資源的權限。

由於整合功能會使用使用者憑證驗證要求，因此代理只能尋找及探索通過驗證的使用者有權查看的資料資產 (依據 Identity and Access Management (IAM) 權限)：

  • 區隔中繼資料和資料存取權，並修剪搜尋結果：Knowledge Catalog 會根據已驗證使用者在基礎資料來源中的權限，修剪搜尋結果。如果使用者不具備資料集或資料表的讀取權限 (例如 roles/bigquery.dataViewer 或 roles/bigquery.metadataViewer)，系統會自動從目錄搜尋結果中篩除該資產，且助理無法找到該資產。
  • 第一方 Google Cloud 資料來源：第一方資料來源 (例如 BigQuery、AlloyDB for PostgreSQL、Spanner 和 Cloud SQL) 的權限會自動沿用。舉例來說，如果授予使用者 BigQuery 資料檢視者 (roles/bigquery.dataViewer) 角色，他們就能在 Knowledge Catalog 中搜尋及探索對應的資料表和資料集中繼資料。
  • 其他中繼資料和第三方資料來源：如要將自訂中繼資料、組織詞彙或第三方資料資產新增至 Knowledge Catalog，請確認使用者具備 Knowledge Catalog 的必要檢視權限 (例如 roles/dataplex.dataDomainEntryReader 或 roles/dataplex.catalogViewer)，這樣代理才能找到該資料。詳情請參閱 Knowledge Catalog 說明文件的「使用 IAM 管理存取權」一節。

在應用程式中啟用或停用 Knowledge Catalog

在聯合查詢模式中，將 BigQuery、Spanner、Cloud SQL 或 AlloyDB for PostgreSQL 資料儲存庫附加至 Gemini Enterprise 應用程式時，系統會自動為應用程式啟用 Knowledge Catalog 和內建的代理技能。

您也可以隨時手動開啟或關閉 Knowledge Catalog 整合功能，即使在 Data Cloud 隨附連接器之外也沒問題 (例如啟用 Knowledge Catalog 但不附加 Data Cloud 連接器，或在保持 Data Cloud 連接器啟用狀態時關閉 Knowledge Catalog)。請前往應用程式「設定」頁面的「助理」分頁：

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 按一下要設定的應用程式名稱。

  3. 按一下「設定」，然後選取「助理」分頁標籤。

  4. 在「Enable Knowledge Catalog」(啟用 Knowledge Catalog) 部分，使用切換鈕開啟或關閉 Knowledge Catalog 整合功能。

  5. 點選「儲存並發布」。

如要進一步瞭解助理設定，請參閱「設定助理」。

後續步驟