Skip to main content

发送后续指令

千问办公企业旗舰版开发者文档:发送后续指令。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务(session)
  • 接口:POST/api/openapi/app/v1/sessions/{session_id}/prompt

请求参数

参数位置类型必填说明
session_idpathstring是创建会话接口返回的会话 ID。

请求体

JSON请求体必填。

请求 PromptRequest

字段类型必填约束契约说明
filesarray<PromptFile>否maxItems=50附件列表,最多 50 个;文件必须已存储,本接口不负责上传。
textstring是minLength=1;maxLength=100000提交给 Agent 的指令文本,长度 1~100000 个字符。

请求 PromptFile

字段类型必填约束契约说明
pathstring是minLength=1已有文件的存储路径,例如上传文件或之前的会话产物;不得包含 ..,仅可访问当前账户有权使用的文件。

响应

HTTP说明
202已接收请求
default错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。
媒体类型:application/json。

响应202 PromptResponse

字段类型必填约束契约说明
prompt_idstring是—排队 Prompt 的 ID;尚未开始执行时,可用于删除对应队列项。
statusstring是固定为 queued固定为 queued,表示已接收但尚未开始执行。查询会话状态判断运行情况;prompt_response 表示本轮结束。
turn_idstring是—此 Prompt 对应的回合 ID,在开始执行前即可取得;可用于查询回合详情或筛选事件流。

使用说明

创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。