创建数据代理

借助对话式数据智能体，您可以使用自然语言界面与数据库数据进行交互。通过构建这些智能体，您可以帮助用户“与数据对话”，从而从运营数据库中获取洞见，而无需编写复杂的 SQL 查询。

从宏观层面来看，数据智能体是角色、一组数据源的组合，并且可以访问一组对其用途至关重要的业务知识。

对于应用开发者，这些智能体具有以下优势：

  • 准确率高：通过使用编写的上下文，您可以针对特定的业务问题获得很高的准确率。编写的上下文是智能体创建者可以用来提高准确率的主要因素。 它包括架构说明、系统指令和结构化上下文，可提供有关预期数据库查询的额外信息。
  • 复杂性降低：智能体将自然语言转换为 SQL 查询、执行，甚至是数据汇总或可视化。
  • 灵活性：您可以为个人测试起草智能体，也可以发布智能体，以便项目中的其他用户可以使用智能体，或者使用 API 以编程方式使用智能体。

准备工作

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

  2. 启用 AlloyDB for PostgreSQL、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs。

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您 创建了项目，则可能已通过 所有者角色 (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)。
  • 此外，您还必须拥有以下角色才能创建或修改数据智能体：
    • 在数据库级别添加到集群的 IAM 用户或服务帐号。如需了解详情，请参阅管理数据库用户。
    • 在项目级别授予 IAM 用户的 alloydb.databaseUser 角色和 serviceusage.serviceUsageConsumer 权限。如需了解详情，请参阅为项目添加 IAM 政策绑定。
在 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)。

如需使用 AlloyDB 资源（例如查看表或运行查询），请参阅 适用于 AlloyDB 的 IAM 角色和权限。

创建数据智能体

以下部分介绍了如何创建数据智能体。 创建智能体后，您可以修改其设置。

配置基本信息

  1. 在 Google Cloud 控制台中，前往 AlloyDB 页面。

    前往 AlloyDB

  2. 从列表中选择一个集群。

  3. 在导航菜单中，点击智能体 。

  4. 点击智能体 标签页。

  5. 选择数据库，然后使用 IAM 账号登录。

  6. 点击新建智能体 。系统会打开新建智能体 页面。

  7. 在 编辑器 部分的 智能体名称 字段中，输入数据智能体的 描述性名称，例如 Q4 sales data 或 User activity logs。

  8. 在智能体说明 字段中，输入数据智能体的说明。好的说明应解释智能体的功能、使用的数据，并帮助您确定这是否是适合用于对话的数据智能体，例如 What are the top 10 selling products in Q2?

  9. 在知识来源 部分，点击添加来源 。系统会打开添加数据 页面。

  10. 选择智能体在回答问题时将重点关注的表。如需查看其他 知识来源，请选择 显示更多。

  11. 点击添加 。系统会重新打开“新建智能体”页面。

自定义表和字段说明

如需提高对话式数据智能体的准确率，您可以选择性地提供其他表元数据。只有数据智能体会使用此元数据，它不会影响源表。您可以添加以下元数据：

  • 架构说明： 为表和列添加说明，以帮助智能体了解您的数据。如果您未添加说明，智能体将使用数据定义中的架构说明。

添加表和字段说明时，请遵循以下最佳实践：

  • 将说明添加到数据定义，而不是仅添加到数据智能体定义。这样可确保其他智能体也能受益于这些说明。
  • 如需为数据智能体提供合适的说明以帮助其了解您的数据，请为特定智能体添加说明。验证说明是否具有预期效果后，您可以决定是否在数据定义中添加该说明。

如需配置表和字段说明，请按以下步骤操作：

  1. 在智能体目录 标签页中，打开要自定义的智能体。
  2. 点击修改智能体 。
  3. 在知识来源 中，找到要自定义的表，然后点击自定义 。
  4. 输入表说明。
  5. 如需修改任何字段说明，请点击该字段旁边的“修改”图标 Edit 。系统会打开修改字段 窗格。
    1. 在 ID 字段中，输入字段说明。
    2. 如需保存字段说明，请点击更新 。
  6. 如需保存说明和字段更新，请点击更新 。系统会重新打开“新建智能体”页面。
  7. 针对要自定义的每个表重复上述步骤。

为数据智能体添加标签

