在 Bigtable Studio 中管理上下文集

使用上下文工程智能体时，它可以自动通过 CLI 创建和上传上下文集。本文档介绍了当您希望在 Google Cloud 控制台中使用可视化界面管理上下文集文件时，如何在 Bigtable Studio 中创建、修改和删除上下文集。在 Bigtable Studio 中创建上下文集时，Bigtable Studio 会将其存储在所选区域的项目 default 上下文集组中，并将其关联到当前实例。在给定区域的项目 default 上下文集组中，上下文集名称（及其派生的上下文集 ID）在所有数据库和实例中必须是唯一的。在 Bigtable Studio 中，如果创建的上下文集的名称所派生的 ID 已存在，则无法通过验证；如需在保留其数据库关联的同时覆盖其内容，请改为修改现有上下文集。直接通过上下文工程代理或 Dataplex API 上传现有上下文集 ID 会替换其内容，并替换其数据库关联（如果已指定）。

Bigtable Studio 中的上下文集列表仅显示与当前实例关联的所有受支持区域中 default 上下文集组内的上下文集。为其他实例创建的上下文集，或通过 API 创建但未在 databases（或自定义上下文集组）中关联实例资源的上下文集，不会显示在 Bigtable Studio 列表中。

如需了解上下文集，请参阅上下文集概览。

准备工作

在创建或上传上下文集之前，请先完成以下前提条件。

可以在 us-central1、us-east1、europe-west4 和 asia-southeast1 区域中创建上下文集。

启用必需服务

为您的项目启用以下服务：

准备 Bigtable 实例

确保 Bigtable 实例可用。如需了解详情，请参阅创建实例。

所需的角色和权限

  • 在实例或项目级层向 IAM 用户授予 roles/bigtable.admin 角色。如需了解详情，请参阅使用 IAM 进行 Bigtable 访问权限控制。
  • 在项目级层向 IAM 用户授予 roles/serviceusage.serviceUsageConsumer 和 roles/geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅为项目添加 IAM 政策绑定。
  • 如需创建、上传和管理上下文集，请在项目级层向 IAM 用户授予 Dataplex Catalog Editor (roles/dataplex.catalogEditor) 或 Dataplex Catalog Admin (roles/dataplex.catalogAdmin) 角色。如需了解详情，请参阅上下文集权限。

创建上下文集

如需创建上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Bigtable 页面。

    打开 Bigtable

  2. 从列表中选择一个实例。

  3. 在导航菜单中，点击 Bigtable Studio。

  4. 在“探索器”窗格中，点击上下文集旁边的查看操作。

  5. 点击创建情境集。

  6. 在上下文集名称中，提供唯一的上下文集名称。在 Bigtable Studio 中，名称长度必须介于 4 到 30 个字符之间，且不能以空格开头；Studio 会将名称转换为小写，并将非字母数字字符替换为连字符 (-)，从而派生出上下文集 ID，并且派生的上下文集 ID 在所选区域的项目 default 上下文集组中必须是唯一的。例如，上下文集名称 querydata_e2e_test 的上下文集 ID 为 querydata-e2e-test。如果您直接使用上下文工程代理或 Dataplex API 上传上下文集，则上下文集 ID 区分大小写，不能包含斜杠 (/)，并且不限于 4 到 30 个字符或字母数字字符、连字符和下划线。

  7. 可选。在说明中，为上下文集添加说明。

  8. 可选。如需上传上下文集文件，请点击上传上下文文件部分中的浏览，然后选择上下文集文件。

  9. 可选。如需为上下文集选择区域，请点击显示高级选项，然后在选择位置中选择一个区域（每次创建时默认为 us-east1）。如果您选择 us-east1 以外的区域，请先选择区域，然后再输入上下文集名称，以便 Bigtable Studio 验证该区域中的名称唯一性。

  10. 点击创建。

构建上下文集

如果您在 Studio 中创建了空上下文集，或者想要更新现有上下文集，请按照使用上下文工程代理构建和优化上下文集中的步骤生成和优化上下文集文件。上下文工程智能体可以直接通过 CLI 创建和上传上下文集，您也可以在 Studio 中修改上下文集，以手动上传上下文集文件。

修改上下文集

如需修改上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Bigtable 页面。

    打开 Bigtable

  2. 从列表中选择一个实例。

  3. 在导航菜单中，点击 Bigtable Studio。

  4. 点击要修改的上下文集旁边的查看操作。

  5. 点击修改上下文集。

  6. 点击上传上下文文件部分中的浏览，然后选择上下文集文件。

  7. 点击保存。

删除上下文集

如需删除上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Bigtable 页面。

    打开 Bigtable

  2. 从列表中选择一个实例。

  3. 在导航菜单中，点击 Bigtable Studio。

  4. 点击要删除的上下文集旁边的查看操作。

  5. 点击删除上下文集。

  6. 在删除上下文集确认对话框中，输入上下文集的 ID。

  7. 点击确认以删除上下文集。

后续步骤