Skip to main content

编辑排队指令

千问办公企业旗舰版开发者文档:编辑排队指令。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务
  • 接口: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。

请求体

字段类型必填说明
filesarray否附件列表,最多 50 个;文件必须已存储,本接口不负责上传。maxItems=50。
files[].pathstring是已有文件的存储路径,例如上传文件或之前的会话产物;不得包含 ..,仅可访问当前账户有权使用的文件。minLength=1。
textstring是提交给 Agent 的指令文本,长度 1~100000 个字符。

成功响应

HTTP 200

字段类型必填说明
editedboolean是见接口说明
prompt_idstring是见接口说明

错误与边界

401:入口身份无效;404:资源不存在、已删除或非本人;422:输入无效;503:所需依赖未装配或暂不可用。业务状态和审核拒绝按服务端错误体处理。 队列项不可编辑返回409,内容审核阻断返回403。 本接口不接受调用方传入身份来改变归属,不暴露内部 extra_data、沙箱凭据或模型 runtime 配置。写入超时后先查询实际状态,不把超时视为操作未发生。