提示: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 支持通过 AI，查看/管理/删除事件调度 支持通过 AI，查找数据连接资源 支持通过 AI，查看定时任务血缘 |
1.2 应用场景
针对定时任务，用户不需要先学会所有菜单和配置项，只需要用自然语言描述目标，AI 就可以调用 FDL 的 MCP 能力完成查询、分析和受控写入。
| 场景 | 该功能作用 |
|---|---|
| 已有较多离线任务的客户 | 快速理解历史任务，降低交接和排查成本 |
| 调度维护压力大的客户 | 用自然语言查询、创建、开关和修改调度，减少找菜单和记配置成本 |
| 需要批量搭建同步任务的客户 | 把重复性 DB 到 DB 同步任务交给 AI 生成，用户只确认计划 |
| 任务文档和注释缺失的客户 | 让 AI 根据任务结构生成维护注释，沉淀到任务内 |
| 需要复制模板任务的客户 | 用已有任务作为模板，批量复制到指定目录 |
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 配置
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 中如何描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 查找定时任务和文件夹 | 帮我查找名称中包含“订单同步”的定时任务 找到“销售数据同步”任务所在的完整目录 查看“财务数据”文件夹下有哪些任务 | ||||||||||
| 批量创建定时任务 | 用户可以一次创建一个或多个空白定时任务，并指定任务名称及所在目录。创建完成后，可以继续通过自然语言向任务中添加节点和配置执行流程，无须逐个进入任务页面手动搭建 例如： 在“数据同步/财务”目录下创建“应收数据同步”和“应付数据同步”两个定时任务 | ||||||||||
| 查看和编辑任务画布 | 用户可以查看定时任务当前的节点、连线和执行顺序，并通过 AI 对任务画布进行基础编辑。目前支持新增数据同步、SQL脚本、参数赋值3类节点 例如： 在“订单同步”任务中增加一个数据同步节点，将业务库的 orders 表同步到数仓。 在数据同步节点后增加一个 SQL 脚本节点，并把两个节点连接起来。 删除任务中的“测试SQL”节点。 用户还可以：连接不同节点，设置任务执行顺序； 删除指定节点及其关联连线； 查看调整后的任务结构； 在编辑完成后发布任务 | ||||||||||
| 配置数据同步范围 | 通过 AI 创建数据同步节点时，可以进一步指定需要同步的数据范围 例如： 只同步 orders 表中 status 等于 1 的数据。 只同步 id、name 和 status 三个字段。 将源表主键作为目标表主键，并自动创建目标表 | ||||||||||
| 发布定时任务 | 任务编排完成后，用户可以让 AI 执行发布前检查并发布任务 例如： 检查“订单同步”任务是否可以发布 发布“订单同步”和“客户同步”两个任务 对比这个任务的开发态和发布态有什么变化 | ||||||||||
| 管理任务控制属性 | 用户可以通过自然语言查看或修改定时任务的控制属性，不需要完整填写所有配置。控制属性支持仅保存、仅发布、保存并发布三种操作方式，支持管理的属性主要包括：
例如： 把“订单同步”任务优先级调整为高 开启任务失败重试，失败后重试3次 任务执行失败时，通过邮件通知张三 将任务日志等级调整为详细。 修改配置后直接保存并发布 | ||||||||||
| 删除任务和文件夹 | 用户可以删除指定任务，也可以递归删除某个文件夹及其下属资源 例如： 删除“测试订单同步”任务 删除“历史测试任务”文件夹及其中的所有任务 |
上一篇：回收站
