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

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

借助 LookML 信息中心的数据代理，开发者可以将定制的业务逻辑、自定义说明和分析设置注入到 LookML 管理的信息中心中。 每个信息中心都提供一个可供所有有权与信息中心聊天的用户使用的共享默认代理 。 由于 LookML 信息中心代表着组织内受治理、受版本控制的真实来源，因此 LookML 信息中心代理可确保 AI 互动在各个环境中保持一致，并遵守组织的数据标准。

本页涵盖以下主题：

准备工作

如需使用对话式分析与信息中心数据互动，请确保满足 Looker 实例的设置和要求，并且您已获得执行本页所述任务的相应权限。

在 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 信息中心上的代理不支持 经过验证的查询。

信息中心代理定义示例

以下示例定义了一个 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 不支持创建探索数据代理。LookML 中的所有 agent 声明都必须包含 is_dashboard_agent: yes。
  • Looker 26.14 中的高级分析：Looker 26.14 中的 LookML 信息中心代理不支持 advanced_analytics 参数。
  • 开发模式和未部署的代理：对话界面会忽略在开发模式下对尚未部署到生产环境的 LookML 信息中心代理的配置所做的任何更改。