管理脈絡資料集

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

情境集可讓您將語意資訊和資料資產參照，整理至有界限的容器中，為 AI 代理建立基準。在 Knowledge Studio 中，您可以建立、查看、更新及刪除情境集，並為每個容器設定存取控管。

您必須先設定情境集，才能執行擴充工作來產生中繼資料提案。您可以建立情境集，做為獨立容器或在設定擴充工作時使用。詳情請參閱「情境集總覽」和「建立擴充工作」。

事前準備

管理情境集之前，請確認您具備必要的 Identity and Access Management (IAM) 角色。

必要的角色

如要取得建立及管理情境集和其項目的權限，請要求管理員授予您專案或情境集的下列 IAM 角色：

• 如要在專案中建立情境集：Dataplex 內容創作者 (roles/dataplex.contentCreator) 或 Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin)
• 如要探索情境集，但不讀取其項目： Dataplex 內容檢視者 (roles/dataplex.contentViewer)
• 如要查看項目並在情境集中提出變更建議： Dataplex 內容使用者 (roles/dataplex.contentUser)
• 如要在情境集中建立、更新、刪除及連結項目：Dataplex 內容編輯者 (roles/dataplex.contentEditor)
• 如要管理情境集的 IAM 權限或刪除情境集：Dataplex 內容管理員 (roles/dataplex.contentAdmin)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備建立及管理情境集和其項目的必要權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

您必須具備下列權限，才能建立及管理情境集和其項目：

• 建立脈絡資料集： dataplex.entryGroups.createContextSet
• 列出情境組合： dataplex.entryGroups.list
• 查看情境集詳細資料： dataplex.entryGroups.getContextSet
• 更新脈絡資料集： dataplex.entryGroups.updateContextSet
• 刪除脈絡資料集： dataplex.entryGroups.deleteContextSet
• 提議變更情境組合：dataplex.entryGroups.requestContextChanges
• 管理情境集 IAM 政策：dataplex.entryGroups.getIamPolicy, dataplex.entryGroups.setIamPolicy
• 建立、查看、列出、更新及刪除脈絡資料集中的項目：dataplex.entries.createContext, dataplex.entries.getContext, dataplex.entries.listContext, dataplex.entries.updateContext, dataplex.entries.deleteContext
• 連結及取消連結情境集項目上的目錄資產： dataplex.entryLinks.create, dataplex.entryLinks.delete, dataplex.entries.link, dataplex.entryGroups.useReferenceEntryLink

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

建立情境集時，Knowledge Catalog 會自動授予您該情境集的 Dataplex 內容管理員 (roles/dataplex.contentAdmin) 角色。

注意： 情境集權限 (dataplex.entryGroups.*ContextSet 和 dataplex.entries.*Context) 會按照預期對情境集強制執行存取控管。不過，現有的 Dataplex 項目群組擁有者 (roles/dataplex.entryGroupOwner) 和 Dataplex 項目擁有者 (roles/dataplex.entryOwner) 角色包含這些情境集權限，預計會在日後的更新中從這兩個角色中移除。如要防止具備 Dataplex 項目群組擁有者 (roles/dataplex.entryGroupOwner) 或 Dataplex 項目擁有者 (roles/dataplex.entryOwner) 角色的主體在預先發布版期間存取情境集，請避免授予這兩個預先存在的角色 (例如設定自訂角色)，或在未授予這些預先存在角色的專屬專案中建立情境集。

建立脈絡資料集

如要建立情境集來儲存精選或強化的中繼資料，請按照下列步驟操作：

Knowledge Studio

1. 前往 Google Cloud 控制台的「Knowledge Studio」頁面。

   前往 Knowledge Studio

2. 在導覽窗格中，選取「Context sets」(情境集)。

3. 在「Context sets」(情境集) 頁面，按一下「Create context set」(建立情境集)。

4. 在「Create context set」(建立情境集) 窗格中，在「Display name」(顯示名稱) 欄位輸入描述性名稱，並在「Context set ID」(情境集 ID) 欄位輸入專屬 ID (或保留自動生成的 ID)。內容集 ID 會成為 API 中的項目群組資源 ID，建立後即無法變更。

5. 在「Region」(區域) 選單中，選取脈絡資料集的位置 Google Cloud ：

   • 區域 (例如 us-central1)：如果所有擴充資產都位於單一區域，建議使用此選項。
   • 多區域 (例如 us 或 eu)：讓脈絡資料集涵蓋該地理邊界內多個單一區域的資產。
   • Global (global)：可讓情境集參照任何區域的資產。

6. 選用：在「Description」(說明) 欄位中輸入內容，概述情境集的業務領域和用途，然後按一下「Add label」(新增標籤)，附加鍵/值標籤。

7. 點選「建立」。

中繼資料類型

1. 前往 Google Cloud 控制台的「Metadata types」(中繼資料類型) 頁面。

   前往「Metadata types」(中繼資料類型) 頁面

2. 依序點選「Entry groups」(項目群組) >「Context set」(情境集)。

3. 在「中繼資料類型」頁面，按一下「建立」。

4. 在「Create context set」(建立情境集) 窗格中，在「Display name」(顯示名稱) 欄位輸入描述性名稱，並在「Context set ID」(情境集 ID) 欄位輸入專屬 ID (或保留自動生成的 ID)。內容集 ID 會成為 API 中的項目群組資源 ID，建立後即無法變更。

