借助对话式数据智能体，您可以使用自然语言界面与数据库数据进行交互。通过构建这些智能体，您可以帮助用户“与数据对话”，从而从运营数据库中获取洞见，而无需编写复杂的 SQL 查询。
从宏观层面来看，数据智能体是角色、一组数据源的组合，并且可以访问一组对其用途至关重要的业务知识。
对于应用开发者，这些智能体具有以下优势：
- 准确率高：通过使用编写的上下文，您可以针对特定的业务问题获得很高的准确率。编写的上下文是智能体创建者可以用来提高准确率的主要关键因素。 它包括架构说明、系统指令和结构化上下文，可提供有关预期数据库查询的额外信息。
- 复杂性降低：智能体将自然语言转换为 SQL 查询、执行，甚至数据汇总或可视化。
- 灵活性：您可以为个人测试起草智能体，也可以发布智能体，以便项目中的其他用户或通过 API 以编程方式使用智能体。
准备工作
-
验证是否已为您的 Google Cloud 项目启用结算功能。
-
启用 AlloyDB for PostgreSQL、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs（如果尚未启用）。
启用 API 所需的角色
如需启用 API，您需要拥有
serviceusage.services.enable权限。如果您 创建了项目，则可能已通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。
所需的角色
如需使用数据智能体，您必须拥有与您的使用场景相符的 IAM 权限。下表列出了所需角色，具体取决于您是创建和发布智能体、在 Gemini Enterprise 中配置智能体，还是发现和使用智能体。如需了解更多 信息，请参阅 Conversational Analytics API IAM 角色。
| 使用场景 | 所需的角色 |
|---|---|
| 创建、修改、发布、共享和删除智能体 |
|
| 在 Gemini Enterprise 中配置智能体 |
如需让已发布的智能体可供 Gemini Enterprise 中的用户使用，您需要权限才能在 Gemini Enterprise 管理控制台中注册和管理 A2A 智能体。 |
| 发现和使用智能体 |
|
如需使用 AlloyDB 资源（例如查看表或运行查询），请参阅 AlloyDB 的 IAM 角色和权限。
创建数据智能体
以下部分介绍了如何创建数据智能体。 创建智能体后，您可以修改其设置。
配置基本信息
在 Google Cloud 控制台中，前往 AlloyDB 页面。
从列表中选择一个集群。
在导航菜单中，点击智能体 。
点击智能体 标签页。
选择数据库，然后使用 IAM 账号登录。
点击新建智能体 。系统会打开新建智能体 页面。
在 编辑器 部分的 智能体名称 字段中，输入数据智能体的 描述性名称，例如
Q4 sales data或User activity logs。在智能体说明 字段中，输入数据智能体的说明。好的说明应解释智能体的用途、使用的数据，并帮助您确定这是否是适合用于对话的数据智能体，例如
What are the top 10 selling products in Q2?在知识来源 部分，点击添加来源 。系统会打开添加数据 页面。
选择智能体在回答问题时将重点关注的表。如需查看其他 知识来源，请选择 显示更多。
点击添加 。系统会重新打开“新建智能体”页面。
自定义表和字段说明
如需提高对话式数据智能体的准确率，您可以选择提供额外的表元数据。只有数据智能体会使用此元数据，它不会影响源表。您可以添加以下元数据：
- 架构说明： 为表和列添加说明，以帮助智能体了解您的数据。如果您不添加说明，智能体将使用数据定义中的架构说明。
添加表和字段说明时，请遵循以下最佳实践：
- 将说明添加到数据定义，而不是仅添加到数据智能体定义。这样可确保其他智能体也能受益于这些说明。
- 如需为数据智能体提供合适的说明以帮助其了解您的数据，请为特定智能体添加说明。验证说明是否具有预期效果后，您可以决定是否在数据定义中添加说明。
如需为智能体自定义表和字段说明，请执行以下步骤：
- 在智能体目录 标签页中，打开要自定义的智能体。
- 点击修改智能体 。
- 在知识来源 中，找到要自定义的表，然后点击自定义 。
- 在表说明 中添加说明，或接受 Gemini 给出的建议。
- 在字段中，查看 Gemini 针对表中列给出的建议 说明。
- 管理建议的字段说明：
- 如需接受建议，请选择所需的说明，然后点击接受建议 。
- 如需拒绝建议，请选择所需的说明，然后点击拒绝建议 。
- 如需修改字段说明，请点击字段旁边的“修改”图标
修改 。
- 在说明中，输入字段的说明。
- 点击更新 以保存修改。
- 点击更新 以保存表的自定义设置。
- 针对要自定义的每个表，重复上述步骤。
创建经过验证的查询
您可以从系统生成的列表中选择经过验证的查询，也可以自行创建。
如需为数据智能体创建经过验证的查询，请执行以下操作：
- 在智能体目录 标签页中，打开要自定义的智能体。
- 点击修改智能体 。
在经过验证的查询 中，点击查看 Gemini 生成的建议 。
- 在查看建议的经过验证的查询 中，查看建议的经过验证的查询。
- 选择适用于您的使用场景的查询。
- 点击添加 以将查询添加到上下文中。
可选。如需创建自己的经过验证的查询，请在经过验证的查询 中点击添加查询。
- 在问题中，输入可由经过验证的 查询回答的问题。
- 点击生成 SQL ，让 Gemini 生成与您添加的问题对应的经过验证的查询。
- 点击运行 ，验证查询是否返回了您预期的结果。
- 查看回答，并根据需要修改经过验证的查询。
- 点击添加 。
重复上述步骤，创建其他经过验证的查询。
为数据智能体添加标签
在智能体设置 部分，您可以 创建标签来组织 Google Cloud 资源。标签是键值对 ，可用于将相关对象组合在一起或者与其他 Google Cloud 资源组合在一起。
- 在智能体目录 标签页中，打开要添加标签的智能体。
- 点击修改智能体 。
- 在智能体设置 部分，点击添加标签 。系统会打开管理标签 窗格。
- 点击添加标签 。
- 在键 和值 字段中，输入标签的键值对。
- 如需添加更多标签，请再次点击添加标签 。
- 如需删除标签，请点击“删除”图标 delete。
- 完成后，点击添加 。系统会重新打开“新建智能体”页面。
请继续阅读下一部分，了解如何将智能体置于草稿模式或发布智能体。
预览并发布智能体
在预览 部分的提出问题 字段中，输入一个示例问题，然后按 Enter 键。
如需验证数据智能体是否返回了您预期的数据，请查看智能体的回答。如果回答不是您预期的结果，请在编辑器 部分中更改设置，以优化数据智能体配置，直到获得令人满意的回答。您可以继续测试和修改智能体，以优化智能体的结果。
点击保存 。
如需将数据智能体置于草稿模式（您可以稍后重新修改）， 请点击 返回 ，返回到 智能体目录 页面。 由于您的智能体现在处于草稿模式，因此它会显示在智能体目录 标签页的我的智能体草稿 部分中。
如需发布智能体，请停留在智能体创建页面上，然后继续执行下一步。
如需发布数据智能体并使其可在项目中供使用，请点击发布 。发布智能体后，有权访问同一数据库表的其他用户可以查看您的智能体并与之对话，从而受益于您创建的指令和上下文。
您可以使用 数据智能体通过 Google Cloud 控制台中的智能体页面创建对话。您还可以使用 Conversational Analytics API 构建自己的界面，与数据智能体对话。
可选：在您的智能体已发布 对话框中，点击共享 以与其他用户共享数据智能体。
- 在共享权限 窗格中，点击添加主账号 。
- 在新的主账号 字段中，输入一个或多个主账号。
- 点击选择角色 列表。
- 在角色 列表中，选择以下角色之一：
- Gemini 数据分析 Data Agent User (
roles/geminidataanalytics.dataAgentUser)：授予与数据智能体对话的权限。 - Gemini 数据分析 Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor)：授予修改数据智能体的权限。 - Gemini 数据分析 Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer)：授予查看数据智能体的权限。
- Gemini 数据分析 Data Agent User (
- 点击保存 。
可选：您可以将数据智能体发布到 Gemini Enterprise。如需了解详情，请参阅在 Gemini Enterprise中发布数据智能体。
如需返回“新建智能体”页面，请点击关闭 。保存或发布智能体后，您可以在智能体目录 中看到它。
管理数据智能体
您可以在智能体目录 标签页中找到现有智能体，该标签页包含三个部分：
- 我的智能体：您创建和发布的所有智能体的列表。您可以修改已发布的智能体并与他人共享。
- 我的智能体草稿：您尚未发布的智能体。您无法共享智能体草稿。
- 您组织中的其他人分享的智能体：其他人创建并 与您共享的智能体。如果其他人授予您权限，您可以修改这些共享的智能体。
修改数据智能体
如需修改数据智能体，请按以下步骤操作：
在 Google Cloud 控制台中，前往 AlloyDB 页面。
从列表中选择一个集群。
在导航菜单中，点击智能体 。
使用 Identity and Access Management (IAM) 身份验证登录智能体 。
点击智能体目录 标签页。
找到要修改的数据智能体的智能体卡片。
如需在智能体编辑器中打开数据智能体，请依次点击 打开操作 和智能体卡片上的修改 。
根据需要修改数据智能体的配置。
如需保存更改但不发布，请点击保存 。
如需发布更改，请点击发布 。在共享 对话框中，您可以与其他用户共享智能体，也可以点击取消 。
如需返回智能体 窗格，请点击 返回。
共享数据智能体
如需共享已发布的数据智能体，请按以下步骤操作。您无法共享智能体草稿。
在 Google Cloud 控制台中，前往 AlloyDB 页面。
从列表中选择一个集群。
在导航菜单中，点击智能体 。
使用 Identity and Access Management (IAM) 身份验证登录智能体 。
点击智能体目录 标签页。
找到要修改的数据智能体的智能体卡片。
如需在智能体编辑器中打开数据智能体，请依次点击 打开 操作 > 智能体卡片上的修改。
如需与其他用户共享数据智能体，请点击共享 。
在共享权限 窗格中，点击添加主账号 。
在添加主账号 字段中，输入一个或多个主账号。
点击选择角色 。
在角色 列表中，选择以下角色之一：
- Gemini 数据分析 Data Agent User (
roles/geminidataanalytics.dataAgentUser)：授予与数据智能体对话的权限。 - Gemini 数据分析 Data Agent Editor (
roles/geminidataanalytics.dataAgentEditor)：授予修改数据智能体的权限。 - Gemini 数据分析 Data Agent Viewer
(
roles/geminidataanalytics.dataAgentViewer)：授予查看数据智能体的权限。
- Gemini 数据分析 Data Agent User (
点击保存 。
如需返回智能体修改页面，请点击关闭 。
如需返回智能体 窗格，请点击 返回 。
删除数据智能体
在 Google Cloud 控制台中，前往 AlloyDB 页面。
从列表中选择一个集群。
在导航菜单中，点击智能体 。
使用 Identity and Access Management (IAM) 身份验证登录智能体 。
选择智能体目录 标签页。
在智能体目录 标签页的智能体 部分中，找到要删除的数据智能体的智能体卡片。
依次点击 打开操作 > 删除。
在删除智能体？ 对话框中，点击删除 。删除智能体后，系统会从项目中永久移除该智能体。
删除智能体后，现有对话将以“只能查看”模式显示。 您无法向已删除的智能体提出新问题。
在 Gemini Enterprise 中发布数据智能体
发布数据智能体需要数据分析师、Gemini Enterprise 管理员和业务用户之间的协作。如需了解这些用户所需的角色，请参阅所需角色。
创建和发布智能体
如需创建、修改和发布智能体，请按以下步骤操作：
- 创建或修改您在 AlloyDB 中的数据智能体。
- 发布智能体。发布智能体时，请选择 Gemini Enterprise 作为发布选项。
- 如需复制 A2A 端点 JSON，请点击 Copy JSON 。
- 与 Gemini Enterprise 管理员共享 A2A 端点 JSON 和用户列表，以便他们可以在 控制台 Google Cloud 中注册自定义智能体并配置访问权限。 如需了解详情，请参阅配置智能体。
- 与需要 访问权限的用户和群组共享智能体。
配置智能体
如需让已发布的智能体可供 Google Cloud 控制台中的用户使用， 请按以下步骤操作：
在 Google Cloud 控制台中，前往 Gemini Enterprise。
点击要向其注册智能体的应用的名称。
依次点击智能体 > 添加智能体。
在选择智能体类型 部分，对于通过 A2A 构建的自定义智能体 ，点击添加 。
在智能体卡片 JSON 字段中，以 JSON 格式输入您之前从数据分析师处收到的智能体卡片详细信息。
依次点击预览智能体详细信息 > 下一步 。
如需让智能体代表您访问 Google Cloud 资源， 请按以下步骤操作：
输入您在 配置授权详细信息 部分中生成的客户端 ID 和客户端密钥。
在授权 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。
在令牌 URI 字段中，输入以下内容：
https://oauth2.googleapis.com/token
在范围 字段中，输入以下内容：
https://www.googleapis.com/auth/cloud-platform
点击完成 。
共享智能体 与用户或群组。
如需了解详情，请参阅注册和管理 A2A 智能体。
查找和使用智能体
您可以使用以下任一方法在 Gemini Enterprise 中查找和使用数据智能体：
- 在 智能体库中找到智能体，然后开始 专用对话。
- 使用智能体的专用网址直接在 Gemini Enterprise 中打开与该特定 AlloyDB 数据智能体的会话。
- 通过在 Gemini Enterprise 核心对话中编写
@mention（例如@sales_pipeline_agent） 来调用智能体。 - 提出一般分析问题（例如“过去 3 个月内，我们的销售管道趋势如何？”），让 Gemini Enterprise 自动将查询路由到相关的数据智能体。
找到智能体后，您可以使用以下方法之一与之交互：
- 完成一次性 OAuth 登录，以安全地向 AlloyDB 进行身份验证。
- 提出自然语言问题。对话式分析智能体会处理您的请求，并将回答以文本、Markdown、图表或表格的形式流式传输回 Gemini Enterprise。
- 在历史记录窗格中查看对话记录，对话会自动保存。
位置
对话式分析在全球范围内运行，您无法选择要使用的区域。
后续步骤
- 详细了解 AlloyDB 中的对话式分析。
- 详细了解 Conversational Analytics API。
- 通过对话分析数据。
- 详细了解
Gemini 数据分析 Data Agent Viewer (
roles/geminidataanalytics.dataAgentViewer) 角色如何授予查看数据智能体的权限。