Skip to main content

回应待处理问答

千问办公企业旗舰版开发者文档:回应待处理问答。

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

请求参数

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

请求体

JSON请求体必填。

请求 QuestionResponseRequest

字段类型必填约束契约说明
option_idstring否—通常无需填写。问题回答使用 updated_input.answers,提交 pending_action 中选项的 label。仅当权限型问题明确返回选项 ID 时才使用此字段,不自行构造。
outcomestring否enum=["selected", "cancelled"]提交回答时为 selected,拒绝回答时为 cancelled,默认 selected。拒绝会解除等待,Agent 在没有回答的情况下继续,不代表停止回合。
tool_call_idstring是minLength=1所回答问题的标识,取自会话详情的 pending_action.tool_call_id。
updated_inputAnswerPayload否—问题回答载荷。AskUserQuestion 每道题对应 answers 中一项,顺序与 pending_action.questions 一致。

请求 AnswerPayload

字段类型必填约束契约说明
answersarray<string>否—按 pending_action.questions 顺序提交,每道题对应一个字符串。有选项时原样提交 label,自由输入题提交文本。多选仍放在同一个字符串中,例如“春季, 夏季”,由 Agent 理解,不由接口解析为结构化多选;需要可靠执行的选择优先使用单选。

响应

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

响应202 QuestionResponseAck

字段类型必填约束契约说明
statusstring是固定为 accepted固定为 accepted,表示回答已交付;回合随后恢复。可查询会话状态确认其离开 action_required。
tool_call_idstring是—本次回答对应的 tool_call_id,回显供核对。

使用说明

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