查看 Markdown
GET/api/humanQuestions/pending

查询待回答问题

根据助手消息ID查询当前登录用户仍待回答的问题批次,用于页面刷新后恢复交互

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数1 个字段

messageIdintegerrequired

承载问题的助手消息ID

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
POST/api/humanQuestions/resolve

提交问题回答

为一个问题批次提交全部回答并恢复智能体运行,用户身份从当前登录会话自动注入

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

请求体(JSON)2 个字段

batchIdstringrequired

问题批次唯一标识

与原问题等长且同序的回答列表。status 可选值:ANSWERED、SKIPPED;ANSWERED 时,单选问题的 selectedOptionIds 为 0 或 1 项,且与 customText 必须且只能有一个有效值;多选问题的 selectedOptionIds 为 0 到选项总数,且与 customText 至少有一个有效值、允许同时存在;SKIPPED 时两者都为空

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

dataobjectnullable

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
POST/api/humanQuestions/cancel

取消问题批次

取消一个问题批次并终止整个智能体运行,不会向模型提交空答案

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

请求体(JSON)1 个字段

batchIdstringrequired

问题批次唯一标识

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

dataobjectnullable

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理