在 AlloyDB Studio 中管理上下文集

本文档介绍了如何在 AlloyDB for PostgreSQL Studio 中使用上下文集文件创建上下文集。上下文集名称在项目中必须是唯一的。

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

准备工作

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

启用必需服务

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

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

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

所需的角色和权限

  • 在数据库级别向集群添加 Identity and Access Management (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 身份验证登录Studio。

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

  6. 点击创建上下文集。

  7. 在上下文集名称中，提供唯一的上下文集名称。上下文集名称区分大小写，可以包含字母、数字、连字符和下划线。名称长度必须为 4-30 个字符。

    上下文集 ID 派生自上下文集名称，但不一定完全相同。对于上下文集 ID，上下文集名称会转换为小写，非字母数字字符会替换为 - 字符。例如，上下文集名称 querydata_e2e_test 的上下文集 ID 为 querydata-e2e-test。

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

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

  10. 点击创建。

构建上下文集

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

修改上下文集

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

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

    前往 AlloyDB

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

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

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

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

  6. 点击修改上下文集。

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

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

  9. 点击保存。

删除上下文集

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

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

    前往 AlloyDB

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

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

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

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

  6. 点击删除上下文集。

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

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

后续步骤