通过对话分析数据

本文档介绍了如何在 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 数据代理所有者角色。
  • 如需修改、共享或删除数据代理，您需要拥有该代理或项目的 Gemini Data Analytics 数据代理所有者 (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 权限。
  • 数据库权限：控制对数据库中对象（例如表、视图和架构）的访问权限。这些权限通过 SQL 命令（例如 GRANT）以及特定于数据库的用户和角色系统进行管理。

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

创建对话

您可以在 Cloud SQL for PostgreSQL 的 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. 在删除对话？对话框中，点击删除。

位置

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

后续步骤