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

借助数据代理，您可以为用户精心打造对话式分析体验。通过代理，您可以为对话式分析提供上下文和指令，使其能够更有效地回答特定用例的问题。代理可帮助分析师将业务术语映射到特定字段，指定用于过滤的最佳字段，并定义自定义计算。

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

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

准备工作

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

创建和修改数据代理

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

  1. 前往会话 页面。
  2. 在代理 标签页中，选择 + 新建代理。或者，在左侧面板中，选择 spark管理代理，然后选择 + 新建代理。

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

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

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

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

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

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

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

编写代理指令

创建数据代理时，您可以添加自由格式的指令，以定义数据代理的核心行为，并为其提供在处理用户提示之前需要考虑的基础上下文。

以下是一些您可以在指令 字段中提供的上下文类型的示例：

  • 关键字段：用于分析的最重要字段
  • 排除的字段：数据代理应避免的字段
  • 过滤和分组：代理应用于对数据进行过滤和分组的字段
  • 黄金查询：自然语言问题及其对应的“探索”查询对
  • 角色：您分配给代理的角色或专业知识、性格或语气

如需了解编写代理指令的提示和最佳实践，请参阅在 Looker 中配置对话式分析的最佳实践文档页面。

定义 Looker 黄金查询

如需为给定的“探索”定义每个 Looker 黄金查询，请为以下两个字段提供值：

  • natural_language_questions：用户可能会提出的自然语言问题
  • looker_query：与自然语言问题对应的 Looker 黄金查询

对于 natural_language_questions 字段，请考虑用户可能会提出的有关该“探索”的问题，并以自然语言编写这些问题。您可以在此字段的值中添加多个问题。您可以从“探索”的查询元数据中获取 looker_query 字段的值。

黄金查询支持以下字段：

  • model（字符串）：用于生成查询的 LookML 模型。必须填写此字段。
  • explore（字符串）：用于生成查询的“探索”。必须填写此字段。
  • fields[] （字符串）：要从“探索”中检索的字段，包括维度和衡量指标。这是一个可选字段。
  • filters[]（字符串）：要应用于“探索”的过滤条件。这是一个可选字段。
  • sorts[]（字符串）：要应用于“探索”的排序。这是一个可选字段。
  • limit（字符串）：要应用于“探索”的数据行数上限。这是一个可选字段。

您可以按照以下步骤直接从“探索”中检索“探索”的查询元数据：

  1. 在“探索”中，选择“探索”操作 菜单， 然后选择 获取 LookML。
  2. 选择信息中心 标签页。
  3. 从 LookML 复制查询详细信息。例如，下图 显示了名为订单项的“探索”的 LookML：

复制所选元数据以用于 Looker 黄金查询：

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

测试代理

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

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

修改现有数据代理

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

  1. 在会话 页面上，选择 spark管理代理。
  2. 在管理代理 页面上，选择要修改的数据代理。
  3. 根据需要更新有关代理的详细信息。您可以修改在创建代理时指定的详细信息，包括代理名称、代理说明、数据和指令字段。您还可以选择为代理启用 Code Interpreter。
  4. 如需保存更改，请点击更新 。

共享数据代理

通过共享，其他用户可以与您的代理及其“探索”进行对话。您可以向其他用户授予对代理的内容访问权限，从而与他们共享数据代理。只有拥有适当权限和内容访问权限的用户才能共享代理。代理创建完毕后，可能需要几分钟才能共享。

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

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

您还可以共享刚刚创建的代理或正在修改的代理，方法是点击代理设置页面上的 共享 ，然后按照上述步骤操作。

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

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

  1. 在 会话 页面上，点击左侧面板中的 spark管理代理 。
  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 实例中、控制台的 Gemini Enterprise 页面上以及 Gemini Enterprise 实例中执行的任务。 Google Cloud

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

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

您必须满足以下要求，然后才能发布代理：

将数据代理发布到 Gemini Enterprise

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

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

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

授予用户在 Gemini Enterprise 中访问代理的权限

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

如需能够在 Gemini Enterprise 中与代理对话，用户必须拥有对 Gemini Enterprise 实例和各个代理的访问权限。

如需授予用户对 Gemini Enterprise 实例的访问权限，Gemini Enterprise 管理员 必须为包含 Gemini Enterprise 引擎的项目向用户分配 Gemini Enterprise 用户 IAM 角色。 Google Cloud

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

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

在 Gemini Enterprise 中与代理 Chat

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

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

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

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

删除数据代理

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

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

移至回收站的代理将在 30 天后被永久删除。您可以手动永久删除数据代理，也可以在数据代理被永久删除之前从回收站中恢复数据代理。如果您不采取任何操作，代理将在 30 天后自动被永久删除。

永久删除数据代理

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

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

从回收站恢复数据代理

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

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

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

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

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

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