管理上下文集

借助上下文集,您可以将语义信息和数据资产引用整理到有界容器中,从而为 AI 智能体提供依据。在 Knowledge Studio 中,您可以创建、查看、更新和删除上下文集,并为每个容器配置访问权限控制。

您必须先配置上下文集,然后才能运行丰富任务来生成元数据建议。您可以将上下文集创建为独立容器,也可以在设置丰富任务期间创建。如需了解详情,请参阅上下文集概览和创建丰富化任务。

准备工作

在管理上下文集之前,请确保您拥有所需的 Identity and Access Management (IAM) 角色。

所需的角色

如需获得创建和管理上下文集及其条目所需的权限,请让管理员向您授予项目或上下文集的以下 IAM 角色:

  • 在项目中创建上下文集:Dataplex 内容创作者 (roles/dataplex.contentCreator) 或 Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
  • 在不读取上下文集条目的情况下发现上下文集:Dataplex Content Viewer (roles/dataplex.contentViewer)
  • 查看条目并针对上下文集提出更改建议:Dataplex Content User (roles/dataplex.contentUser)
  • 如需在上下文集中创建、更新、删除和关联条目,请使用 Dataplex Content Editor (roles/dataplex.contentEditor)
  • 如需管理上下文集的 IAM 权限或删除上下文集,请执行以下操作:Dataplex Content Admin (roles/dataplex.contentAdmin)

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含创建和管理上下文集及其条目所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

如需创建和管理上下文集及其条目,需要具备以下权限:

  • 创建上下文集: 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 Content Admin (roles/dataplex.contentAdmin) 角色。

创建上下文集

如需创建上下文集来存储精选或扩充的元数据,请按照以下步骤操作:

Knowledge Studio

  1. 在 Google Cloud 控制台中,前往 Knowledge Studio 页面。

    前往 Knowledge Studio

  2. 在导航窗格中,选择上下文集。

  3. 在上下文集页面上,点击创建上下文集。

  4. 在创建上下文集窗格中,在显示名称字段中输入描述性名称,在上下文集 ID 字段中输入唯一标识符(或保留自动生成的 ID)。上下文集 ID 会成为 API 中的条目组资源 ID,并且在创建后无法更改。

  5. 在区域菜单中,为上下文集选择一个 Google Cloud 位置:

    • 单区域(例如 us-central1):当所有丰富资产都位于单个区域时,建议使用此选项。
    • 多区域(例如 us 或 eu):允许上下文集涵盖位于该地理边界内多个单区域中的资产。
    • 全球 (global):允许上下文集引用任何区域中的资产。
  6. 可选:输入说明,总结上下文集的业务领域和用途,然后点击添加标签以附加键值对标签。

  7. 点击创建。

元数据类型

  1. 在 Google Cloud 控制台中,前往元数据类型页面。

    前往“元数据类型”

  2. 依次点击条目组 > 上下文集。

  3. 在元数据类型页面上,点击创建。

  4. 在创建上下文集窗格中,在显示名称字段中输入描述性名称,在上下文集 ID 字段中输入唯一标识符(或保留自动生成的 ID)。上下文集 ID 会成为 API 中的条目组资源 ID,并且在创建后无法更改。

  5. 在区域菜单中,为上下文集选择一个 Google Cloud 位置:

    • 单区域(例如 us-central1):当所有丰富资产都位于单个区域时,建议使用此选项。
    • 多区域(例如 us 或 eu):允许上下文集涵盖位于该地理边界内多个单区域中的资产。
    • 全球 (global):允许上下文集引用任何区域中的资产。
  6. 可选:输入说明,总结上下文集的业务领域和用途,然后点击添加标签以附加键值对标签。

  7. 点击创建。

创建上下文集后,您可以将其选为丰富任务的目标。丰富化运行会使用建议的元数据文档、概念和数据资产条目填充容器。如需了解详情,请参阅关于丰富任务。

查看上下文集

如需查看现有上下文集,请按以下步骤操作:

Knowledge Studio

  1. 在 Google Cloud 控制台中,前往 Knowledge Studio 页面。

    前往 Knowledge Studio

  2. 在导航窗格中,选择上下文集以查看所选项目中的上下文集。

  3. 如需查看特定上下文集的详细信息,请在列表中点击其名称。

元数据类型

  1. 在 Google Cloud 控制台中,前往元数据类型页面。

    前往“元数据类型”

  2. 依次点击条目组 > 上下文集。

  3. 可选:开启显示所有项目中的上下文集切换开关,以浏览您有权在所有Google Cloud 项目中查看的上下文集。

  4. 如需查看特定上下文集的详细信息,请点击列表中的名称。

上下文集详情页面包含以下部分和控件:

  • 容器元数据:显示上下文集的说明、位置、项目 ID、创建和修改时间戳以及标签。
  • 顶部操作栏:提供用于管理上下文集的按钮(修改、删除和权限)。
  • 条目表:列出存储在上下文集中的条目,包括每个条目的名称、说明、条目类型、创建日期和关联的资产。

修改上下文集

使用 Google Cloud 控制台,您可以修改上下文集的容器属性,包括其显示名称、说明和标签。

如需更新上下文集内的元数据条目,请运行针对该上下文集的丰富任务,并批准生成的更改建议。如需详细了解如何批准更改提案,请参阅评估和批准丰富提案。

如需修改上下文集的属性,请按以下步骤操作:

Knowledge Studio

  1. 在 Google Cloud 控制台中,前往 Knowledge Studio 页面。

    前往 Knowledge Studio

  2. 在导航窗格中,选择上下文集。

  3. 点击要修改的情境集的名称,然后点击详情页面上的修改。或者,选中列表中情境集旁边的复选框,然后点击顶部操作栏中的修改,或点击相应行中的 更多选项 > 修改。

  4. 修改可修改字段(显示名称、说明或标签),然后点击保存。

元数据类型

  1. 在 Google Cloud 控制台中,前往元数据类型页面。

    前往“元数据类型”

  2. 依次点击条目组 > 上下文集。

  3. 点击要修改的上下文集的名称,然后点击详情页面上的修改。

  4. 修改可修改字段(显示名称、说明或标签),然后点击保存。

删除上下文集

删除上下文集会从数据上下文图中移除其条目和语义关联。如果您删除现有丰富化任务引用的上下文集,控制台不会显示警告。如果您在富化运行处于活跃状态时删除上下文集,则运行在完成时无法保存其建议的元数据,因为目标位置不再可用。后续运行的丰富任务也会在运行后失败,直到您重新创建上下文集或创建以有效上下文集为目标的新丰富任务。

如需删除上下文集,请按照以下步骤操作:

Knowledge Studio

  1. 在 Google Cloud 控制台中,前往 Knowledge Studio 页面。

    前往 Knowledge Studio

  2. 在导航窗格中,选择上下文集。

  3. 点击要删除的上下文集的名称,然后点击详情页面上的删除。或者,选中列表中情境集旁边的复选框,然后点击顶部操作栏中的删除,或点击该行中的 更多选项 > 删除。

  4. 确认删除。

元数据类型

  1. 在 Google Cloud 控制台中,前往元数据类型页面。

    前往“元数据类型”

  2. 依次点击条目组 > 上下文集。

  3. 点击要删除的上下文集的名称,然后点击详情页面上的删除。

  4. 确认删除。

限制

如需了解预览版期间适用的限制,请参阅上下文集概览中的“预览版范围和边界”部分。

后续步骤

如需了解详情,请参阅以下资源: