跳到主要内容

ExternalRunRequest

workflowstring

使用路径式 /workflows/{workflowName}/run 时可省略。

Example: smoke
workflow_idstring
workflowNamestring
workflowIdstring
entrypoint_idstring

Workflow 入口 ID；省略时使用目标版本默认入口。Conversation 不接受该字段。

inputs object

按所选 Workflow entrypoint（Conversation 则为 executor）的 params 命名传入结构化输入。multiple: true 或 control: "checkboxes" 的非 file 参数会序列化为 JSON 数组字符串。 control: "textarea" 只影响 Desktop/server 表单展示，仍按普通字符串输入处理。 日期相关 control 同样保持字符串：date 为 YYYY-MM-DD、time 为 HH:mm:ss、datetime 为本地 YYYY-MM-DDTHH:mm:ss、date-range 为闭区间 YYYY-MM-DD/YYYY-MM-DD，不会进行时区转换。 boolean 参数默认值为 "true" 且输入 false 时会显式传入 false。

property name*any

按所选 Workflow entrypoint（Conversation 则为 executor）的 params 命名传入结构化输入。multiple: true 或 control: "checkboxes" 的非 file 参数会序列化为 JSON 数组字符串。 control: "textarea" 只影响 Desktop/server 表单展示，仍按普通字符串输入处理。 日期相关 control 同样保持字符串：date 为 YYYY-MM-DD、time 为 HH:mm:ss、datetime 为本地 YYYY-MM-DDTHH:mm:ss、date-range 为闭区间 YYYY-MM-DD/YYYY-MM-DD，不会进行时区转换。 boolean 参数默认值为 "true" 且输入 false 时会显式传入 false。

Default value: {}
argsstring[]
files[]
userstringrequired
Example: external-user
conversation_idstring
conversationIdstring
response_modestring

Possible values: [blocking, streaming]

Default value: blocking
targetstring

latest、draft 或语义化版本号。

Example: latest
versionstring

指定语义化版本号的别名；未提供 target 时会作为运行目标。

ExternalRunRequest
{
  "workflow": "smoke",
  "workflow_id": "string",
  "workflowName": "string",
  "workflowId": "string",
  "entrypoint_id": "string",
  "inputs": {},
  "args": [
    "string"
  ],
  "files": [
    null
  ],
  "user": "external-user",
  "conversation_id": "string",
  "conversationId": "string",
  "response_mode": "blocking",
  "target": "latest",
  "version": "string"
}