在 AlloyDB Studio 中管理上下文集

本文档介绍了如何在 AlloyDB for PostgreSQL Studio 中使用上下文集文件创建上下文集。在 AlloyDB Studio 中创建上下文集时，AlloyDB Studio 会将其存储在所选区域的项目 default 上下文集组中，并将其关联到当前数据库。在给定区域的项目 default 上下文集组中，上下文集名称（及其派生的上下文集 ID）在所有数据库和实例中必须是唯一的。在 AlloyDB Studio 中，如果创建的上下文集的名称所派生的 ID 已存在，则无法通过验证；如需在保留其数据库关联的同时覆盖其内容，请改为修改现有上下文集。直接通过上下文工程代理或 Dataplex API 上传现有上下文集 ID 会替换其内容，并替换其数据库关联（如果已指定）。

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

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

准备工作

在创建智能体之前，请完成以下前提条件。

启用必需服务

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

准备 AlloyDB for PostgreSQL 集群、实例和数据库

确保您有权访问现有 AlloyDB 集群和实例，或创建一个新集群和实例。
本教程要求您的 AlloyDB 实例中有一个数据库。 如需了解详情，请参阅创建数据库。

所需的角色和权限

  • 通过将 alloydb.iam_authentication 数据库标志设置为 on (alloydb.iam_authentication=on)，在实例上启用 Identity and Access Management (IAM) 数据库身份验证。如需了解详情，请参阅启用和停用 IAM 身份验证。
  • 在数据库级层将 IAM 用户或服务账号添加到集群。如需了解详情，请参阅管理 IAM 身份验证。
  • 在项目级向 IAM 用户授予 alloydb.databaseUser、serviceusage.serviceUsageConsumer 和 geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅为项目添加 IAM 政策绑定。
  • 如需创建、上传和管理上下文集，请在项目级向 IAM 用户授予 Dataplex Catalog Editor (roles/dataplex.catalogEditor) 或 Dataplex Catalog Admin (roles/dataplex.catalogAdmin) 角色。如需了解详情，请参阅上下文集权限。

向 AlloyDB for PostgreSQL 实例授予 executesql 权限

如需向 AlloyDB for PostgreSQL 实例授予 executesql 权限并将 data_api_access 实例设置设为值 ALLOW_DATA_API，请使用以下 curl 命令： 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
替换以下内容：
  • PROJECT_ID：您的 Google Cloud 项目的 ID。
  • LOCATION：AlloyDB 集群所在的区域。
  • CLUSTER_ID：AlloyDB 集群的 ID。
  • INSTANCE_ID：AlloyDB 实例的 ID。
如需执行本教程中的步骤，请登录 Google Cloud，然后使用 IAM 身份验证对数据库进行身份验证。

创建上下文集

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

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

    前往 AlloyDB

  2. 从列表中选择一个集群。

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

  4. 使用 IAM 身份验证登录 AlloyDB Studio。

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

  6. 点击创建上下文集。

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

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

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

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

  11. 点击创建。

构建上下文集

创建上下文集后，请按照使用 Gemini CLI 构建上下文中的步骤创建上下文集文件。然后，您可以修改上下文集，以上传上下文集文件。

修改上下文集

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

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

    前往 AlloyDB

  2. 从列表中选择一个集群。

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

  4. 使用 IAM 身份验证登录 AlloyDB Studio。

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

  6. 点击修改上下文集。

  7. 可选。修改上下文集说明。

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

  9. 点击保存。

删除上下文集

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

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

    前往 AlloyDB

  2. 从列表中选择一个集群。

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

  4. 使用 IAM 身份验证登录 AlloyDB Studio。

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

  6. 点击删除上下文集。

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

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

后续步骤