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