You need to enable JavaScript to run this app.
文档中心
文档备案控制台
大数据研发治理套件

大数据研发治理套件

请输入
  • 文档首页
    • 大数据研发治理套件用户指南数据开发智能开发助手DataLeap 智能开发助手
复制全文
下载 pdf
我的收藏
智能开发助手
DataLeap 智能开发助手
复制全文
下载 pdf
我的收藏
DataLeap 智能开发助手

智能开发助手是大数据研发治理套件 DataLeap 为数据开发、数据分析师以及其他将平台作为日常开发工具人员提供的智能辅助开发工具。通过提供智能生成 SQL 代码、智能诊断、语句修复、代码优化以及智能问答能力，助力平台用户减少基础开发工作量、提升开发效率。本文为您介绍如何使用 DataLeap 智能开发助手来实现智能数据开发、查询等操作。

1 使用场景

  • 自动化开发：描述简单的业务需求，可以自动创建和写入 SQL 任务及对应的数据表结构。例如：生成一段将字段A从 String 转换成 int 类型的 SQL，并进行时区转换、Case/When 生成等。
  • 智能问答：根据您描述的问题进行答疑，例如忘记 Spark 函数怎么写，唤起智能开发助手，询问函数使用方式。
  • 优化代码：SQL 编辑器中选中代码唤起智能开发助手，点击代码优化。比如优化历史任务代码，自动生成优化后的代码并展示 DIFF。
  • 修复报错：通过 AI 诊断、AI 修复能力，详细解释报错原因，并给出建议修复方案。
  • SQL 代码解释/注释/格式优化：SQL 编辑器中选中相关代码后，可唤起智能开发助手，通过 AI 能力进行 SQL 代码解释、代码注释及代码风格优化，提高 SQL 代码可读性。

2 注意与限制

  • 目前支持地区：华北2（北京）、华东2（上海）、华南1（广州）
  • 支持任务类型：EMR Serverless Spark SQL。
  • 目前智能开发助手的模型已支持选择 Doubao-Seed-2.0-pro、DeepSeek-V3.2 和 GML-4.7 三种类型，其余模型暂不支持。
  • DataLeap 智能开发助手为增值服务，需单独进行购买，并根据实际输入/输出 Token 数进行计费。详见智能助手计费。

3 购买与开通智能开发助手

  1. 购买智能开发助手服务，您可前往 DataLeap租户控制台 > 购买其他服务中进行购买，操作详见2.1 开通服务。
    Image
  2. DataLeap 能够从项目粒度来控制智能开发助手是否启用，您可以在控制台中进行相关操作：
    • 在新建 DataLeap 项目时，可在项目管控 > 智能助手设置步骤中，勾选启用智能开发助手。
      Image
    • 针对已创建的历史项目，您可在项目控制台 > 智能助手控制窗口中，勾选启用智能开发助手。
      Image

4 操作指南

4.1 功能入口

智能开发助手中枢能力位于数据开发界面的左侧功能栏或右下角，建议根据新手引导流程完成操作。其他入口主要位于 SQL 任务。

  1. 登录 DataLeap租户控制台 。
  2. 在概览界面，显示加入的项目中，单击数据开发进入对应项目。
  3. 可通过以下入口进入来唤起智能开发助手：
    • 主入口
      在数据开发界面左侧功能栏或右下角，单击 Leap Agent 智能开发助手图标按钮，均可进入开发助手页面。
      Image
    • SQL 任务
      在 SQL Editor 界面，您可通过以下方式唤起智能开发助手：
      Image
      a. 在编写完成 SQL 代码后，单击工具栏中的解析按钮，若编辑的 SQL 有异常时，则会提供 AI 诊断、AI 修复，为您提供 SQL 编写建议。
      b. 通过快捷键或单击AI生成代码按钮的方式，呼唤出智能助手小窗，您可依据界面提示，进行选表，描述 SQL 处理逻辑等。

4.2 智能开发助手界面说明

通过左侧功能栏图标打开的智能开发助手页面具有所有功能，下面以此入口进入的界面为例，对各功能进行说明。
Image

功能项

说明

编辑框