5. 在「Region」(區域) 選單中，選取情境集的 Google Cloud 位置：

   • 區域 (例如 us-central1)：如果所有擴充資產都位於單一區域，建議使用此選項。
   • 多區域 (例如 us 或 eu)：讓脈絡資料集涵蓋該地理邊界內多個單一區域的資產。
   • Global (global)：可讓情境集參照任何區域的資產。

6. 選用：在「Description」(說明) 欄位中輸入內容，概述情境集的業務領域和用途，然後按一下「Add label」(新增標籤)，附加鍵/值標籤。

7. 點選「建立」。

建立情境集後，您可以選取該情境集做為擴充工作的目標。擴充執行作業會將建議的中繼資料文件、概念和資料資產項目填入容器。詳情請參閱「關於擴充工作」。

查看脈絡資料集

如要查看現有的情境組合，請按照下列步驟操作：

Knowledge Studio

1. 前往 Google Cloud 控制台的「Knowledge Studio」頁面。

   前往 Knowledge Studio

2. 在導覽窗格中，選取「Context sets」(情境集)，即可查看所選專案中的情境集。

3. 如要查看特定情境集的詳細資料，請在清單中按一下其名稱。

中繼資料類型

1. 前往 Google Cloud 控制台的「Metadata types」(中繼資料類型) 頁面。

   前往「Metadata types」(中繼資料類型) 頁面

2. 依序點選「Entry groups」(項目群組) >「Context set」(情境集)。

3. 選用：開啟「Show from all projects」(顯示所有專案) 切換鈕，即可瀏覽您有權查看的所有Google Cloud 專案情境集。

4. 如要查看特定情境集的詳細資料，請在清單中按一下其名稱。

情境集詳細資料頁面包含下列部分和控制項：

• 容器中繼資料：顯示內容集的說明、位置、專案 ID、建立和修改時間戳記，以及標籤。
• 頂端動作列：提供管理情境集的按鈕 (「Edit」、「Delete」和「Permissions」)。
• 項目表格：列出儲存在情境集中的項目，包括每個項目的「名稱」、「說明」、「項目類型」、「建立日期」和「連結的資產」。

編輯脈絡資料集

您可以使用 Google Cloud 控制台編輯情境集的容器屬性，包括「Display name」(顯示名稱)、「Description」(說明)和「Labels」(標籤)。

如要更新情境集內的中繼資料項目，請針對該情境集執行擴充工作，並核准產生的變更提案。如要進一步瞭解如何核准變更提案，請參閱「評估及核准擴充提案」。

如要編輯情境組合的屬性，請按照下列步驟操作：

Knowledge Studio

1. 前往 Google Cloud 控制台的「Knowledge Studio」頁面。

   前往 Knowledge Studio

2. 在導覽窗格中，選取「Context sets」(情境集)。

3. 按一下要編輯的情境集名稱，然後在詳細資料頁面上點選「Edit」(編輯)。或者，您也可以勾選清單中情境組合旁的核取方塊，然後按一下頂端動作列中的「Edit」(編輯)，或按一下該列中的 「More options」(更多選項) >「Edit」(編輯)。

4. 修改可編輯的欄位 (「Display name」(顯示名稱)、「Description」(說明) 或「Labels」(標籤))，然後按一下「Save」(儲存)。

中繼資料類型

1. 前往 Google Cloud 控制台的「Metadata types」(中繼資料類型) 頁面。

   前往「Metadata types」(中繼資料類型) 頁面

2. 依序點選「Entry groups」(項目群組) >「Context set」(情境集)。

3. 按一下要編輯的情境集名稱，然後在詳細資料頁面上點選「Edit」(編輯)。

4. 修改可編輯的欄位 (「Display name」(顯示名稱)、「Description」(說明) 或「Labels」(標籤))，然後按一下「Save」(儲存)。

刪除脈絡資料集

刪除情境集後，系統會從資料情境圖中移除其項目和語意關聯。如果您刪除現有擴充工作參照的情境集，控制台不會顯示警告。如果在擴充執行作業進行期間刪除情境集，由於目標目的地已不存在，執行作業完成後將無法儲存建議的中繼資料。後續執行的擴充工作也會失敗，直到您重新建立脈絡資料集，或建立新的擴充工作，指定有效的脈絡資料集。

如要刪除情境組合，請按照下列步驟操作：

Knowledge Studio

1. 前往 Google Cloud 控制台的「Knowledge Studio」頁面。

   前往 Knowledge Studio

2. 在導覽窗格中，選取「Context sets」(情境集)。

3. 按一下要刪除的情境集名稱，然後在詳細資料頁面中點選「Delete」(刪除)。或者，您也可以勾選清單中情境組合旁的核取方塊，然後按一下頂端動作列中的「Delete」(刪除)，或按一下該列中的 「More options」(更多選項) >「Delete」(刪除)。

4. 確認刪除。

中繼資料類型

1. 前往 Google Cloud 控制台的「Metadata types」(中繼資料類型) 頁面。

   前往「Metadata types」(中繼資料類型) 頁面

2. 依序點選「Entry groups」(項目群組) >「Context set」(情境集)。

3. 按一下要刪除的情境集名稱，然後在詳細資料頁面中點選「Delete」(刪除)。

4. 確認刪除。

限制

如要瞭解預先發布版期間適用的限制，請參閱「情境集總覽」中的「預先發布版範圍和界限」一節。

後續步驟

詳情請參閱下列資源：

• 設定擴充工作的必要條件
• 建立資料充實任務
• 評估及核准擴充提案