提示:1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.20.3&5.0.13.3 | 1)支持将部分定时任务读写能力开放给 AI 客户端 2)用户完成 Token 配置后,可以在 AI 客户端中查询任务、解释任务、查看调度,并在具 备写入权限时发起创建任务(数据同步)、修改调度、复制任务、写回注释等操作 |
| 4.2.21.1&5.0.14.1 | 需要更新插件版本为 1.0.0.2 1)支持通过 AI 查看、管理和删除事件调度 |
| 4.2.21.2&5.0.14.2 | 1)支持修改已有数据同步、SQL 脚本、参数赋值节点 2)支持新增和修改调用任务节点,并支持节点启停、连线新增、条件修改及删除 3)支持执行开发态或发布态任务,可执行整个任务、单节点或节点及下游 4)支持查询和管理任务参数,创建多层目录以及移动任务和文件夹 |
| 4.2.21.3&5.0.14.3 | 1)定时任务资源支持按文件夹浏览和搜索,可查看直接子项或全部后代,并支持资源类型筛选和分页 2)运行记录支持跨任务查询,可按状态、时间、触发方式、脏数据等条件筛选 3)大型事件调度配置支持分页查看 |
| 4.2.22.1&5.0.15.1 | 1)任务执行新增「执行至此节点」,可执行目标节点及其全部上游 |
| 4.2.22.2&5.0.15.2 | 1)定时任务资源支持通过任务 ID、精确名称和名称模糊匹配查询,并优化批量查询性能 2)优化定时任务创建、发布、删除及控制属性管理等批量操作,单次最多支持 50 个任务;批量创建数据同步任务最多支持 500 个同步节点 3)优化任务调度、运行记录等大数据量场景下的查询性能 4)增强事件调度及运行记录查询的异常兼容能力,提升 AI 对任务状态和异常信息的判断准确性 |
| 4.2.22.4&5.0.15.4 | 1)支持批量创建和修改 Shell、BAT、Python 脚本节点,单次最多支持 50 个节点; 2)支持批量配置脚本节点的连接、路径、参数、字符集及超时等属性; 3)增强脚本节点上下游参数引用能力,可自动识别上游参数来源; 4)完善脚本节点详情查询能力,支持查看配置、参数引用及来源信息 |
1.2 应用场景
针对定时任务,用户不需要先学会所有菜单和配置项,只需要用自然语言描述目标,AI 就可以调用 FDL 的 MCP 能力完成查询、分析和受控写入。
| 场景 | 该功能作用 |
|---|---|
| 已有较多离线任务的客户 | 快速理解历史任务,降低交接和排查成本 |
| 调度维护压力大的客户 | 用自然语言查询、创建、开关和修改调度,减少找菜单和记配置成本 |
| 需要批量搭建同步任务的客户 | 把重复性 DB 到 DB 同步任务交给 AI 生成,用户只确认计划 |
| 任务文档和注释缺失的客户 | 让 AI 根据任务结构生成维护注释,沉淀到任务内 |
| 需要复制模板任务的客户 | 用已有任务作为模板,批量复制到指定目录 |
| 需要快速排查任务异常的客户 | 查询最近失败、运行中或存在脏数据的任务实例,并结合运行日志和当次配置快照定位问题 |
| 想要批量高效创建数据开发任务的客户 | 通过自然语言创建数据同步、SQL 脚本、参数赋值等节点,并完成节点连线和配置修改 |
| 需要优化调整已有任务的客户 | 无需删除并重新创建节点,可直接修改数据同步、SQL 脚本、参数赋值及调用任务节点配置 |
| 需要管理任务版本的客户 | 查看历史发布版本,对比开发态、发布态和历史版本,并完成发布、还原或回滚 |
1.3 功能简介
1)用户安装「FDL MCP Gateway」插件后,在 FDL 工程中完成 Token 配置。如下图所示:

2)用户将 Token 粘贴到 AI 客户端中,AI 客户端识别 FDL 工程,可使用 AI 工具查看定时任务的任务调度、任务依赖、注释位置等;或者复制定时任务、管理时间调度、快速完成数据开发任务的查看、编辑与编排等。

