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

借助数据智能体,您可以为用户打造专属的对话式分析体验。借助代理,您可以为 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(字符串):用于生成查询的 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.

发布数据智能体

您可以在 Gemini Enterprise 中发布数据代理,从而让更多受众群体(包括可能不熟悉 Looker 界面的用户)使用代理的预定义背景信息和分析功能。Gemini Enterprise 是一个中央枢纽,用户可以在其中管理在各种 Google Cloud 应用中创建的数据智能体,从而帮助用户找到最适合其分析需求的智能体。

在 Looker 中创建对话式分析数据代理,然后将其发布到 Gemini Enterprise 以便进行对话的流程涉及在 Looker 实例、 Google Cloud 控制台中的 Gemini Enterprise 页面以及 Gemini Enterprise 实例中执行的任务。

如需在 Looker 中创建数据代理并使其可供 Gemini Enterprise 中的用户使用,具有以下角色的用户必须按照以下步骤操作,相关部分将对这些步骤进行更详细的介绍:

  1. 数据代理编辑者(Looker 功能):在 Looker 中发布代理
  2. Discovery Engine 管理员(IAM 角色):在 Google Cloud 控制台中授予对代理的访问权限
  3. Discovery Engine User(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 Engine 的 Google Cloud 项目的 Discovery Engine Admin Identity and Access Management 角色。

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

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

如需向用户授予对单个代理的访问权限,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 项目的 Discovery Engine User Identity and Access Management 角色。您还必须拥有适当的权限和内容访问权限,才能在 Looker 实例中与代理对话。

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

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

首次与支持人员聊天时,您必须授权支持人员访问您的 Looker 身份。

删除数据智能体

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

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

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

永久删除数据智能体

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

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

从回收站中恢复数据代理

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

  1. 前往对话页面
  2. 在左侧导航面板中,展开回收站部分。
  3. 如需打开所选代理的菜单,请选择其 图标,然后点击恢复
  • Looker 中的对话式分析概览:对话式分析的着陆页,其中包含关键功能列表,并链接到所有对话式分析文档。

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

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

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