本文档介绍了如何在 Spanner Studio 中使用上下文集文件创建上下文集。上下文集名称在项目中必须是唯一的。
如需了解上下文集，请参阅上下文集概览。准备工作
在创建智能体之前，请完成以下前提条件。
启用必需服务
为您的项目启用以下服务：准备 Spanner 实例
- 确保有可用的 Spanner 实例。如需了解详情，请参阅创建实例。
- 确保在实例中创建数据库，以便在其中创建表。如需了解详情，请参阅在 Spanner 实例上创建数据库
本教程要求您的 Spanner 实例中有一个数据库。如需了解详情，请参阅创建数据库。
所需的角色和权限
- 将 IAM 用户或服务账号添加到集群。如需了解详情，请参阅应用 IAM 角色。
- 在项目级层向 IAM 用户授予
spanner.databaseReader和geminidataanalytics.queryDataUser角色。如需了解详情，请参阅为项目添加 IAM 政策绑定。 - 如需创建、上传和管理上下文集，请在项目级层向 IAM 用户授予 Dataplex Catalog Editor (
roles/dataplex.catalogEditor) 或 Dataplex Catalog Admin (roles/dataplex.catalogAdmin) 角色。如需了解详情，请参阅上下文集权限。 - 在项目级层向 IAM 用户授予角色和权限，以便其访问所需的数据库。
创建上下文集
如需创建上下文集，请执行以下步骤：
在 Google Cloud 控制台中，前往 Spanner 页面。
从列表中选择一个实例，然后选择一个数据库。
在导航菜单中，点击 Spanner Studio。
在“探索器”窗格中，点击上下文集旁边的查看操作。
点击创建上下文集。
在上下文集名称中，提供唯一的上下文集名称。上下文集名称区分大小写，可以包含字母、数字、连字符和下划线。名称长度必须为 4-30 个字符。
上下文集 ID 派生自上下文集名称，但不一定完全相同。对于上下文集 ID，上下文集名称会转换为小写，非字母数字字符会替换为
-字符。例如，上下文集名称querydata_e2e_test的上下文集 ID 为querydata-e2e-test。可选。在上下文集说明中，为上下文集添加说明。
可选。如需上传上下文集文件，请点击上传上下文集文件部分中的浏览，然后选择上下文集文件。
点击创建。
构建上下文集
创建上下文集后，请按照使用 Gemini CLI 构建上下文中的步骤创建上下文集文件。然后，您可以修改上下文集，以上传上下文集文件。
修改上下文集
如需修改上下文集，请执行以下步骤：
在 Google Cloud 控制台中，前往 Spanner 页面。
从列表中选择一个实例，然后选择一个数据库。
在导航菜单中，点击 Spanner Studio。
点击要修改的上下文集旁边的查看操作。
点击修改上下文集。
可选。修改上下文集说明。
点击上传上下文集文件部分中的浏览，然后选择上下文集文件。
点击保存。
删除上下文集
如需删除上下文集，请执行以下步骤：
在 Google Cloud 控制台中，前往 Spanner 页面。
从列表中选择一个实例，然后选择一个数据库。
在导航菜单中，点击 Spanner Studio。
点击要删除的上下文集旁边的查看操作。
点击删除上下文集。
在删除上下文集确认对话框中，输入上下文集的 ID。
点击确认以删除上下文集。
后续步骤
- 详细了解情境集。
- 了解如何测试情境集。
- 了解如何使用 Gemini CLI 构建上下文。