1.4 当前适用范围与边界
| 场景 | 适用范围与边界 |
|---|---|
| 任务范围 | 当前以离线任务为主,不覆盖实时任务、数据服务和离线管道任务 |
| 任务执行与终止 |
|
| 任务版本管理 |
|
| 查询默认逻辑 | 未指定环境时,优先读取发布环境;发布环境不存在时,再回退开发环境 |
| 时间调度能力 | 支持查看、查找、创建、开启、关闭、修改和删除时间调度。修改调度不调整绑定任务 |
| 时间调度成员管理 |
|
| 任务资源和画布管理 |
|
| 任务依赖能力 | 支持解释事件调度和调用任务依赖;事件调度不在依赖工具中展示,需要单独查询 |
| 同步任务创建能力 | 支持 DB→DB,同步源支持表或 SQL,目标支持已有表或自动建表;PostgreSQL 系列目标支持按数据源能力选择 JDBC、COPY 装载或并行装载 |
| 目录处理 | 指定目录不存在时,会按路径自动创建;批量创建同步任务如果某个自动创建路径下全部任务失败,会清理空目录 |
| 数据连接权限 | 批量创建同步任务会校验来源和目标数据连接权限,避免用户只凭连接名绕过平台授权 |
| 注释写回 | 只写开发态任务,不自动发布;默认不覆盖已有注释,用户明确要求覆盖时才覆盖 |
| 操作保护 | 所有写操作都需要确认;涉及重名对象时会先返回候选,不直接执行 |
| 任务数量限制 |
|
| 操作次数限制 | 新增节点、连接节点或删除节点时,单次最多处理 50 项操作 |
| 批量操作 |
|
| 大数据量查询和分页 |
|
| 任务定位与权限语义统一 |
|
2. 操作步骤
2.1 安装插件
1)填写 表单,获取 FineDataLink MCP 优先体验资格。
2)参考 插件管理 文档,安装插件。
注:若工程升级到 4.2.21.1 及之后版本,需要更新插件版本为 1.0.0.2
2.2 MCP 配置
注:从 4.2.21.1 起,使用 MCP 前需要管理员为对应用户开放「管理系统 > FDL MCP > 使用」权限。用户仍需同时具备所操作任务、目录和数据连接等资源权限
1)点击「MCP配置」Tab,再点击「立即生成」按钮,生成用于连接 AI 客户端的访问凭证,可定时任务能力开放给 AI 客户端。如下图所示:

| 设置项 | 说明 | ||||||
|---|---|---|---|---|---|---|---|
| 有效期 | 1)用于控制 Token 可使用时间;根据实际情况设置
2)到期后,AI 客户端继续使用旧配置会鉴权失败,用户需重新生成并复制配置 3)若想修改有效期,点击「重置」按钮即可,不重新生成 Token,旧 Token 依然生效
| ||||||
| MCP接口权限 | 1)权限分为读取能力和写入能力;具体权限说明可到产品界面内查看
2)若想修改权限,需要点击「重新生成」按钮,生成新的 Token,旧 Token 会失效
| ||||||
| Token说明 | 1)如果 AI 工具是 Codex/Claude Code,产品界面提供了完整配置(下图中第二个复制按钮),可将其复制到Codex/Claude Code 的配置文件中 2)如果是其他 AI 工具,复制 MCP 服务的身份认证信息(点击下图中第一个复制按钮),将其填写到 AI 工具 MCP 配置中的 Authorization 请求头中
| ||||||
| 其他说明 | 1)Token 归属于当前 FDL 登录用户 2)每个用户仅有一个当前有效 Token 3)Token 权限由读取能力、写入能力决定,同时受用户自身 FDL 权限约束 |
2)MCP Token 生成后,界面如下图所示:

2.3 操作安全保障
| 步骤 | 说明 |
|---|---|
| 执行前预览与确认 |
|
| 权限校验 |
|
| 操作记录 |
|
2.4 示例:Codex 中使用
注:本节以 Codex 为例,讲解使用步骤。
1)复制 Token。如下图所示:

2)将 Token 粘贴到 Codex 配置文件 config.toml 中;手动粘贴或者让 Codex 自行配置。如下图所示:

3)读取示例:使用 Codex 查询某个定时任务的调度配置信息。如下图所示:

4)写入示例:使用 Codex 复制定时任务。

FDL 工程中可查看到名称为「测试1」的定时任务。

