千问办公企业旗舰版开发者文档:回应待处理问答。
认证方式见APP开发者文档 → 认证接入。
JSON请求体必填。
媒体类型:
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
- 模块:会话服务(session)
- 接口:POST
/api/openapi/app/v1/sessions/{session_id}/question-response
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| session_id | path | string | 是 | 创建会话接口返回的会话 ID。 |
请求体
JSON请求体必填。
请求 QuestionResponseRequest
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| option_id | string | 否 | — | 通常无需填写。问题回答使用 updated_input.answers,提交 pending_action 中选项的 label。仅当权限型问题明确返回选项 ID 时才使用此字段,不自行构造。 |
| outcome | string | 否 | enum=["selected", "cancelled"] | 提交回答时为 selected,拒绝回答时为 cancelled,默认 selected。拒绝会解除等待,Agent 在没有回答的情况下继续,不代表停止回合。 |
| tool_call_id | string | 是 | minLength=1 | 所回答问题的标识,取自会话详情的 pending_action.tool_call_id。 |
| updated_input | AnswerPayload | 否 | — | 问题回答载荷。AskUserQuestion 每道题对应 answers 中一项,顺序与 pending_action.questions 一致。 |
请求 AnswerPayload
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| answers | array<string> | 否 | — | 按 pending_action.questions 顺序提交,每道题对应一个字符串。有选项时原样提交 label,自由输入题提交文本。多选仍放在同一个字符串中,例如“春季, 夏季”,由 Agent 理解,不由接口解析为结构化多选;需要可靠执行的选择优先使用单选。 |
响应
| HTTP | 说明 |
|---|---|
| 202 | 已接收请求 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应202 QuestionResponseAck
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| status | string | 是 | 固定为 accepted | 固定为 accepted,表示回答已交付;回合随后恢复。可查询会话状态确认其离开 action_required。 |
| tool_call_id | string | 是 | — | 本次回答对应的 tool_call_id,回显供核对。 |