本文档介绍了如何在 Spanner 中创建、修改和删除对话。对话是 与 数据代理的持久聊天。
您可以向数据代理提出包含常用术语(例如“销售额”或“最受欢迎”)的多部分问题,而无需指定表字段名称或定义条件来过滤数据。聊天回复会以文本和代码的形式提供问题的答案,并会在适当的时候生成图表。回答还包含结果背后的推理。
您可以创建与数据代理的对话。当您创建直接 对话时, Conversational Analytics API 会在没有数据代理提供的上下文和处理指令的情况下解读您的问题。
准备工作
-
验证是否已为您的 Google Cloud 项目启用结算功能。
-
启用 Spanner、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs。
启用 API 所需的角色
如需启用 API,您需要拥有 Service Usage Admin IAM 角色 (
roles/serviceusage.serviceUsageAdmin),该角色包含serviceusage.services.enable权限。了解如何授予 角色。
所需的角色
如需使用数据代理,您必须拥有以下 Conversational Analytics API Identity and Access Management (IAM) 角色之一:
- 使用
QueryData方法从受支持的数据库来源查询数据:项目级 Gemini Data Analytics Data Query User (roles/geminidataanalytics.queryDataUser)。 - 在项目中创建、修改、共享和删除所有数据代理:项目级 Gemini Data Analytics Data Agent Owner (
roles/geminidataanalytics.dataAgentOwner)。 - 在项目中创建自己的数据代理:项目级 Gemini Data Analytics Data Agent Creator (
roles/geminidataanalytics.dataAgentCreator)。此角色会自动授予您对所创建数据代理的 Gemini Data Analytics Data Agent Owner 角色。 - 查看和修改项目中的所有数据代理:项目级 Gemini Data Analytics Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor)。 - 查看项目中的所有数据代理:项目级 Gemini Data Analytics Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer)。
此外,您还必须拥有以下角色才能创建或修改数据代理:
- 已添加到集群的 IAM 用户或服务帐号。如需了解详情, 请参阅 应用 IAM 角色。
- 在项目级授予 IAM 用户的
spanner.databaseReader角色。如需了解详情,请参阅 为项目添加 IAM 政策绑定。 - 在项目级授予 IAM 用户所需数据库的角色和权限。如需了解详情,请参阅 授予角色和权限。
如需使用 Spanner 资源,请参阅 Spanner 角色和权限。
创建对话
您可以在 Spanner 的 控制台 Google Cloud 中,通过 代理 页面上的 代理目录 标签页,创建与代理或数据源的持久对话。
创建与数据代理的对话
如需创建与数据代理的对话,您首先需要 创建数据代理 并发布它。您还可以与他人分享给您的代理发起对话。
如需在 Google Cloud 控制台中创建与数据代理的对话,请按以下 步骤操作:
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击代理 。
在我的代理 或组织中的其他人分享的代理 部分中,点击要与之对话的代理的代理卡片。
点击开始对话 。系统会打开一个新的聊天面板。
在提问 字段中,输入要向数据代理提出的问题。 例如,“上个季度的总销售额是多少?”或“按会话时长显示前 5 名用户”。 您还可以点击 Gemini 建议的问题之一来开始对话。
数据代理会先说明其为回答您的问题而采取的操作,然后返回结果。
如需查看数据代理为回答您的问题而采取的每个步骤,请点击显示推理 以查看代理推理过程中的每条消息。
如需查看有关结果计算方式的信息,请点击 这是如何计算的? 摘要 部分现在包含生成的查询,后跟查询结果。您可以复制代码,然后点击 Studio 将代码粘贴到查询编辑器中。
如果数据适合,数据代理会提供图表、表格和其他可视化内容。 如需查看聊天记录,请前往对话管理 列表。
如需查看代理信息,请前往详细信息 面板。此面板包含代理及其知识来源的说明。
管理对话
您可以在代理 页面上打开、重命名或删除对话。
打开现有对话
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击代理 。
在对话 标签页的对话列表中,点击要打开的对话。
重命名对话
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击代理 。
在对话 标签页的对话列表中,点击要重命名的对话。
依次点击 查看操作 > 重命名。
在重命名对话 对话框中,在对话名称 字段中输入对话的新名称。
点击重命名 。
删除对话
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击代理 。
在对话 标签页的对话列表中,点击要删除的对话。
依次点击 查看操作 > 删除 。
在是否删除对话? 对话框中,点击删除 。
位置
对话式分析在全球范围内运行,您无法选择要使用的区域。
后续步骤
- 详细了解 Spanner 中的 对话式分析。
- 详细了解 Conversational Analytics API。
- 在 Spanner 中创建数据代理。