使用智能体编码工具编写 LookML

1. 简介

基于 VS Code 生态系统的智能体代码编写工具已变得非常热门。光标和 Antigravity 只是两个示例。此 Codelab 将演示如何使用这些代码工具编写 LookML。

实践内容

在此 Codelab 中，您将使用 Looker 的 VS Code 扩展程序修改 LookML 模型，以添加新的衡量指标、测试新衡量指标，然后使用该新衡量指标构建 LookML 信息中心。所有这些操作都将通过提示编码智能体来完成。

所需条件

• 您拥有开发者权限的 Looker 实例。
• 基本熟悉 Looker，包括创建新的 LookML 项目、在 Looker 中查看探索并与之交互。
• Looker 实例上用户的 API client_id 和 client_secret。
• 基于 VS Code 的编码智能体。在本指南中，我们将使用 Antigravity。
• GitHub 账号。
• 已启用 BigQuery 的 Google Cloud 项目。

受众群体：LookML 开发者、数据工程师和架构师。

💡 费用估算：假设您在本教程结束时删除所有资源，运行此 Codelab 的费用将低于 5 美元。

2. 设置 Looker 实例

创建 Google Cloud 项目

1. 在 Google Cloud 控制台的项目选择器页面上，选择或创建一个 Google Cloud 项目。
2. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能。

将 Looker 连接到数据源

1. 在 Looker 中，前往管理下的数据库标题，然后选择连接。
2. 点击屏幕右上角的添加连接。
3. 为 Cymbal Gadgets 数据集创建新的数据源。将其命名为 cymbal_gadgets。为 SQL 方言选择 Google BigQuery Standard SQL。
4. 在下一页上，输入您的 Google Cloud 云项目名称、存储项目 looker-private-demo 和数据集名称 cymbal_gadgets。
5. 接受所有剩余字段的默认值，然后完成新数据源创建流程。
6. 在 SQL Runner 中，运行以下命令，确认您可以查询数据集

   SELECT count(*)
   FROM looker-private-demo.cymbal_gadgets.transactions
   

从 GitHub 导入项目

1. 将 GitHub 中的项目 https://github.com/looker-open-source/cymbal_gadgets 分叉到您自己的代码库中。您无法将部署密钥添加到您不拥有的项目中，因此必须进行 Fork 操作才能将项目关联到 Looker。
2. 启用开发模式。
3. 依次选择开发和项目。
4. 在“LookML 项目”页面中，点击新建模型。
5. 点击相应链接即可使用旧版 LookML 模型创建页面。
6. 在 Looker 中创建一个名为 cymbal_gadgets 的新空白项目。
7. 选择配置 Git 以将其连接到您创建的分支代码库。
8. 将 Deploy Key 添加到您的 Git 代码库。请务必点击相应复选框，以允许使用部署密钥进行写入访问。
9. 然后选择测试并完成设置。
10. 通过查询探索“🛍️ Cymbal Gadgets：交易和销售”中的数据，验证项目和数据源是否正常运行。
11. 在 LookML 编辑器中打开 cymbal_gadgets 项目，然后按右上角的 Create Developer Copy 按钮。
12. 在 Git 操作下，点击 Push Changes To Remote，以便从 GitHub 获取开发分支。
13. 在计算机上的终端会话中，运行以下命令：

    cd $HOME
    git clone [e-mail]:YOUR_GITHUB_USER/cymbal_gadgets.git
    cd cymbal_gadgets
    git checkout YOUR_DEV_BRANCH
    

    将 YOUR_GITHUB_USER 替换为您的 GitHub 用户账号名称。同时，将 YOUR_DEV_BRANCH 替换为您的开发分支名称。您的开发分支将命名为类似 dev-john-doe-jhgr 的名称，即 dev 一词后跟您的姓名，再后跟一个简短的随机字符串。您可以在 Looker 界面中的 LookML 编辑器顶部找到自己的个人开发分支。

3. 设置 Agentic IDE

安装 VS Code 扩展程序

在 IDE 中，点击左侧面板中的“扩展程序”图标。然后搜索“Looker”，点击安装按钮，安装 Google 官方扩展程序。

安装 MCP Toolbox for Databases 服务器

如需向 Antigravity 授予 Looker API 的访问权限（运行查询、检查 SQL、检查 LookML 模型和检查连接架构信息），您需要运行本地 MCP Toolbox for Databases 服务器。MCP Toolbox 随附官方 Looker MCP 实现。在本部分中，您将设置并为 Looker 实例配置该功能。

1. 首先，您需要 API client_id 和 client_secret。使用 Looker API 密钥指南为您的用户生成 client_id 和 client_secret。您还需要 Looker 实例的基础网址。
2. 现在，您将使用 npx 安装 MCP Toolbox。您可以以内嵌环境变量的形式提供 Looker 实例网址和 API 凭据，也可以在 shell 环境中设置它们。在 Mac 和 Linux 的 shell 环境中运行此命令：

   LOOKER_BASE_URL="https://your-instance.looker.com" \
   LOOKER_CLIENT_ID="YOUR_CLIENT_ID" \
   LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
   npx @toolbox-sdk/server --prebuilt=looker,looker-dev
   

   对于 Windows，请在 PowerShell 中运行此命令：

   $env:LOOKER_BASE_URL="https://your-instance.looker.com"
   $env:LOOKER_CLIENT_ID="YOUR_CLIENT_ID"
   $env:LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET"
   npx @toolbox-sdk/server --prebuilt=looker,looker-dev
   

