千问办公企业旗舰版开发者文档:编辑排队指令。
认证方式见APP开发者文档 → 认证接入。
整体替换仍在当前会话队列中的指令文本与附件。prompt_id 使用会话返回的 UUID。text 必须非空白且不超过100000 UTF-8字节,files 最多50个;省略 files 表示清空旧附件。复用原附件映射与指令内容审核,再调用 Gateway 按会话和指令ID进行原子编辑。已消费、已删除、不存在或不属于此会话的队列项返回409 PROMPT_NOT_EDITABLE,不修改正在执行的 Turn。
401:入口身份无效;404:资源不存在、已删除或非本人;422:输入无效;503:所需依赖未装配或暂不可用。业务状态和审核拒绝按服务端错误体处理。 队列项不可编辑返回409,内容审核阻断返回403。
本接口不接受调用方传入身份来改变归属,不暴露内部 extra_data、沙箱凭据或模型 runtime 配置。写入超时后先查询实际状态,不把超时视为操作未发生。
- 模块:会话服务
- 接口:PATCH
/api/openapi/app/v1/sessions/{session_id}/prompt-queue/{prompt_id} - operationId:
edit-queued-prompt
接口说明
整体替换仍在当前会话队列中的指令文本与附件。prompt_id 使用会话返回的 UUID。text 必须非空白且不超过100000 UTF-8字节,files 最多50个;省略 files 表示清空旧附件。复用原附件映射与指令内容审核,再调用 Gateway 按会话和指令ID进行原子编辑。已消费、已删除、不存在或不属于此会话的队列项返回409 PROMPT_NOT_EDITABLE,不修改正在执行的 Turn。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| session_id (path) | string | 是 | 创建或列出会话接口返回的会话 ID。 |
| prompt_id (path) | string | 是 | 会话 Prompt 队列返回的 Prompt ID。 |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| files | array | 否 | 附件列表,最多 50 个;文件必须已存储,本接口不负责上传。maxItems=50。 |
| files[].path | string | 是 | 已有文件的存储路径,例如上传文件或之前的会话产物;不得包含 ..,仅可访问当前账户有权使用的文件。minLength=1。 |
| text | string | 是 | 提交给 Agent 的指令文本,长度 1~100000 个字符。 |
成功响应
HTTP 200
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| edited | boolean | 是 | 见接口说明 |
| prompt_id | string | 是 | 见接口说明 |