运行流水线 - Dify Docs

Authorizations

Authorization

string

header

required

每个请求都通过 API Key 认证：Authorization: Bearer {API_KEY}。应用接口使用应用 API Key，知识库接口使用知识库 API Key（快速开始）。

API Key 应保存在服务端，切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401（unauthorized）。

Path Parameters

dataset_id

string<uuid>

required

知识库 ID。从获取知识库列表获取。

Body

application/json

datasource_info_list

(Local File · object | Online Document · object | Website Crawl · object | Online Drive · object)[]

required

待处理的数据源对象列表。条目结构取决于 datasource_type。

Local File
Online Document
Website Crawl
Online Drive

Show child attributes

datasource_type

enum<string>

required

数据源类型。决定 datasource_info_list 中条目所需的字段。

Available options:

local_file,

online_document,

website_crawl,

online_drive

inputs

object

required

流水线输入变量的键值对，对应工作流中定义的流水线变量。如果流水线没有输入变量，传 {}。

is_published

boolean

required

是否运行流水线的已发布版本，而非当前草稿。运行草稿可测试未发布的更改。

response_mode

enum<string>

required

流水线执行的响应模式。streaming 返回服务器发送事件流，blocking 等待并返回完整结果。

Available options:

streaming,

blocking

start_node_id

string

required

开始执行的节点 ID，来自获取数据源插件列表。

Response

流水线执行结果。格式取决于 response_mode：流式返回 text/event-stream，阻塞返回完整的 JSON 结果。

完整的流水线执行结果。当 response_mode 为 blocking 时返回。