配置 VS Code 扩展程序

在此步骤中，您将配置 VS Code 扩展程序以连接到 Looker 和 Looker MCP 服务器。

1. 在 Antigravity 中，使用 CMD-SHIFT-P (Mac) 或 CTRL+SHIFT+P (Linux/Windows) 打开命令面板，然后选择 Preferences: Open Workspace Settings (JSON)。
2. 将以下内容添加到工作区设置，以使用 client_id 和 client_secret 配置扩展程序。对于 looker.projectId，请使用 cymbal_gadgets：

   {
      "looker.instanceURL": "https://your-instance.looker.com",
      "looker.clientId": "YOUR_API_KEY_CLIENT_ID",
      "looker.clientSecret": "YOUR_API_KEY_CLIENT_SECRET",
      "looker.projectId": "cymbal_gadgets"
   }
   

打开编辑器

1. 打开 Antigravity。
2. 依次点击文件 > 打开文件夹…。
3. 找到并选择 cymbal_gadgets 文件夹。

4. 创建客户生命周期价值指标

首先，您将使用代理在现有的 LookML 模型中创建一个新的衡量指标。Customer Lifetime Value 指标在此零售使用场景中非常有用。您将使用代理来确定此度量的方法和 LookML。

向智能体发出提示

在 Antigravity 工作区的 cymbal_gadgets 项目中，您应该会在右侧看到新的对话界面。在规划模式下，使用最新的 Gemini 模型，并输入以下提示开始对话：Create a Customer Lifetime Value measure.

检查实施计划

智能体将首先制定实施方案。打开实施计划以进行查看，然后点击继续按钮。

查看 LookML

查看更改后的 LookML。确保所做更改合理有效。

注意：请注意，代理是非确定性的，因此您的结果可能与这些结果略有不同。

VS Code 扩展程序会自动将修改后的 LookML 与 Looker 同步。可以在开发模式下进行测试。

在 IDE 中进行测试

提示 Antigravity 执行 query CLV broken down by customer loyalty tier。Antigravity 将使用 Looker MCP 服务器查找模型、检查可用字段，并使用 Looker 运行查询。结果将如下所示：

在 Looker 中进行测试

在 Looker 中，启用开发模式后，打开 🛍️ Cymbal Gadgets: Transactions & Sales 探索。选择“客户生命周期价值”指标，然后按“客户注册年份”进行透视。运行查询。它应如下所示。

5. 创建客户生命周期价值信息中心

现在，我们来尝试一个更复杂的示例。我们将要求代理创建一个全新的 LookML 信息中心。

向代理请求新信息中心

切换回 Antigravity。在同一对话中，确保已选择规划模式和最新的 Gemini 模型。然后提示 Create a dashboard showing customer lifetime value based on customer loyalty tier。

再次批准实现方案并接受代码更改。现在，这个新的 LookML 文件将自动与 Looker 同步。

在 Looker 中进行测试

在开发模式下，前往文件夹 LookML Dashboards。选择新创建的信息中心以查看它。

注意：同样，代理是不确定的，因此它可能与此代理有所不同。

6. 清理

1. 在“源代码控制”窗格下的 Antigravity 中，根据需要还原 LookML 更改。每个修改后的 LookML 文件旁边都会显示一个符号（例如 ↶），用于恢复文件。针对每个文件按相应按钮。
2. 在 Looker 中，依次选择管理、数据库和连接。点击 cymbal_gadgets 连接对应的齿轮图标，然后选择删除。确认您要解除关联。
3. 在 Looker 中使用开发模式。依次选择开发和 cymbal_gadgets 项目。在项目设置下，选择删除项目。输入项目名称 cymbal_gadgets，确认您要删除该项目，然后选择标有永久删除 cymbal_gadgets 的按钮。

7. 恭喜

恭喜您完成此 Codelab。

所学内容

• 如何使用智能体修改 LookML。
• 如何验证实施计划。
• 如何从 IDE 进行测试。
• 如何在 Looker 界面中进行测试。
• 如何使用代理创建新信息中心。

可以尝试的操作

现在，在界面中尝试以下提示，看看智能体 IDE 的不同功能：

• 良好的说明对于用户和 AI 而言都至关重要。提示代理为所有没有说明的字段添加说明。
• 请代理商向某个维度组添加更多时间范围。
• 让代理执行“按商品类别细分并按季度透视的收入”之类的查询。

了解详情

• 将 MCP Toolbox 与 Looker 搭配使用
• 将 Looker 与 Gemini CLI 搭配使用