在 Cloud SQL Studio 中管理上下文集

本文档介绍如何使用上下文集文件在 Cloud SQL for MySQL Studio 中创建上下文集。上下文集名称在数据库中必须保持唯一。

准备工作

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

启用必需服务

• Data Analytics API with Gemini
• Gemini for Google Cloud API
• Knowledge Catalog API

准备 Cloud SQL 实例

• 确保您有权访问现有 Cloud SQL 实例或创建新实例。 如需了解详情，请参阅为 Cloud SQL创建实例。
• 确保在实例中创建数据库，您将在其中创建表。如需了解详情，请参阅在 Cloud SQL 实例上创建数据库。

所需的角色和权限

• 在实例级添加 IAM 用户或服务帐号。如需了解详情，请参阅向用户、服务帐号或群组添加 IAM 政策绑定。
• 在项目级向 IAM 用户或服务帐号授予 cloudsql.studioUser、cloudsql.instanceUser 和 geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅添加 项目的 IAM 政策绑定。
• 您必须让具有特权的用户向 IAM 用户或服务账号授予数据库权限。
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";。
  
  如需了解 详情，请参阅向 单个 IAM 用户或服务账号授予数据库权限。

向 Cloud SQL 实例授予 executesql 权限

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

• PROJECT_ID：您的 Google Cloud 项目的 ID。
• INSTANCE_ID：Cloud SQL 实例的 ID。

创建上下文集

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

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

   前往 Cloud SQL

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

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

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

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

6. 点击创建上下文集 。

7. 在上下文集名称中，提供唯一的上下文集名称。上下文集名称区分大小写，并且可以包含字母、数字、连字符和下划线。

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

9. 点击创建 。

构建上下文集

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

修改上下文集

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

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

   前往 Cloud SQL

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

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

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

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

6. 点击修改上下文集 。

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

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

9. 点击保存 。

删除上下文集

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

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

   前往 Cloud SQL

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

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

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

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

6. 点击删除上下文集 。

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

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

后续步骤

• 详细了解上下文集。
• 了解如何测试上下文集。
• 了解如何使用 Gemini CLI 构建上下文。