为 LookML 信息中心创建和管理数据智能体

对话式分析由 Gemini 提供支持， Google Cloud 可让您通过直观的聊天界面，以对话式语言提出问题来调查数据。 将对话式分析与 LookML 信息中心搭配使用时，您可以 直接在受版本控制的 LookML 代码中定义和自定义数据智能体。

借助 LookML 信息中心的数据智能体，开发者可以将定制的业务逻辑、自定义说明和分析设置注入到 LookML 管理的信息中心中。 由于 LookML 信息中心代表着组织中受监管且受版本控制的真实来源，因此 LookML 信息中心智能体可确保 AI 互动在不同环境中保持一致，并遵守组织的数据标准。

本页涵盖以下主题：

准备工作

在配置或使用 LookML 信息中心智能体之前，请确保满足以下要求：

  • 实例要求：Looker 管理员必须在 Gemini in Looker 管理页面上启用 对话式分析。管理员还必须开启启用可信测试员功能 和已启用信息中心智能体 设置。 如需使用信息中心智能体的高级分析功能，还必须启用 Advanced Analytics 管理设置。此设置不适用于 Looker 26.14 中的 LookML 信息中心智能体。
  • 开发者权限：如需创建、修改或配置 LookML 信息中心智能体和信息中心，您必须拥有具有 develop 和 see_lookml_dashboards 权限的 Looker 角色，并且能够访问信息中心所依赖的 LookML 模型 。
  • 查看者权限：如需与 LookML 信息中心智能体聊天，用户 必须拥有 see_lookml_dashboards 权限，并且能够访问信息中心模块所依赖的 LookML 模型。

在 LookML 中定义信息中心智能体

如需在 LookML 中定义信息中心智能体，请在 LookML 模型文件或项目中的专用 LookML 文件中声明 agent 参数。

LookML 信息中心智能体定义使用以下语法：

agent: agent_name {
  advanced_analytics: yes | no
  description: "Description of the agent"
  instructions: "Custom agent prompt and instructions"
  is_dashboard_agent: yes
  show_debuginfo: yes | no
  show_thinking: yes | no
}

信息中心智能体支持以下 LookML 参数：

  • agent：声明新智能体并定义其名称。
  • advanced_analytics：（可选）接受 yes 或 no（默认值为 no）。设置为 yes 后，智能体可以使用 高级分析将自然语言问题转换为 Python 代码，并执行该代码以进行高级计算和可视化。此参数适用于 LookML 信息中心智能体；不过，它在 Looker 26.14 中不起作用。
  • description：（可选）对智能体的简要说明。
  • instructions：（可选）一个字符串，用于提供自由格式的说明和业务背景信息，以便在回答查询时指导智能体。如果省略此参数，智能体将使用默认的对话处理，而不会使用自定义提示上下文。
  • is_dashboard_agent：（信息中心智能体必需）设置为 yes，以将智能体明确标识为信息中心智能体。
  • show_debuginfo：（可选）接受 yes 或 no（默认值为 no）。设置为 yes 后，智能体会在对话响应中显示详细的执行和问题排查信息。
  • show_thinking：（可选）接受 yes 或 no（默认值为 no）。设置为 yes 后，智能体会在对话响应中显示其逐步推理过程。

信息中心智能体定义示例

以下示例定义了一个 LookML 信息中心智能体，该智能体强制执行特定的过滤规则和语气：