自然语言会话输入区。您可以在输入框中用自然语言描述需求，包括产品功能、SQL 代码、SQL 报错异常等，Agent 会自动规划并分步执行，最终产出可供评审和上线的代码与表结构。
例如，您可通过输入@后选表的方式指定读取或写入表，描述业务处理逻辑，来生成 SQL 代码；也可在日常数据开发中，若遇到报错答疑、产品功能咨询或函数用法等，智能问答能够帮助您提升使用效率。

说明

为了让 Agent 更准确地理解你的意图，请提供尽可能完整的信息。例如，使用完整的库表名称（database.table_name），并清晰地阐述口径的计算逻辑。

圈选上下文（@）

选择处理逻辑中需要使用到的任务、表、代码片段等信息，将当前工作环境中的多种元素作为附加上下文，为 Agent 提供更丰富的背景信息。
目前仅支持圈选 EMR Serverless Spark SQL 类型任务的内容，三种类型信息的圈选方式分别如下：

  • 任务：单击 @ > 任务，在浮窗中，可输入任务名关键词或id后，选择任务，完成圈选。

    说明

    当打开右侧边栏会话窗口时，编辑框中会自动圈选当前打开的任务。

  • 表：单击 @ > 表，在浮窗中，根据提示，依次选择引擎、实例、Catalog目录、库、表信息，完成圈选。
  • 代码片段：打开任务，选中一段代码，通过右键菜单的“添加至会話”快速圈选。

Agent类型选择（Auto）

可按需对智能开发助手的Agent类型进行选择，支持开发Agent 和 Chat 两种类型选项。

  • 开发 Agent：专注于自动化数仓开发任务。
  • Chat：纯问答模式，不执行任何开发操作，不生成实际产物。

说明

当选择默认项 Auto 时，系统将自动识别需求意图，并分派给最合适的 Agent。

模型选择（Doubao-Seed-2.0-pro）

可根据任务的复杂度和成本考量，按需选择智能开发助手的大语言模型，支持 Doubao-Seed-2.0-pro、DeepSeek-V3.2 和 GML-4.7 三种模型类型选项，默认选择 Doubao-Seed-2.0-pro。
选择模型时，可选择是否开启该模型的推理功能，分别如下：

  • Doubao-Seed-2.0-pro：支持推理功能选项禁用、低、中、高。
  • DeepSeek-V3.2：支持选项禁用、启用。
  • GML-4.7：支持选项禁用、启用。

说明

还支持选项 Default，该选项即表示默认项 Doubao-Seed-2.0-pro。

优化输入内容（T）

输入内容后，可单击编辑框右下方的优化输入内容图标，优化已输入内容，来提升生成质量。

在侧边栏中显示

单击页面右上角的在侧边栏中显示图标，可以切换为通过右下角 Leap Agent 图标打开的侧边栏模式。此模式可同时展示任务页面，方便实时查看任务进展。
Image

侧边栏功能

新会话

单击新会话按钮，重新开始新一轮的会话。

按天筛选

用于按天查看历史会话记录。
单击新会话按钮上方的按天筛选图标按钮，选中有历史会话的某一天后，可查看该天内所有的历史会话记录。

批量管理

用于批量删除历史会话。
单击新会话按钮上方的批量管理图标按钮，勾选一条或多条历史会话信息后，单击删除选中按钮，待二次确认后，可删除相应历史会话。

刷新

单击新会话按钮上方的刷新图标按钮，可以刷新历史会话列表。

收起侧边栏

单击新会话按钮上方的收起侧边栏图标按钮，可以收起该侧边栏。

历史会话

在新会话按钮下方，会按时间分类展示历史会话列表，可以对历史会话进行重命名、删除等操作。鼠标悬停在某一条会话上，单击

