通过对话分析数据
本文档介绍了如何在 BigQuery 中创建、修改和删除对话。对话是指用户与数据代理或数据源的持续聊天。 用户可以向数据代理提出包含“销售额”或“最受欢迎”等常用字词的多部分问题,而无需指定表字段名称或定义过滤数据的条件。返回给用户的聊天回答以文本和代码的形式提供用户问题的答案,并在适当的情况下生成图表。回答还包含结果背后的推理。
您可以创建与数据代理的对话,也可以创建与一个或多个表的直接对话。创建直接对话时,Conversational Analytics API 会在没有数据代理提供的上下文和处理指令的情况下解读您的问题。
准备工作
-
In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Cloud de Confiance project.
-
Enable the BigQuery, Gemini Data Analytics, and Gemini for Cloud de Confiance by S3NS API APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.
所需的角色
如需创建对话,您必须拥有以下 Conversational Analytics API IAM 角色之一:
- 查看并创建与已与您共享的任何数据代理的对话:项目级 Gemini Data Analytics Data Agent User (
roles/geminidataanalytics.dataAgentUser)。 - 创建直接对话:Gemini Data Analytics Stateless Chat User (
roles/geminidataanalytics.dataAgentStatelessUser)
此外,创建对话的任何用户都必须具备以下角色:
- 针对数据代理用作数据源的任何表的 BigQuery Data Viewer (
roles/bigquery.dataViewer)。 - 如果数据源表使用列级访问权限控制,则需要对相应政策标记具有 Fine-Grained Reader (
roles/datacatalog.categoryFineGrainedReader) 权限。如需了解详情,请参阅用于列级访问权限控制的角色。 - 如果数据源表使用行级访问权限控制,您必须被授予该表的角色级访问权限政策。如需了解详情,请参阅创建或更新行级访问权限政策。
- 如果数据源表使用数据遮盖,则需要在相应的数据政策中添加 Masked Reader (
roles/bigquerydatapolicy.maskedReader)。如需了解详情,请参阅用于查询屏蔽数据的角色。
如果对话用户在数据代理使用的源数据表上没有适当的角色,则当用户与数据代理对话时,系统会返回以下错误:
Schema_Resolution: Access Denied
创建与数据代理的对话
按照以下步骤创建与数据代理的对话。您必须先创建数据代理,然后才能发起与数据代理的对话。
前往 BigQuery 代理页面。
在对话标签页的与数据对话窗格中,点击要与之对话的数据代理的代理卡片。系统会打开对话页面。
在提出问题字段中,输入您希望数据代理回答的问题。您也可以点击 Gemini 建议的问题之一来开始对话。
数据代理会做出回应,说明其正在采取哪些措施来解答您的问题,然后返回结果。
如需查看数据代理执行的步骤,请点击查看步骤。
如需查看有关结果计算方式的信息,请点击 How was this calculated?(这是如何计算出来的?):
文本标签页描述了生成的代码,而代码标签页则提供了生成的代码:
如果数据适合,数据代理还会提供图表、表格和其他可视化图表。
创建与数据源的直接对话
如需创建与数据源的直接对话,请按以下步骤操作:
前往 BigQuery 代理页面。
在对话标签页的使用数据聊天窗格中,点击数据源。
选择一个或多个表格,然后点击创建对话。
在提出问题字段中,输入您希望数据代理回答的问题。您也可以点击 Gemini 建议的问题之一来开始对话。
Conversational Analytics API 会处理您的问题并返回结果。
如需查看 Conversational Analytics API 采取的步骤,请点击查看步骤。
如需查看有关结果计算方式的信息,请点击 How was this calculated?(这是如何计算出来的?):
文本标签页描述了生成的代码,而代码标签页则提供了生成的代码:
打开现有对话
如需打开对话,请按以下步骤操作:
前往 BigQuery 代理页面。
在对话标签页的对话列表中,点击要打开的对话。
重命名对话
如需重命名对话,请按以下步骤操作:
前往 BigQuery 代理页面。
在对话标签页的对话列表中,点击要重命名的对话。
依次点击 查看操作 > 重命名。
在重命名对话对话框中,在对话名称字段中输入对话的新名称。
点击重命名。
删除对话
如需删除对话,请按以下步骤操作:
前往 BigQuery 代理页面。
在对话标签页的对话列表中,点击要重命名的对话。
点击 查看操作 > 删除。
在删除对话?对话框中,点击删除。
位置
对话式分析在全球范围内运行,因此您无法选择要使用的区域。
后续步骤
- 详细了解 BigQuery 中的对话式分析。
- 详细了解 Conversational Analytics API。
- 创建数据代理。