Skip to main content

查询排队指令

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

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

请求参数

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

响应

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

响应200 PromptQueueResponse

字段类型必填约束契约说明
itemsarray<QueuedPrompt>是—等待执行的 Prompt,按执行顺序排列;队列为空时返回空数组,不为 null。当前执行的 Prompt 由会话详情 current_turn 表示。

响应200 QueuedPrompt

字段类型必填约束契约说明
attachmentsarray<QueuedAttachment>是可为空数组,不为 null按原始输入顺序返回附件展示信息。纯文字输入返回空数组。
created_atstring / null是ISO 8601 时间字符串进入队列的时间,ISO 8601,含微秒和时区。队列项没有时间戳时为 null;执行顺序应以 position 为准。
positioninteger是format="int64"队列位置,从 1 开始;1 表示下一条待执行,并非已经运行,要等待当前回合结束。
prompt_idstring是—用于撤回仍在等待的 Prompt,传入删除队列项接口。
textstring是—用户提交的原始 Prompt 文本。

响应200 QueuedAttachment

字段类型必填约束契约说明
namestring是可为空字符串原始附件文件名。没有名称的附件由客户端显示本地化占位提示。
附件列表只提供展示元数据,不提供文件路径、下载 URL、凭据或内联文件内容。text 保留原始正文;仅附件输入的 text 为空字符串,应使用 attachments 展示文件名,不能将其当作空队列项。

使用说明

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