一、插件简介

扣子工作流接口插件将迅睿CMS与扣子（Coze）AI工作流平台无缝集成，实现网站数据的自动化AI处理。

核心能力：

多套API配置管理，支持不同工作流独立对接

可视化参数映射，迅睿字段与扣子参数灵活对应

依托系统异步队列执行，不阻塞后台操作

完整的执行记录与日志追踪

超时自动检测、失败自动重试机制

支持所有迅睿CMS字段类型

二、快速上手

使用流程

第1步：注册扣子账号 → 创建工作流 → 获取API Token和工作流ID

↓

第2步：在插件中添加API配置（填入Token、工作流ID等）

↓

第3步：创建工作流配置（绑定模块、配置发送/接收参数映射）

↓

第4步：进入数据列表，选择数据入队

↓

第5步：系统自动执行，在执行记录中查看结果

最简配置示例

假设你想实现：将草稿文章的标题和内容发送给扣子，让AI优化后写回。

添加API配置：填写扣子API Token和工作流ID，数据来源选"草稿表"

添加工作流配置：

关联上一步的API配置

绑定模块选择你的内容模块（如"news"）

发送参数：title（迅睿标题字段）→ title（扣子输入参数名），content → content

接收参数：title（扣子输出参数名）→ title（迅睿标题字段），content → content

入队执行：进入数据列表，勾选草稿数据，点击批量入队

三、API配置管理

进入后台「扣子工作流接口」→「API配置」，可管理所有扣子平台的API连接配置。

四、工作流配置管理

进入后台「扣子工作流接口」→「工作流管理」，可管理所有工作流配置。每个工作流配置绑定一个API配置和一个内容模块，定义了数据的发送和接收映射关系。

4.1 添加工作流

点击「添加工作流」按钮，填写以下信息：

| 字段 | 说明 | 是否必填 | |------|------|---------| | 工作流名称 | 标识此工作流配置，如"标题优化" | 是 | | 关联API配置 | 选择已创建的API配置，决定调用哪个扣子工作流 | 是 | | 绑定模块 | 选择要处理的迅睿CMS内容模块 | 是 | | 最大内容长度 | 发送内容字段的最大字符数，超出部分将被截断，默认3000 | 否 | | 状态 | 启用/禁用此工作流 | 否（默认启用） | | 排序 | 数字越小越靠前 | 否 |

选择模块后，系统会自动加载该模块的所有字段，供后续参数映射使用。

4.2 配置发送参数

发送参数定义了哪些迅睿CMS字段的数据发送给扣子工作流。

每行配置包含：

| 项目 | 说明 | |------|------| | 迅睿字段名 | 从下拉列表中选择模块字段（如 title、content） | | 迅睿字段类型 | 自动识别，如 Text、Textarea、Selects 等 | | 扣子参数名 | 对应扣子工作流的输入参数名称 | | 扣子参数类型 | 扣子工作流的参数类型，通常为 String |

配置要点：

扣子参数名必须与工作流中定义的输入参数名完全一致

至少需要配置一个发送参数

数组类型字段（如 Checkbox、Selects）会自动序列化为JSON字符串发送

内容字段超过最大长度限制时会被自动截断

4.3 配置接收参数

接收参数定义了扣子工作流返回的数据如何写入迅睿CMS字段。

每行配置包含：

| 项目 | 说明 | |------|------| | 扣子响应字段 | 扣子工作流输出中的字段名 | | 扣子字段类型 | 扣子输出的字段类型 | | 迅睿字段名 | 要写入的迅睿CMS模块字段 | | 迅睿字段类型 | 目标字段的类型，影响数据格式转换 |

配置要点：

至少需要配置一个接收参数

支持嵌套字段提取，系统会自动识别字段属于主表还是附表，分别更新

字段类型会自动适配

4.4 配置筛选条件

筛选条件用于过滤数据列表中显示的数据，帮助快速定位需要处理的内容。

支持的筛选类型：

| 类型 | 说明 | 示例 | |------|------|------| | 为空 | 字段值为空或NULL | 筛选标题为空的数据 | | 包含 | 字段值包含指定文本 | 标题包含"待优化" | | 长度小于 | 字段值字符长度小于指定值 | 内容长度