创建和管理“探索数据”智能体

借助数据智能体，您可以为用户打造专属的对话式分析体验。借助代理，您可以为 Conversational Analytics 提供上下文和指令，使其能够针对特定使用情形更有效地回答问题。代理可帮助分析师将业务术语映射到特定字段，指定最适合过滤的字段，以及定义自定义计算。

本页将引导您完成以下流程：

了解 Gemini for Google Cloud 如何以及何时使用您的数据。

准备工作

对话式分析的使用通过内容访问权限、数据访问权限和功能访问权限的组合进行管理。您可以将数据代理视为另一种类型的 Looker 内容，例如信息中心、Look 或文件夹。如需与数据代理互动，您必须分配有相应的 Looker 角色，该角色需包含各个探索或数据代理将查询的基础模型的必要权限。在某些情况下，您还需要访问代理本身。

如需详细了解管理和使用数据代理所需的权限和访问权限，请参阅在 Looker 中设置对话分析文档页面上的权限表。

当 Looker 管理员在 Gemini in Looker 管理员页面上启用以下功能后，对话式分析探索智能体即可使用：

  • 对话式分析
  • 启用可信测试员功能
    • Agentic Workflows [预览版]：用于创建Agentic Workflows，指示智能体监控数据中的变化。
    • 已验证的查询 [预览版]：用于定义已验证的查询（自然语言问题和相应的探索查询对），作为代理的上下文。此预览功能仅在 Looker（原始版本）中提供。
    • 发布到 Gemini Enterprise [预览版]：将您的智能体发布到 Gemini Enterprise，让更多用户可以使用智能体的预定义上下文和分析功能。

创建和修改数据智能体

如需创建新的数据代理，请按以下步骤操作：

  1. 前往对话页面。
  2. 在智能体标签页中，选择 + 新智能体。或者，在左侧面板中，依次选择 spark管理代理，然后选择 + 新代理。

  3. 在新建代理页面上，提供有关数据代理的以下信息。

    • 代理名称：输入代理的名称。名称应该唯一且具有描述性。
    • 代理说明：简要说明此代理的用途及其使用的数据。用户在选择代理开始对话或您与用户分享代理时，会看到此说明，因此请确保说明清楚地说明了代理的用途以及它如何提供帮助。
    • 数据：请按照以下步骤操作，以关联最多五个现有的 Looker 探索：
      1. 在数据字段中，点击 + 选择探索。
      2. 在搜索探索窗口中，点击要纳入数据代理的探索。这些探索将显示在窗口的所选探索面板中。
      3. 如需将所选探索添加到数据代理，请点击保存。

  4. 指令：提供上下文，帮助对话式分析了解如何与您的数据互动，并提供准确且相关的回答。如需查看您可以提供的上下文类型示例，请参阅撰写智能体指令。

  5. （可选）如需为与代理进行的所有对话启用高级分析，请选择启用高级分析。

  6. （可选）选择高级选项以展开相应部分，然后配置以下设置：

    • 显示分析详情：开启此开关可在回答中显示代理的推理步骤、生成的 Looker 查询和底层数据表。
    • 显示调试信息：开启此切换开关可显示智能体为生成每个回答而执行的步骤，以帮助进行问题排查。

  7. （可选）您可以测试代理，以优化指令及其设置。

  8. 如需保存新数据代理，请点击保存。

保存数据智能体后，您可以与其他用户共享该智能体，并开始与该智能体对话。

撰写智能体指令

创建数据智能体时，您可以添加自由格式的指令，用于定义数据智能体的核心行为，并为其提供在处理用户提示之前需要考虑的基础背景信息。

以下是一些示例，展示了您可以在说明字段中提供的上下文类型：

  • 关键字段：用于分析的最重要字段
  • 排除的字段：数据代理应避免的字段
  • 过滤和分组：代理应用于对数据进行过滤和分组的字段
  • 角色：您为智能体分配的角色或专业知识、性格或语气

如需了解有关撰写智能体指令的提示和最佳实践，请参阅在 Looker 中配置对话式分析的最佳实践文档页面。

定义经过验证的查询

经过验证的查询（在某些 Google 文档中也称为黄金查询）是预定义的自然语言问题及其对应的确切 Looker Explore 查询。这些问题和查询配对充当经过验证的“黄金标准”，可教导智能体如何处理复杂的业务请求，而无需猜测。明确定义的经过验证的查询有助于提高“探索”数据智能体回答的准确性。

经过验证的查询的限制

使用已验证的查询时，请注意以下限制：

  • 经过验证的查询仅适用于 Explore 数据代理。它们不适用于独立对话或信息中心数据代理。
  • 您必须使用已为代理定义的探索。如果您引用的探索未被数据代理使用，系统会显示错误消息 This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent.
  • 经过验证的查询不支持包含自定义字段或透视的探索查询。
  • 虽然您可以添加的已验证查询数量不受限制，但我们建议每个智能体添加的问题和查询对不超过 30 到 50 个。

创建经过验证的查询

