编排插件

功能概述

编排插件位于 能力扩展 → 编排插件，封装可复用的 HTTP 请求、数据库查询或代码处理，并通过明确的输入输出供流程调用。以下示例使用代码插件生成咨询回执。

1. 创建代码插件

进入 能力扩展 → 编排插件，点击 新增，名称填写 DOCS_咨询受理回执，版本为 1.0.0，类型选择 代码。

类型	执行定义	缺省产出
API	URL、方法、内容类型、请求头、查询参数与请求体	status、headers、body、result
数据库	数据源与参数化 SQL	rows、count、result
代码	JavaScript main(params)	result

插件保存后类型固定；版本号是插件自身的业务版本标记。

2. 声明参数

添加一个入参：

变量名	类型	在流程中的取值示例
message	string	{{start.message}}

出参点击 填入缺省产出，保留 result，类型为 object。插件调试直接填写 message 的值，不依赖流程上下文。

代码插件的输入、输出与执行定义。

3. 编写处理逻辑

function main(params) {
  return {
    message: "已收到您的咨询：" + params.message,
    next: "请补充使用场景、当前环境和预期结果。"
  };
}

返回对象整体写入 result，可通过 result.message、result.next 读取。结果过滤可留空；需要整理返回数据时，使用形参 data 返回新的 result。

API 插件的模板变量写作 {{参数名}}。数据库插件选择已配置的数据源，SQL 变量按参数绑定执行；查询范围和结果先在 SQL 查询控制台 中核对。

4. 运行并核对

保存插件，在调试区的 message 输入：

如何配置知识库召回参数？

点击 运行，调试结果显示 SUCCESS，展开 result 可见：

{
  "message": "已收到您的咨询：如何配置知识库召回参数？",
  "next": "请补充使用场景、当前环境和预期结果。"
}

调试结果：显示执行状态与 result 内容。

5. 在流程中使用

添加 插件 节点，选择该插件，将 message 映射到开始节点的文本输入，再将 result 或其中字段交给后续节点。修改插件执行定义后，重新调试引用它的流程。

保存后的代码插件与调试入口。

导入与复用

列表支持 JSON 导入与导出。导入后核对资源引用、参数和执行定义，尤其是目标环境的数据源与服务地址。