千问办公企业旗舰版开发者文档:发送后续指令。
认证方式见APP开发者文档 → 认证接入。
JSON请求体必填。
媒体类型:
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
- 模块:会话服务(session)
- 接口:POST
/api/openapi/app/v1/sessions/{session_id}/prompt
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| session_id | path | string | 是 | 创建会话接口返回的会话 ID。 |
请求体
JSON请求体必填。
请求 PromptRequest
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| files | array<PromptFile> | 否 | maxItems=50 | 附件列表,最多 50 个;文件必须已存储,本接口不负责上传。 |
| text | string | 是 | minLength=1;maxLength=100000 | 提交给 Agent 的指令文本,长度 1~100000 个字符。 |
请求 PromptFile
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| path | string | 是 | minLength=1 | 已有文件的存储路径,例如上传文件或之前的会话产物;不得包含 ..,仅可访问当前账户有权使用的文件。 |
响应
| HTTP | 说明 |
|---|---|
| 202 | 已接收请求 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应202 PromptResponse
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| prompt_id | string | 是 | — | 排队 Prompt 的 ID;尚未开始执行时,可用于删除对应队列项。 |
| status | string | 是 | 固定为 queued | 固定为 queued,表示已接收但尚未开始执行。查询会话状态判断运行情况;prompt_response 表示本轮结束。 |
| turn_id | string | 是 | — | 此 Prompt 对应的回合 ID,在开始执行前即可取得;可用于查询回合详情或筛选事件流。 |