保存用户回答
把用户对当前追问的回答(自由文本或点击快捷选项的内容)持久化到会话消息历史,用于推进下一轮问诊。图片消息与供回放的模型消息也走同一接口。
请求地址
POST
/v1/ms-ai-fast/session-records/messages
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body):文本回答
json
{
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"role": "user",
"content": "最近没有更换食物。",
"module_type": 1,
"content_type": 1,
"stage": 2
}请求体 (Body):图片消息
json
{
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"role": "user",
"content": "用户补充了一张图片",
"module_type": 1,
"content_type": 2,
"image": "<UPLOAD_RESPONSE_DATA_URL>"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | 会话唯一标识符。 |
role | string | 是 | 发言角色:user、assistant、system;其他值返回 400。 |
content | string | 是 | 消息文本;也接受 JSON 字符串。 |
module_type | integer | 否 | 1 智能问诊、5 图片识别;不传时按会话记录自动取值。 |
content_type | integer | 否 | 1 文本(默认)、2 图片、3 JSON。 |
stage | integer | 否 | 业务阶段序号;问诊回答通常传 2。 |
parent_session | string/null | 否 | 父会话 ID。 |
image | string/null | 否 | 图片消息的图片 URL;使用 /oss/images 返回的原样 url。 |
extra_json | object/null | 否 | 扩展信息。 |
is_hidden | integer | 否 | 是否隐藏,默认 0。 |
响应示例
json
{
"code": 200,
"message": "success",
"data": {
"id": 2,
"created_at": "2026-09-16T14:32:00+08:00",
"updated_at": "2026-09-16T14:32:00+08:00",
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"user_uuid": "usr_9182309182",
"module_type": 1,
"role": "user",
"content": "最近没有更换食物。",
"content_type": 1,
"stage": 2,
"parent_session": null,
"image": null,
"evaluation": null,
"extra_json": null,
"is_hidden": 0
}
}响应字段
| 参数名 | 类型 | 说明 |
|---|---|---|
id | integer | 消息主键 ID。 |
session_id | string | 所属会话 ID。 |
role | string | 发言角色:user、assistant、system。 |
content | string | 消息文本或 JSON 字符串。 |
content_type | integer | 1 文本、2 图片、3 JSON。 |
module_type | integer | 1 智能问诊、5 图片识别。 |
stage | integer/null | 业务阶段序号。 |
parent_session | string/null | 父会话 ID。 |
image | string/null | 图片消息的图片 URL。 |
extra_json | object/null | 扩展信息。 |
is_hidden | integer | 是否隐藏:0 否、1 是。 |
evaluation | object/null | 用户评价内容,未评价时为 null。 |
created_at / updated_at | datetime | 创建与更新时间(UTC+8,无时区偏移)。 |
user_uuid | string | 平台内部用户标识,不对外使用。 |
常见错误
HTTP / code | message | 触发条件 |
|---|---|---|
400 | role 仅支持 user/assistant/system | role 传了其他值。 |
404 | 会话不存在 | session_id 不存在或不属于当前调用方。 |
422 | Field required | 缺少 session_id、role 或 content。 |
说明
- 每轮回答只保存一次;客户端重试时不要重复提交。
- 保存成功后按流程调用判断是否继续追问或直接进入下一轮。