通过对话分析数据

本文档介绍了如何在 Cloud SQL for PostgreSQL 中创建、修改和删除对话。对话是指与数据代理进行的持久聊天。

您可以向数据代理提出使用常用术语（例如“销售额”或“最受欢迎”）的多部分问题，而无需指定表字段名称或定义用于过滤数据的条件。聊天回答会以文本和代码的形式提供问题的答案，并在适当的时候生成图表。回答还包含结果背后的推理。

您可以创建与数据代理的对话。当您创建直接对话时，Conversational Analytics API 会在没有数据代理提供的上下文和处理指令的情况下解读您的问题。

准备工作

  1. 验证是否已为您的 Google Cloud 项目启用结算功能。

  2. 启用 Cloud SQL、Data Analytics API with Gemini 和 Gemini for Google Cloud API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

    启用 API

所需的角色

如需使用数据智能体，您必须拥有与您的使用情形相符的 IAM 权限。下表列出了所需角色，具体取决于您是创建和发布代理、在 Gemini Enterprise 中预配代理，还是发现和使用代理。如需了解详情，请参阅 Conversational Analytics API IAM 角色。

使用场景 所需的角色
创建、修改、发布、共享和删除代理
  • 在项目中创建数据代理：项目中的 Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator)。此角色会自动授予您所创建数据代理的 Gemini Data Analytics Data Agent Owner 角色。
  • 如需修改、共享或删除数据代理，您需要拥有该代理或项目的 Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) 角色。
  • 如需在项目中修改数据代理，您需要拥有以下角色：针对项目的 Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor)。
  • 如需查看项目中的数据代理，请为项目授予 Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) 权限。
  • 此外，您还必须拥有以下角色才能创建或修改数据代理：
在 Gemini Enterprise 中配置智能体

如要让已发布的代理可供 Gemini Enterprise 中的用户使用，您需要在 Gemini Enterprise 管理控制台中拥有注册和管理 A2A 代理的权限。
发现和使用智能体
  • 如需与数据代理对话，请使用 Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser)。
  • 如需查看项目中的所有数据代理，请使用 Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer)。

在管理对 Cloud SQL for PostgreSQL 数据库资源的访问权限时，请考虑以下权限层级：

  • Google Cloud IAM：控制对数据库实例（作为云资源）的访问权限。这包括连接、管理实例和执行 SQL 查询的权限，例如使用 executeSql 权限。
  • 数据库权限：控制对数据库中对象（例如表、视图和架构）的访问权限。这些权限通过 GRANT 等 SQL 命令以及特定于数据库的用户和角色系统进行管理。

对于 Cloud SQL for PostgreSQL，您需要具有适当的 Cloud SQL IAM 角色才能连接到实例并获得发送查询的授权。如需与表和视图等对象进行交互，连接的数据库用户必须拥有使用 Cloud SQL for PostgreSQL GRANT 系统授予的必要权限。如需了解详情，请参阅 PostgreSQL 用户和角色简介。 如果代理使用服务账号，您可以获取分配的数据库角色。例如，请参阅使用 IAM 数据库身份验证管理用户。

创建对话

您可以在 Google Cloud 控制台中，通过代理目录标签页上的代理页面，与代理或数据源创建持久对话。

创建与数据代理的对话

如需创建与数据代理的对话，您必须先创建数据代理并发布它。您还可以与他人分享给您的代理发起对话。

如需在 Google Cloud 控制台中创建与数据代理的对话，请按以下步骤操作：

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

    前往 Cloud SQL

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

  3. 在导航菜单中，点击代理。

  4. 在我的代理或组织中其他用户分享的代理部分中，点击要与之对话的代理的代理卡片。

  5. 点击开始对话。系统随即会打开一个新的聊天面板。

  6. 在提问字段中，输入要向数据代理提出的问题。 例如，“我们上季度的总销售额是多少？”或“按会话时长显示前 5 名用户”。您也可以点击 Gemini 建议的问题之一来开始对话。

    数据代理会先说明其正在采取哪些行动来回答您的问题，然后返回结果。

    如需查看数据智能体为回答您的问题而采取的每个步骤，请点击显示推理过程，以查看智能体推理过程中的每条消息。

    如需查看有关结果计算方式的信息，请点击 这是如何计算出来的？ 摘要部分现在包含生成的查询以及查询结果。您可以复制代码，然后点击 Studio，将代码粘贴到查询编辑器中。

    如果数据适合，数据代理会提供图表、表格和其他可视化图表。 如需查看聊天记录，请前往对话管理列表。

    如需查看代理信息，请前往详细信息面板。此面板包含代理及其知识来源的说明。

管理会话

您可以在代理页面中打开、重命名或删除对话。

打开现有对话

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

    前往 Cloud SQL

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

  3. 在导航菜单中，点击代理。

  4. 在对话标签页的对话列表中，点击要打开的对话。

重命名对话

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

    前往 Cloud SQL

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

  3. 在导航菜单中，点击代理。

  4. 在对话标签页的对话列表中，点击要重命名的对话。

  5. 依次点击 查看操作 > 重命名。

  6. 在重命名对话对话框中，在对话名称字段中为对话输入新名称。

  7. 点击重命名。

删除对话

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

    前往 Cloud SQL

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

  3. 在导航菜单中，点击代理。

  4. 在对话标签页的对话列表中，点击要删除的对话。

  5. 依次点击 查看操作 > 删除。

  6. 在删除对话？对话框中，点击删除。

位置

对话式分析在全球范围内运行，因此您无法选择要使用的区域。

后续步骤