如需将经过验证的查询添加到新的或现有的数据代理，请按以下步骤操作：

  1. 创建新的数据代理，或修改现有数据代理（该代理使用至少一个探索作为数据源）。
  2. 在代理创建或修改页面上，选择 + 添加已验证的查询。
  3. 在添加经过验证的查询下，输入自然语言问题及其对应的答案：
    • 问题：输入用户可能会提出的自然语言问题。
    • 答案：粘贴可显示正确查询或可视化图表的探索的网址。
  4. 如需验证“探索”查询，请点击预览。
    • 或者：将回答字段留空，然后点击预览，在探索构建器中从头开始构建查询，然后保存生成的网址以供使用。
  5. 点击保存。

修改经过验证的查询

如需修改现有的已验证查询，请按以下步骤操作：

  1. 在与智能体的对话中，选择修改智能体。
  2. 在已验证的查询下，找到要修改的已验证查询。
  3. 点击 修改已验证的查询。
  4. 在修改经过验证的查询对话框中，更改问题或答案。
  5. 点击保存。

删除经过验证的查询

如需删除已验证的查询，请按以下步骤操作：

  1. 在与智能体的对话中，选择修改智能体。
  2. 在已验证的查询下，找到要删除的已验证查询。
  3. 点击 删除经过验证的查询。

测试代理

在创建或修改代理时，代理详情页面会显示预览代理窗格。您可以开始与代理对话，测试代理设置和指令。

您必须点击更新，更改才能反映在预览中。如果保存状态为 Not saved，则对设置的任何更新都不会反映在预览中。

修改现有数据代理

如需修改现有数据代理，请按以下步骤操作：

  1. 在对话页面上，依次选择火花图标 管理代理。
  2. 在管理代理页面上，选择要修改的数据代理。
  3. 根据需要更新有关代理的详细信息。您可以修改创建智能体时指定的详细信息，包括智能体名称、智能体说明、数据、指令和高级选项设置。您还可以选择为代理启用代码解释器。
  4. 如需保存更改，请点击更新。

共享数据代理

共享功能可让其他用户与您的代理及其探索功能进行对话。您可以向其他用户授予对数据代理的内容访问权限，从而与其他用户共享数据代理。只有拥有相应权限和内容访问权限的用户才能共享代理。创建代理后，可能需要几分钟时间才能共享该代理。

如需共享数据代理，请按以下步骤操作：

  1. 在对话页面上，选择左侧面板中的spark管理智能体。
  2. 点击所选代理的 更多选项图标，打开相应菜单，然后点击共享。
  3. 将个人或群组添加到谁可以访问此代理部分后，选择他们应具有的权限级别，然后点击添加，将他们添加到共享列表中。
  4. 如果您希望新用户或群组收到电子邮件通知，请选中向您刚刚添加的用户发送电子邮件复选框。
  5. 完成所有更改后，点击保存。

您还可以通过以下方式分享刚刚创建或正在修改的代理：点击代理设置页面上的 Share（分享），然后按照上述步骤操作。

撤消对数据代理的访问权限

如需撤消对代理的访问权限，请按照以下步骤操作：

  1. 在对话页面上，点击左侧面板中的闪电图标 管理代理。
  2. 点击所选代理的 更多选项图标，打开相应菜单，然后点击共享。
  3. 点击应移除其访问权限的用户或群组旁边的 X。
  4. 完成所有更改后，点击保存。

如果被移除的用户正在进行对话，那么在更改生效之前，他们仍可访问对话一两分钟。

如果用户在代理访问权限被移除后尝试提出更多问题，则会看到消息 The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.

发布数据智能体

您可以在 Gemini Enterprise 中发布数据代理，让更多用户（包括可能不熟悉 Looker 界面的用户）能够使用代理的预定义上下文和分析功能。Gemini Enterprise 是一个中央枢纽，用户可以在其中管理在各种 Google Cloud 应用中创建的数据代理，从而帮助用户找到最适合其分析需求的代理。

准备工作

在 Looker 中创建数据代理并使其可供 Gemini Enterprise 中的用户使用的过程涉及在 Looker 实例、 Google Cloud 控制台中的 Gemini Enterprise 页面以及 Gemini Enterprise 实例中执行的任务。

具有以下角色的用户必须按照相关部分中所述的步骤操作：

  1. 数据代理编辑者（Looker 功能）：在 Looker 中发布代理。
  2. Discovery Engine 管理员（IAM 角色）：在 Google Cloud 控制台中授予对代理的访问权限。
  3. Gemini Enterprise User（IAM 角色）；数据智能体用户（Looker 功能）：在 Gemini Enterprise 实例中与智能体对话。

