创建和管理数据智能体

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

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

了解 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[]（字符串）：要应用于 Explore 的过滤条件。这是一个可选字段。
  • sorts[]（字符串）：要应用于探索的排序。此字段为可选字段。
  • limit（字符串）：要应用于探索的数据行限制。此字段为可选字段。

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

  1. 在“探索”中，选择探索操作菜单，然后选择获取 LookML。
  2. 选择信息中心标签页。
  3. 从 LookML 中复制查询详细信息。例如，下图显示了名为“Order Items”（订单项）的探索的 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. 在对话页面上，依次选择火花图标 管理代理。
  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.

删除数据智能体

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

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

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

永久删除数据智能体

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

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

从回收站中恢复数据代理

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

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