4.3 使用 Agent 模式

  1. 输入开发需求
    可直接在输入框中用自然语言描述需求，也可以通过“圈选”的方式，将当前工作环境中的多种元素作为附加上下文，为 Agent 提供更丰富的背景信息。
    Image
  2. Agent运行配置
    在正式发起任务前，你可以对 Agent 的行为进行配置，以确保其更符合你的预期。
    1. 选择 Agent 类型
    2. 选择大语言模型 (LLM)
  3. 执行与监控
    1. 完成任务定义与配置后，按回车键或单击发送图标，Agent 便开始自动执行。
    2. 对于创建或修改多个表和任务的复杂需求，Agent 会首先生成一个清晰的 Todo 列表。该列表会实时展示在输入框上方，让您能够清晰地追踪每个子任务的完成状态。所有 Todo 完成后，系统将自动进入最终的产物评审环节。
      Image

    说明

    在自动开发过程中，你可能会遇到 Agent 执行出错或结果不符合预期的情况，可执行以下操作：

    • 观察与等待：如果过程中出现“修改错误”，Agent 通常会进行自我修正。你只需关注最终结果。
    • 重新开始：如果 Agent 在一个会话中反复出错，建议开启一个新会话，过多的错误历史可能会干扰其后续判断。也可以重新选择一个模型进行尝试。
    • 分析与调整：尝试阅读 Agent 的会话流信息，分析其思考路径，并据此调整你的需求描述，使其更精确。
  4. 评审与采纳产物
    1. 当 Agent 完成所有执行步骤后，会在输入框上方生成待评审的产物。
    2. 可以单击产物名称或去评审按钮，页面将自动跳转到对应的任务或表的新建/编辑页面。确认代码和表结构无误后，单击采纳按钮，即可将 Agent 的修改应用到工作草稿中。
      Image

说明

  1. 每次会话结束后，会话下方的上下文使用量会展示智能开发助手在会话过程中上下文已使用的Token额度。
  2. 可鼠标悬停在该数字上查看详细信息，并单击压缩按钮精简对话内容，以节省Token使用量。当上下文使用量达到最大限额的90%时，系统会自动对历史对话上下文进行压缩处理。

5 使用示例

5.1 SQL 生成方式示例

在拿到数据开发相关需求后，需转换成表、任务等处理逻辑。您可通过智能开发助手选定表，并编写相应的提示词，来快速生成相关的逻辑 SQL。
以下为您演示不同入口的使用示例，您可根据使用习惯进行操作：

触发入口

操作说明

右下角或左侧功能栏开发助手-选表

  1. 数据开发界面右下角进入智能开发助手窗口。
  2. 在下方输入框中，可通过单击@按钮，或在编辑框中输入@，进行选表，并描述相关 SQL 逻辑。
    Image
  3. 编辑完描述信息并发送后，便可获取完整的 SQL 代码逻辑供您使用。

SQL任务编辑器界面-选表

  1. 在 SQL 任务编辑界面，通过快捷键（Mac 按住 Command+i，Windows 按住 Ctrl+i）或单击界面“生成代码”按钮，进入智能助手编辑小窗。
  2. 在窗口上方单击“选表”按钮，在弹窗中选择输入/输出表名称信息，您可通过输入库名、表名方式进行模糊搜索。
  3. 单击确定按钮，完成表的选择。
  4. 在小窗中，用自然语言输入想要处理的 SQL 逻辑，单击提交按钮，等待语句自动生成。
  5. 待语句生成后，您可观察下方生成的 SQL 语句，单击“接受”或“拒绝”按钮，选择是否接受智能助手提供的语句信息。

5.2 SQL 解析-智能诊断

DataLeap 智能开发助手，它能够帮助您分析和解决SQL语句中的错误。通过“AI 诊断”和“AI 修复”能力，快速定位您的错误，并帮助您快速修改 SQL 语句，使其更加准确无误，让您的开发过程更加顺畅。

触发入口

操作动图

SQL 解析报错窗口

Image

  1. 在 SQL 编辑器界面，手动输入一段有异常的代码时，单击工具栏解析按钮，便可进行 SQL 逻辑的解析操作。
  2. 当解析异常时，可在解析报错的解决方案中，单击“AI 诊断”按钮，完成对输入 SQL 逻辑的诊断：
    • 在诊断框中会指出相应的检查入口，您可快速根据智能助手提供的诊断信息，进行错误定位并手动修正。
    • 您也可直接单击“AI 修复”按钮，通过 SQL 智能修复能力，直接对有异常的 SQL 代码进行修改，界面展示的对比修改内容，您可根据实际情况判断是否接受 AI 提供的修复方案。

