部署环境
执行工作流
适用于:Workflow。
运行已部署的 Workflow 版本,支持阻塞和流式两种模式。
对应的标准 API 接口:执行工作流。差异:
- 忽略
workflow_id和请求体中的未知字段。 - 接受
trace_id和trace_session_id。 - 请求体上限为 8 MiB。
- 流中不包含 TTS、人工介入、Agent 日志和检索来源事件。运行进入人工介入步骤时会失败。
- 错误码不同。
POST
授权
请求头
与请求体字段 trace_id 相同,优先读取。
与请求体字段 trace_session_id 相同,优先读取。
查询参数
与请求体字段 trace_id 相同,在请求头之后读取。
与请求体字段 trace_session_id 相同,在请求头之后读取。
请求体
application/json
应用输入变量的值,以变量名为键。请按照目标环境当前部署版本中定义的输入变量传值。
单文件变量传入一个文件对象,文件列表变量传入文件对象数组;文件对象的结构与 files 中的条目相同。
指定响应如何返回。
streaming:运行每产出一个事件就立即返回,适合快速回复以外的所有场景。blocking:运行结束后一次性返回一个响应。
可用选项:
streaming, blocking 追踪标识,会传递到可观测性数据中。可使用字母、数字、连字符和下划线,最长 128 个字符。不符合的值直接跳过,不会报错。
追踪会话标识,会传递到可观测性数据中,去除首尾空白后长度为 1 到 200 个字符。
Required string length:
1 - 200响应
内容类型和结构取决于请求中的 response_mode 参数。
- 如果
response_mode为blocking,返回application/json和WorkflowBlockingResponse对象。 - 如果
response_mode为streaming,返回text/event-stream和ChunkWorkflowEvent对象流。