在智能体设置 部分，您可以 创建标签来整理 Google Cloud 资源。标签是键值对 ，可用于将相关对象组合在一起或者与其他 Google Cloud 资源组合在一起。

  1. 在智能体目录 标签页中，打开要向其添加标签的智能体。
  2. 点击修改智能体 。
  3. 在智能体设置 部分，点击添加标签 。系统会打开管理标签 窗格。
  4. 点击添加标签 。
  5. 在键 和值 字段中，输入标签的键值对。
  6. 如果您想添加更多标签，请再次点击添加标签 。
  7. 如需删除标签，请点击“删除”图标 delete。
  8. 完成后，点击添加 。系统会重新打开“新建智能体”页面。

请继续阅读下一部分，了解如何将智能体置于草稿模式或发布智能体。

预览并发布智能体

  1. 在预览 部分的提问 字段中，输入示例问题，然后按 Enter 。

    如需验证数据智能体是否返回了您预期的数据，请检查智能体的回答。如果回答不是您预期的内容，请在编辑器 部分中更改设置，以优化数据智能体配置，直到获得令人满意的回答。您可以继续测试和修改智能体，以优化智能体的结果。

  2. 点击保存 。

  3. 如需将数据智能体置于草稿模式（您可以稍后重新修改）， 请点击 返回 ，返回到 智能体目录 页面。 由于您的智能体现在处于草稿模式，因此它会显示在智能体目录 标签页的我的智能体草稿 部分中。

    如需发布智能体，请停留在智能体创建页面，然后继续执行下一步。

  4. 如需发布数据智能体并使其可在项目中供使用，请点击发布 。发布智能体后，其他有权访问同一数据库表的用户可以查看您的智能体并与之对话，从而受益于您创建的指令和上下文。

    您可以使用 控制台中的智能体页面与数据智能体创建对话。 Google Cloud 您还可以使用 Conversational Analytics API 构建自己的界面，与数据智能体对话。

  5. 可选：在您的智能体已发布 对话框中，点击共享 以与其他用户共享数据智能体。

    1. 在共享权限 窗格中，点击添加主账号 。
    2. 在新的主账号 字段中，输入一个或多个主账号。
    3. 点击选择角色 列表。
    4. 在角色 列表中，选择以下角色之一：
      • Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser)：授予与数据智能体对话的权限。
      • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor)：授予修改数据智能体的权限。
      • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer)：授予查看数据智能体的权限。
    5. 点击保存 。

  6. 可选：您可以将数据智能体发布到 Gemini Enterprise。如需了解详情，请参阅在 Gemini Enterprise中发布数据智能体。

  7. 如需返回“新建智能体”页面，请点击关闭 。保存或发布智能体后，您可以在智能体目录 中看到它。

管理数据智能体

您可以在智能体目录 标签页中找到现有智能体，该标签页包含三个部分：

  • 我的智能体：您创建和发布的所有智能体的列表。您可以修改已发布的智能体并与他人共享。
  • 我的智能体草稿：您尚未发布的智能体。您无法共享智能体草稿。
  • 您组织中的其他人分享的智能体：其他人创建并 与您共享的智能体。如果其他人授予您权限，您可以修改这些共享的智能体。

修改数据智能体

如需修改数据智能体，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 AlloyDB 页面。

    前往 AlloyDB

  2. 从列表中选择一个集群。

  3. 在导航菜单中，点击智能体 。

  4. 使用 Identity and Access Management (IAM) 身份验证登录智能体 。

  5. 点击智能体目录 标签页。

  6. 找到要修改的数据智能体的智能体卡片。

  7. 如需在智能体编辑器中打开数据智能体，请依次点击 打开操作 和智能体卡片上的修改 。

  8. 根据需要修改数据智能体的配置。

  9. 如需保存更改但不发布，请点击保存 。

  10. 如需发布更改，请点击发布 。在共享 对话框中，您可以与其他用户共享智能体，也可以点击取消 。

  11. 如需返回智能体 窗格，请点击 返回。

共享数据智能体

如需共享已发布的数据智能体，请按以下步骤操作。您无法共享智能体草稿。

  1. 在 Google Cloud 控制台中，前往 AlloyDB 页面。

    前往 AlloyDB

  2. 从列表中选择一个集群。

  3. 在导航菜单中，点击智能体 。

  4. 使用 Identity and Access Management (IAM) 身份验证登录智能体 。

  5. 点击智能体目录 标签页。

  6. 找到要修改的数据智能体的智能体卡片。

  7. 如需在智能体编辑器中打开数据智能体，请依次点击 打开 操作 > 智能体卡片上的修改。

  8. 如需与其他用户共享数据智能体，请点击共享 。

  9. 在共享权限 窗格中，点击添加主账号 。

  10. 在添加主账号 字段中，输入一个或多个主账号。

  11. 点击选择角色 。

  12. 在角色 列表中，选择以下角色之一：

    • Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser)：授予与数据智能体对话的权限。
    • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor)：授予修改数据智能体的权限。
    • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer)：授予查看数据智能体的权限。

  13. 点击保存 。

  14. 如需返回智能体修改页面，请点击关闭 。

  15. 如需返回智能体 窗格，请点击 返回 。