5.3 SQL 智能代码补全

DataLeap SQL 智能代码补全可协助您在编写 SQL 代码时，提供自动补全建议的能力。它可以根据已输入的部分代码，为您提供后续 SQL 可能的关键字、表名、列名等补全建议，可适应不同的语法规则，提高 SQL 代码编写效率，减少输入错误。

触发入口

操作动图

SQL 代码编辑器界面

Image

  1. 在 SQL 编辑器界面，输入 SQL 语句的关键词信息后，末尾会跟随一段置灰的 SQL 提示；
  2. 将鼠标移动至灰色 SQL 提示上，您便可快速进行 SQL 补全操作；
  3. 您可根据实际提示的补全内容，进行按需进行以下选择操作：
    • 接受：您可单击“接受 Tab”按钮，或通过快捷键（Tab），将提示的内容全量接受；
    • 接受 Word：您可单击“接受 Word”按钮，或通过快捷键（Mac 电脑按住 Command + →，Windows 电脑按住 Ctrl + →），依次接受提示的单个 SQL 单词或符号；
    • 接受行：您可单击“接受行”按钮，或通过快捷键（Mac 电脑按住 Command + ↓，Windows 电脑按住 Ctrl + ↓ ），按行形式接受提示的 SQL 补全内容；
    • 取消：您可单击“取消 Esc”按钮，或通过快捷键（Esc），撤销提示的 SQL 补全内容；
    • 暂停补全 30 min：如果您临时想取消 SQL 补全提示，可单击 “...” 更多按钮，选择“暂停补全 30 min”，可临时暂停 SQL 补全提示。

5.4 SQL 智能代码解释/注释格式优化

DataLeap SQL 智能代码解释/注释/格式优化，可协助您在 SQL 编辑器中选中相关代码后，唤起智能开发助手，通过 AI 能力进行 SQL 代码解释、代码注释及代码风格优化，提高 SQL 代码可读性。

触发入口

操作动图

代码风格优化

  1. 在 SQL 编辑器界面，输入 SQL 语句；
  2. 将编辑的 SQL 代码全选，上方出现 AI 智能助手提示，单击选择代码风格优化按钮，等待优化完成，并查看差异性；
  3. 根据实际情况选择上方全部接受按钮，便可快速完成智能代码风格优化。

代码注释

  1. 在 SQL 编辑器界面，输入 SQL 语句；
  2. 将编辑的 SQL 代码全选，上方出现 AI 智能助手提示，单击选择代码注释按钮，等待全文注释完成，并查看各 SQL 注释说明；
  3. 根据实际情况选择上方全部接受按钮，便可快速完成代码智能注释。

代码解释

  1. 在 SQL 编辑器界面，输入 SQL 语句；
  2. 将需要解释的 SQL 代码全选，上方出现 AI 智能助手提示，单击选择代码解释按钮，等待语句解释完成，您便可在提示窗口中查看智能代码解释的信息。

5.5 变更摘要

您在对线上生产任务做变更或新建任务，并将其提交发布时，DataLeap 智能助手在提交上线的说明中，具备自动生成此次代码变更摘要说明的能力。

触发入口

操作动图

生成变更摘要

  1. 新建任务或对线上生产任务做代码、配置参数等变更；
  2. 保存任务后，进行重新提交操作；
  3. 在任务提交说明中，会自动通过 AI 智能助手，生成对应的变更摘要说明，您可按需选择接受、拒绝或重新生成变更说明。

5.6 版本对比总结

当任务已经提交上线过多个版本时，支持查看指定两个版本间DIFF详情，并自动生成差异的内容总结。
操作入口：任务-历史版本-版本对比，依据任务两个版本 DIFF自动生成差异内容总结。

触发入口

操作动图

历史版本对比总结

Image

  1. 当任务存在多个历史版本迭代时，单击右侧导航栏的历史版本按钮；
  2. 勾选想要对比差异的两个版本号；
  3. 单击版本对比按钮，查看版本差异详情。
最近更新时间：2026.05.15 16:11:25
这个页面对您有帮助吗？
有用
有用
无用
无用