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

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

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

本页包含以下主题：

准备工作

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

  • 实例要求：Looker 管理员必须在 Gemini in Looker 管理页面上启用对话式分析。管理员还必须开启启用可信测试员功能和启用信息中心代理设置。 对于信息中心代理，还必须启用高级分析管理员设置。高级分析此设置不适用于 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 信息中心上的智能体行为：

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

LookML 信息中心配置示例

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

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent
  dashboard_agents: [sales_dashboard_agent, regional_sales_agent]

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

如果 enable_dashboard_agent 设置为 true 且未指定 default_dashboard_agent，用户仍然可以与信息中心聊天；代理将运行，但不会使用自定义指令。

在开发模式下测试 LookML 信息中心代理

LookML 开发者可以直接在 Looker 界面中迭代修改代理指令和测试回答，然后再将更改部署到生产环境。

如需在开发模式下测试 LookML 信息中心智能体，请执行以下操作：

  1. 开启开发模式。
  2. 修改 LookML 文件中的智能体 instructions 或设置，然后保存所做的更改。
  3. 在 Looker 界面中打开 LookML 信息中心。
  4. 依次选择 spark 与此信息中心对话，打开聊天面板。
  5. 提出问题，测试智能体如何解读提示并做出回应。

当开发模式处于开启状态时，对话式分析会引用开发分支中的内存代理定义、LookML 信息中心定义和模型文件。关闭开发模式后，对话分析会恢复为引用生产分支中已部署的定义。

在开发模式下创建的对话记录会保留下来，并在会话之间显示在您的“近期对话”列表中。

从用户定义的信息中心复制信息中心代理 LookML

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

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

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

导出的 LookML 会使用 enable_dashboard_agent 参数保留与信息中心对话切换开关的状态，并复制所有自定义代理说明。

在 Looker 界面中查看代理详情

查看包含有效信息中心智能体的 LookML 信息中心时，您可以在聊天面板中检查智能体配置：

  1. 依次选择火花图标 与此信息中心对话。
  2. 依次选择调整 管理代理。

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

如需修改配置，对基础模型拥有 develop 权限的开发者可以点击 Edit in LookML（在 LookML 中修改），直接前往 IDE 中相关的 LookML 文件。

使用信息中心代理查询 LookML 信息中心

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

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

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

管理会话

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