通过对话分析数据
本文档介绍了如何在 BigQuery 中创建、修改和删除对话。对话是指用户与数据代理或数据源的持续聊天。 用户可以向数据代理提出包含“销售额”或“最受欢迎”等常用字词的多部分问题,而无需指定表字段名称或定义过滤数据的条件。返回给用户的聊天回答以文本和代码的形式提供用户问题的答案,并在适当的情况下生成图表。回答还包含结果背后的推理。
您可以创建与数据代理的对话,也可以创建与一个或多个表的直接对话。创建直接对话时,Conversational Analytics API 会在没有数据代理提供的上下文和处理指令的情况下解读您的问题。
准备工作
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud 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 Google Cloud project.
-
Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud 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。
- 创建数据代理。