创建和管理数据智能体

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

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

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

准备工作

您可以将数据智能体视为另一种类型的 Looker 内容，例如信息中心、Look 或文件夹。

数据智能体的使用通过内容访问权限、数据访问权限和功能访问权限的组合进行管理。如需执行下表中描述的任务，您必须被分配一个 Looker 角色，该角色具有数据智能体将查询的模型的必要权限，并且在某些情况下，还必须具有对智能体本身的访问权限。

任务 所需的 Looker 权限 所需的数据智能体访问权限级别
创建、修改、共享和删除智能体 添加了 25.18 admin_agents 必须授予内容访问权限
创建、修改、共享和删除智能体 添加了 25.18 save_agents

用户可以创建仅使用他们已获得基础模型权限的探索的智能体。如需修改、删除或共享其他用户创建的数据智能体，用户必须被授予一个角色，该角色包含智能体使用的每个模型的此权限。		 管理访问权限；修改 （如果用户创建了智能体，则会自动授予此访问权限；否则，必须由智能体的创建者通过共享智能体来授予管理访问权限；修改 访问权限）
在对话式分析的智能体 标签页中与数据智能体 Chat access_data（在包含数据智能体使用的探索的每个模型上）

添加了 25.18 chat_with_agent（在包含数据智能体使用的探索的每个模型上）		 查看 访问权限
在对话式分析的探索 标签页中与 Looker 探索 Chat access_data（在包含数据智能体使用的探索的每个模型上）

添加了 25.18 chat_with_explore

Looker 还具有以下默认角色，这些角色包含实例上所有模型的这些权限的子集：

  • 对话式分析智能体管理员：拥有此角色的用户可以创建、修改、共享、删除和与他们拥有管理访问权限；修改 访问权限的智能体对话，以及与探索对话
  • 对话式分析用户：拥有此角色的用户可以与他们拥有查看 访问权限的智能体对话
  • 管理员：默认情况下，此角色（Looker 管理员）拥有整个实例的所有权限和内容访问权限。

Looker 管理员可以在 Looker 实例的管理员 部分的角色 页面上授予这些角色和权限。如需详细了解 Looker 角色，请参阅管理员设置 - 角色文档页面。

数据智能体的创建者可以通过共享智能体来管理各个用户对智能体的访问权限。

创建和修改数据智能体

如需创建新的数据智能体，请按照以下步骤操作：

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

  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. 根据需要更新有关智能体的详细信息。您可以修改在创建智能体时指定的详细信息，包括智能体名称、智能体说明、数据和指令字段。您还可以选择为智能体启用代码解释器。
  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.

删除数据智能体

如需删除数据智能体，请按照以下步骤操作：

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

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

永久删除数据智能体

如需永久删除数据智能体，请按照以下步骤操作：

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

从回收站恢复数据智能体

如需从回收站恢复数据智能体，请按照以下步骤操作：

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