在发布代理之前，必须满足以下要求：

  • Looker 管理员必须在管理员面板的 Gemini in Looker 页面中启用发布到 Gemini Enterprise 设置。
  • Looker 管理员必须为您授予包含 publish_agent_externally 权限的角色。您还必须能够修改数据代理。
  • 必须向托管 Gemini Enterprise 引擎的 Google Cloud 项目中的 Looker 服务账号授予 Discovery Engine Admin Identity and Access Management 角色。授予此角色后，当第一个数据代理发布时，系统会为相应账号分配 Gemini Enterprise 许可。如果没有可分配给 Looker 服务账号的 Gemini Enterprise 许可， Google Cloud 控制台中的 Gemini Enterprise 引擎页面会显示错误“无法为代理创建分配配额”。拥有 Discovery Engine Admin Identity and Access Management 角色的用户必须为 Looker 服务账号预配新的 Gemini Enterprise 许可或重新分配现有许可。

将数据代理发布到 Gemini Enterprise

如需完成本部分中所述的步骤，您必须拥有包含 publish_agent_externally 权限的 Looker 角色，并且拥有适当的权限和内容访问权限来修改数据代理。

如需发布代理，请按以下步骤操作：

  1. 修改代理。
  2. 选择发布设置，打开代理发布设置窗口。
  3. 在智能体发布设置窗口中，启用 Gemini Enterprise 设置，然后选择更新。启用此设置会将智能体发布到管理员面板中的 Gemini in Looker 页面上显示的 Gemini Enterprise 实例。
  4. 发布代理后，您可以选择分享以向其他 Looker 用户授予数据代理的访问权限，也可以选择开始对话以打开与数据代理的新对话。

向用户授予对 Gemini Enterprise 中智能体的访问权限

如需完成本部分中所述的步骤，您必须拥有 Google Cloud 包含 Gemini Enterprise Engine 的项目的 Discovery Engine Admin Identity and Access Management 角色。

如需在 Gemini Enterprise 中与智能体对话，用户必须有权访问 Gemini Enterprise 实例和相应智能体。

如需向用户授予对 Gemini Enterprise 实例的访问权限，Discovery Engine Admin 必须为用户分配 Google Cloud 项目（包含 Gemini Enterprise 引擎）的 Gemini Enterprise User IAM 角色。

如需向用户授予对单个代理的访问权限，Discovery Engine 管理员必须在 Google Cloud 控制台中完成以下步骤：

  1. 前往包含 Gemini Enterprise 引擎的 Google Cloud 项目。
  2. 打开 Gemini Enterprise 产品页面。
  3. 从主导航中选择应用页面，然后选择 Gemini Enterprise 实例的名称。
  4. 在主导航栏中，选择智能体。
  5. 选择要授予访问权限的代理。
  6. 选择用户权限标签页。
  7. 选择添加用户。
  8. 在向代理添加用户权限角色窗口中，添加每个用户并为其分配代理用户角色。

在 Gemini Enterprise 中与智能体 Chat

如需完成本部分中所述的步骤，您必须拥有包含 Gemini Enterprise Engine 的 Google Cloud 项目的 Gemini Enterprise User Identity and Access Management 角色。您还必须拥有适当的权限和内容访问权限，才能在 Looker 实例中与代理对话。

如需在 Gemini Enterprise 实例中与数据智能体对话，请按以下步骤操作：

  1. 打开 Gemini Enterprise 实例。
  2. 在主导航中选择代理。
  3. 在代理页面上，选择要与之对话的代理。选择代理后，系统会打开一个对话窗口，您可以在其中提出有关数据的问题。

首次与代理聊天时，您必须授权代理访问您的 Looker 身份。

删除数据智能体

如需删除数据代理，请按以下步骤操作：

  1. 在对话页面上，点击左侧面板中的闪电图标 管理代理。
  2. 点击所选代理的 更多选项图标，打开相应菜单，然后点击删除。
  3. 在删除代理？窗口中，点击移至回收站以删除数据代理。

移至回收站的代理会在 30 天后被永久删除。您可以手动永久删除数据代理，也可以在数据代理被永久删除之前从回收站中恢复数据代理。如果您不采取任何行动，系统会在 30 天后自动永久删除该智能体。

永久删除数据智能体

如需永久删除数据代理，请按以下步骤操作：

  1. 前往对话页面。
  2. 在左侧导航面板中，展开回收站部分。
  3. 如需打开所选代理的菜单，请选择其 图标，然后点击永久删除。
  4. 在确定吗？窗口中，点击永久删除。

从回收站中恢复数据代理

如需从回收站恢复数据代理，请按以下步骤操作：

  1. 前往对话页面。
  2. 在左侧导航面板中，展开回收站部分。
  3. 如需打开所选代理的菜单，请选择其 图标，然后点击恢复。

  • Looker 中的对话式分析概览：对话式分析的着陆页，其中包含关键功能列表，并链接到所有对话式分析文档。

  • 使用自然语言查询探索：与 Looker 探索展开对话，使用自然语言询问探索数据。

  • 在 Looker 中配置对话式分析的最佳实践：相关策略和最佳实践可帮助 Looker 管理员和 LookML 开发者成功配置并优化对话式分析。

  • 启用高级分析：对话式分析中的高级分析功能会将您的自然语言问题转换为 Python 代码并执行该代码。与基于标准 SQL 的查询相比，高级分析功能使用 Python 能够实现更复杂的分析和可视化效果。