agent: sales_dashboard_agent {
  instructions: "Focus on revenue metrics. Always filter by the current fiscal year unless the user specifies otherwise."
  description: "LookML Dashboard Agent for sales performance analytics."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

在智能体说明中使用 LookML 常量

如果您在组织中管理多个 LookML 信息中心，则可以使用 LookML 常量在智能体定义之间共享 标准业务规则、词汇表或过滤要求，而无需重复文本。

如需在智能体说明中使用常量，请按以下步骤操作：

  1. 在项目的 manifest.lkml 文件中定义常量：

    constant: FISCAL_YEAR_RULE {
  value: "Always filter all requests by the current fiscal year unless the user explicitly specifies a different timeframe."
}

  2. 使用 @{<var>CONSTANT_NAME</var>} 语法在信息中心智能体的 instructions 参数中引用常量 ：

    agent: finance_dashboard_agent {
  instructions: "Prioritize gross margin and operating expense metrics. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
  advanced_analytics: yes
}

当智能体处理查询时，Looker 会将常量字符串动态替换为智能体说明。

将信息中心智能体与 LookML 信息中心相关联

如需将信息中心智能体附加到 LookML 信息中心，请在 .dashboard.lookml 文件中配置信息中心级参数。

以下信息中心参数控制 LookML 信息中心的智能体行为：

  • enabled_dashboard_agent：（可选）接受 true 或 false。确定用户是否可以看到 spark 与此信息中心对话 图标并与信息中心智能体互动。如果省略此参数，则在 API 层，此参数默认为 true。
  • default_dashboard_agent：（可选）指定 LookML 智能体的名称（使用 agent 参数定义），该智能体将作为信息中心的默认智能体。

LookML 信息中心配置示例

以下代码段展示了如何将 sales_dashboard_agent 映射到 LookML 信息中心：

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

  elements:
  - name: total_revenue_by_quarter
    type: looker_column
    model: sales_ops
    explore: orders
    measures: [orders.total_revenue]
    dimensions: [orders.created_quarter]

如果 enabled_dashboard_agent 设置为 true 且未指定 default_dashboard_agent，用户仍然可以与信息中心聊天；智能体将运行，而无需自定义说明。

在开发模式下测试 LookML 信息中心智能体

如果智能体已部署到生产环境，LookML 开发者可以直接在 Looker 界面中迭代修改智能体说明并测试响应，然后再将更改部署到生产环境。

如需在开发模式下测试对 LookML 信息中心智能体所做的任何更改，请按以下步骤操作：

  1. 确保智能体至少有一个部署到生产环境的基准定义。
  2. 开启开发模式。
  3. 在 LookML 文件中修改智能体 instructions 或设置，然后保存更改。
  4. 在 Looker 界面中打开 LookML 信息中心。
  5. 选择 spark 与此信息中心对话 以打开聊天面板。
  6. 提出问题，测试智能体如何解读提示并做出响应。

开启开发模式后，对话式分析会引用开发分支中的内存智能体定义、LookML 信息中心定义和模型文件。关闭开发模式后，对话式分析会恢复为引用生产分支中已部署的定义。

在开发模式下创建的任何对话记录都会保留，并且在会话之间显示在最近的对话列表中。

从用户定义的信息中心复制信息中心智能体 LookML

如果您在界面中将信息中心原型设计为用户定义的信息中心，则可以将其完整配置（包括信息中心智能体设置和说明）导出到 LookML 代码中。

如需从用户定义的信息中心复制 LookML，请执行以下操作：

  1. 打开用户定义的信息中心。
  2. 选择三点状的 more_vert 信息中心操作 菜单，然后选择 获取 LookML。
  3. 在获取 LookML 对话框中，复制生成的信息中心 LookML 和信息中心智能体定义代码。
  4. 将信息中心 LookML 粘贴到 .dashboard.lookml 文件中，并将 agent 代码块粘贴到模型或智能体 LookML 文件中。

导出的 LookML 会使用 enabled_dashboard_agent 参数值以及任何自定义智能体说明来保留启用与信息中心对话 开关的状态。

在 Looker 界面中查看智能体详情

查看具有活跃信息中心智能体的 LookML 信息中心时，您可以从聊天面板检查智能体配置：

  1. 选择 spark 与此信息中心对话。
  2. 选择 tune 管理智能体 。

对于 LookML 信息中心，管理智能体 面板以只读 模式显示智能体说明、高级分析状态和调试选项。无法直接在界面中修改设置。

如需修改配置，对底层模型具有 develop 权限的开发者可以点击 在 LookML 中修改 ，直接前往 IDE 中的相关 LookML 文件。

使用信息中心智能体查询 LookML 信息中心

如需开始与 LookML 信息中心智能体对话，请执行以下操作：

  1. 打开 LookML 信息中心。
  2. 选择 spark 与此信息中心对话。
  3. 在提出问题 字段中，用自然语言输入查询内容。
  4. 如果您的信息中心智能体允许使用 show_thinking，您可以选择一种问题模式：
    • 快速：将您的查询快速转换为直接 LookML 指标查找。
    • 思考：评估复杂的分析问题，并显示逐步 推理过程。
  5. 点击发送 发送。

如需取消正在进行的查询，请点击 停止响应。

管理会话

  • 最近的对话：如需打开之前的对话，请依次选择 more_vert 菜单 > 最近的对话。
  • 重命名对话：选择对话旁边的 more_vert ，然后选择 edit 重命名。
  • 删除话题：选择话题旁边的more_vert ，然后选择delete 删除。

LookML 信息中心智能体的限制

LookML 信息中心智能体具有以下限制：

  • 只能在 LookML 中定义：LookML 信息中心智能体必须在 LookML 中声明。您无法在 Looker 界面中创建、配置或修改它们。
  • 同一项目要求：智能体必须在与引用它的信息中心相同的 LookML 项目中定义。
  • 每个信息中心一个智能体：您只能将一个信息中心智能体与 LookML 信息中心相关联。
  • 仅限信息中心智能体：LookML 不支持创建探索数据智能体。LookML 中的所有 agent 声明都必须包含 is_dashboard_agent: yes。
  • Looker 26.14 中的高级分析：Looker 26.14 中的 LookML 信息中心智能体不支持 advanced_analytics 参数。
  • 开发模式和未部署的智能体：对话界面会忽略在开发模式下对尚未部署到生产环境的 LookML 信息中心智能体的配置所做的任何更改。