删除数据智能体

  1. 在 Google Cloud 控制台中，前往 AlloyDB 页面。

    前往 AlloyDB

  2. 从列表中选择一个集群。

  3. 在导航菜单中，点击智能体 。

  4. 使用 Identity and Access Management (IAM) 身份验证登录智能体 。

  5. 选择智能体目录 标签页。

  6. 在智能体目录 标签页的智能体 部分中，找到要删除的数据智能体的智能体卡片。

  7. 依次点击 打开操作 > 删除。

  8. 在删除智能体？ 对话框中，点击删除 。删除智能体会从项目中永久移除该智能体。

    删除智能体后，现有对话将以“只能查看”模式显示。 您无法向已删除的智能体提出新问题。

在 Gemini Enterprise 中发布数据智能体

发布数据智能体需要数据分析师、Gemini Enterprise 管理员和业务用户之间的协作。如需了解这些用户所需的角色，请参阅所需角色。

创建和发布智能体

如需创建、修改和发布智能体，请按以下步骤操作：

  1. 创建或修改您在 AlloyDB 中的数据智能体。
  2. 发布智能体。发布智能体时，请选择 Gemini Enterprise 作为发布选项。
  3. 如需复制 A2A 端点 JSON，请点击 Copy JSON 。
  4. 与 Gemini Enterprise 管理员共享 A2A 端点 JSON 和用户列表，以便他们可以在 控制台 Google Cloud 中注册自定义智能体并配置访问权限。 如需了解详情，请参阅预配智能体。
  5. 与需要 访问权限的用户和群组共享智能体。

预配智能体

如需让已发布的智能体可供控制台中的用户使用，请按以下步骤操作： Google Cloud

  1. 在 Google Cloud 控制台中，前往 Gemini Enterprise。

    Gemini Enterprise

  2. 点击要向其注册智能体的应用的名称。

  3. 依次点击智能体 > 添加智能体。

  4. 在选择智能体类型 部分，对于通过 A2A 构建的自定义智能体 ，点击添加 。

  5. 在智能体卡片 JSON 字段中，以 JSON 格式输入您之前从数据分析师处收到的智能体卡片详细信息。

  6. 点击预览智能体详细信息 > 下一步 。

  7. 如需让智能体代表您访问 Google Cloud 资源， 请按以下步骤操作：

    1. 输入您在 配置授权详细信息 部分中生成的客户端 ID 和客户端密钥。

    2. 在授权 URI 字段中，输入以下内容：

      https://accounts.google.com/o/oauth2/v2/auth?client_id=client_id&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent

      将 client_id 替换为您在 配置授权 详细信息中生成的客户端 ID。

    3. 在令牌 URI 字段中，输入以下内容：

      https://oauth2.googleapis.com/token

    4. 在范围 字段中，输入以下内容：

      https://www.googleapis.com/auth/cloud-platform

  8. 点击完成 。

  9. 共享智能体 与用户或群组。

如需了解详情，请参阅注册和管理 A2A 智能体。

查找和使用智能体

您可以使用以下任一方法在 Gemini Enterprise 中查找和使用数据智能体：

  • 在 Agent Gallery中找到智能体，然后开始 专用对话。
  • 使用智能体的专用网址直接在 Gemini Enterprise 中打开与该特定 AlloyDB 数据智能体的会话。
  • 通过在 Gemini Enterprise 核心对话中编写 @mention（例如 @sales_pipeline_agent） 来调用智能体。
  • 提出一般分析问题（例如“过去 3 个月内，我们的销售管道的趋势如何？”），让 Gemini Enterprise 自动将查询路由到相关的数据智能体。

找到智能体后，您可以使用以下任一方法与之交互：

  • 完成一次性 OAuth 登录，以安全地向 AlloyDB 进行身份验证。
  • 提出自然语言问题。对话式分析智能体会处理您的请求，并将回答以文本、Markdown、图表或表格的形式流式传输回 Gemini Enterprise。
  • 在历史记录窗格中查看对话记录，对话会自动保存。

位置

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

后续步骤