在 AlloyDB Studio 中管理上下文集

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

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

准备工作

在创建代理之前，请完成以下前提条件。

启用必需服务

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

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

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

所需的角色和权限

  • 在数据库级层将 Identity and Access Management (IAM) 用户或服务账号添加到集群。如需了解详情，请参阅管理数据库用户。
  • 在项目级层向 IAM 用户授予 alloydb.databaseUser、serviceusage.serviceUsageConsumer 和 geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅为项目添加 IAM 政策绑定。

向 AlloyDB for PostgreSQL 实例授予 executesql 权限

如需向 AlloyDB for PostgreSQL 实例授予 executesql 权限并将 data_api_access 实例设置设为值 ALLOW_DATA_API，请使用以下 curl 命令：
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth 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. 在上下文集名称中，提供唯一的上下文集名称。上下文集名称区分大小写，并且可以包含字母、数字、连字符和下划线。

  8. 可选。在情境集说明中，为情境集添加说明。

  9. 点击创建。

构建上下文集

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

修改上下文集

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

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

    前往 AlloyDB

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

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

  4. 使用 Identity and Access Management 身份验证登录Studio。

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

  6. 点击修改情境集。

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

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

  9. 点击保存。

删除上下文集

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

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

    前往 AlloyDB

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

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

  4. 使用 Identity and Access Management 身份验证登录Studio。

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

  6. 点击删除上下文集。

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

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

后续步骤