Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

在 Cloud SQL Studio 中管理上下文集

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

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

准备工作

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

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

确保您有权访问现有 Cloud SQL 实例或创建一个新实例。如需了解详情，请参阅为 Cloud SQL 创建实例。

本教程要求您在 Cloud SQL 实例中有一个数据库。如需了解详情，请参阅在 Cloud SQL 实例上创建数据库。

将 IAM 用户或服务账号添加到实例。如需了解详情，请参阅使用 Cloud SQL 的 IAM 数据库身份验证管理用户。
在项目级向 IAM 用户授予 cloudsql.studioUser、cloudsql.instanceUser 和 geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅为项目添加 IAM 政策绑定。
如需创建、上传和管理上下文集，请在项目级向 IAM 用户授予 Dataplex Catalog Editor (roles/dataplex.catalogEditor) 或 Dataplex Catalog Admin (roles/dataplex.catalogAdmin) 角色。如需了解详情，请参阅上下文集权限。
您还必须以具有超级用户权限的用户（例如 postgres 用户）身份登录，向 IAM 用户或服务账号授予只读数据库权限。

GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;

将 USER_NAME 替换为用户的邮箱。您必须使用英文引号括住电子邮件地址，因为它包含特殊字符（@ 和 .）。

如需了解详情，请参阅向单个 IAM 用户或服务账号授予数据库权限。

如需向 Cloud SQL 实例授予 executesql 权限并启用 Cloud SQL Data API，请运行以下命令：

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

替换以下内容：

如需执行本教程中的步骤，请登录 Google Cloud，然后使用 IAM 身份验证向数据库进行身份验证。

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

在 Google Cloud 控制台中，前往 Cloud SQL 页面。

前往 Cloud SQL
从列表中选择一个实例。
在导航菜单中，点击 Cloud SQL Studio。
使用 IAM 身份验证登录Studio。
在“探索器”窗格中，点击上下文集旁边的查看操作。
点击创建上下文集。
在上下文集名称中，提供唯一的上下文集名称。上下文集名称区分大小写，可以包含字母、数字、连字符和下划线。名称长度必须为 4-30 个字符。

上下文集 ID 派生自上下文集名称，但不一定完全相同。对于上下文集 ID，上下文集名称会转换为小写，非字母数字字符会替换为 - 字符。例如，上下文集名称 querydata_e2e_test 的上下文集 ID 为 querydata-e2e-test。
可选。在上下文集说明中，为上下文集添加说明。
可选。如需上传上下文集文件，请点击上传上下文集文件部分中的浏览，然后选择上下文集文件。
点击创建。

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

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

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