千问办公企业旗舰版开发者文档:查询排队指令。
认证方式见APP开发者文档 → 认证接入。
媒体类型:
附件列表只提供展示元数据,不提供文件路径、下载 URL、凭据或内联文件内容。
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
- 模块:会话服务(session)
- 接口:GET
/api/openapi/app/v1/sessions/{session_id}/prompt-queue
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| session_id | path | string | 是 | 创建会话接口返回的会话 ID。 |
响应
| HTTP | 说明 |
|---|---|
| 200 | 请求成功 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应200 PromptQueueResponse
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| items | array<QueuedPrompt> | 是 | — | 等待执行的 Prompt,按执行顺序排列;队列为空时返回空数组,不为 null。当前执行的 Prompt 由会话详情 current_turn 表示。 |
响应200 QueuedPrompt
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| attachments | array<QueuedAttachment> | 是 | 可为空数组,不为 null | 按原始输入顺序返回附件展示信息。纯文字输入返回空数组。 |
| created_at | string / null | 是 | ISO 8601 时间字符串 | 进入队列的时间,ISO 8601,含微秒和时区。队列项没有时间戳时为 null;执行顺序应以 position 为准。 |
| position | integer | 是 | format="int64" | 队列位置,从 1 开始;1 表示下一条待执行,并非已经运行,要等待当前回合结束。 |
| prompt_id | string | 是 | — | 用于撤回仍在等待的 Prompt,传入删除队列项接口。 |
| text | string | 是 | — | 用户提交的原始 Prompt 文本。 |
响应200 QueuedAttachment
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| name | string | 是 | 可为空字符串 | 原始附件文件名。没有名称的附件由客户端显示本地化占位提示。 |
text 保留原始正文;仅附件输入的 text 为空字符串,应使用 attachments 展示文件名,不能将其当作空队列项。