3. 详细功能介绍
| 场景 | AI 中如何描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 查找定时任务和文件夹 | 帮我查找名称中包含“订单同步”的定时任务 找到“销售数据同步”任务所在的完整目录 查看“财务数据”文件夹下有哪些任务 | ||||||||||
| 查询数据连接和表结构 | 找一下“业务库”这个数据连接 | ||||||||||
| 查看数据表血缘 | 找到 ods_order 表,并查看它上游 3 层有哪些表和任务 哪些定时任务使用了 customer_info 表 | ||||||||||
| 批量创建定时任务 | 用户可以一次创建一个或多个空白定时任务,并指定任务名称及所在目录。创建完成后,可以继续通过自然语言向任务中添加节点和配置执行流程,无须逐个进入任务页面手动搭建 例如: 在“数据同步/财务”目录下创建“应收数据同步”和“应付数据同步”两个定时任务 | ||||||||||
| 查看和编辑任务画布 | 用户可以查看定时任务当前的节点、连线和执行顺序,并通过 AI 对任务画布进行基础编辑。目前支持新增数据同步、SQL脚本、参数赋值3类节点 例如: 在“订单同步”任务中增加一个数据同步节点,将业务库的 orders 表同步到数仓。 在数据同步节点后增加一个 SQL 脚本节点,并把两个节点连接起来。 删除任务中的“测试SQL”节点。 用户还可以:连接不同节点,设置任务执行顺序; 删除指定节点及其关联连线; 查看调整后的任务结构; 在编辑完成后发布任务 | ||||||||||
| 配置数据同步范围 | 通过 AI 创建数据同步节点时,可以进一步指定需要同步的数据范围 例如: 只同步 orders 表中 status 等于 1 的数据。 只同步 id、name 和 status 三个字段。 将源表主键作为目标表主键,并自动创建目标表 | ||||||||||
| 发布定时任务 | 任务编排完成后,用户可以让 AI 执行发布前检查并发布任务 例如: 检查“订单同步”任务是否可以发布 发布“订单同步”和“客户同步”两个任务 对比这个任务的开发态和发布态有什么变化 | ||||||||||
| 运行定时任务 | 执行“订单同步”开发态任务 只运行“订单清洗”节点 执行到“数据入仓”节点为止 | ||||||||||
| 终止任务运行 | 找出“订单同步”当前正在运行的实例并停止 终止这个 executionId 对应的运行实例 | ||||||||||
| 管理任务控制属性 | 用户可以通过自然语言查看或修改定时任务的控制属性,不需要完整填写所有配置。控制属性支持仅保存、仅发布、保存并发布三种操作方式,支持管理的属性主要包括:
例如: 把“订单同步”任务优先级调整为高 开启任务失败重试,失败后重试3次 任务执行失败时,通过邮件通知张三 将任务日志等级调整为详细。 修改配置后直接保存并发布 | ||||||||||
| 删除任务和文件夹 | 用户可以删除指定任务,也可以递归删除某个文件夹及其下属资源 例如: 删除“测试订单同步”任务 删除“历史测试任务”文件夹及其中的所有任务 | ||||||||||
| 任务运行异常快速定位 | AI 自动查询任务运行记录和执行日志,定位异常节点和失败原因并给出排查建议 例如: 帮我分析订单同步这个任务失败的原因 | ||||||||||
| 管理事件调度 | AI 展示任务组关系、触发条件和上下游编排关系,帮助理解复杂调度链路 例如: 查看“订单同步”属于哪个事件调度组 | ||||||||||
| 批量排查异常任务 | AI 查询任务运行状态,快速筛选异常任务,帮助运维人员集中处理问题 例如: 帮我查看今天有哪些任务运行失败或者存在脏数据 | ||||||||||
| 根据数据表定位关联任务及上下游链路 | AI 根据数据表定位引用该表的任务,进一步查询相关任务的依赖关系和上下游链路,帮助用户快速了解数据流转过程和影响范围 例如: 帮我查看 customer_info 表被哪些任务使用,以及这些任务的上下游关系 | ||||||||||
| 查看和管理历史版本 | 查看“订单同步”的历史发布版本 | ||||||||||
| MCP 扩展能力 | MCP 不仅可以让 AI 客户端直接查询和操作 FDL,也可以将 FDL 能力接入飞书等其他平台,拓展更多使用方式
|
