创建问诊会话
创建新的智能问诊会话,保存初始主诉,并生成唯一的会话标识(session_id),作为后续所有多轮问答、推理解析、小结与报告接口的上下文凭证。
请求地址
POST
/v1/ms-ai-fast/session-records/sessions
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
请求体 (Body)
json
{
"module_type": 1,
"pet_profile_id": 44,
"content": "我的猫今天呕吐了三次,精神状态一般。",
"lang": "zh-CN",
"trace_id": "consult-20260914-0001"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
module_type | integer | 是 | 业务模块编号:1 智能问诊,5 宠物图片识别。本接口固定传 1。 |
pet_profile_id | integer | 是 | 宠物档案 ID(数字),必须大于 0。 |
content | string | 是 | 初始主诉或首条用户病情描述文本,不能传空字符串。 |
lang | string | 否 | 会话语言代码,默认值为 zh-CN。当前支持 zh-CN 与 en-US。 |
trace_id | string | 否 | 调用方自定义全链路追踪标识,用于排查请求链路,最长 100 字符。 |
响应示例
json
{
"code": 200,
"message": "success",
"data": {
"session_id": "doc_6407c5cc22f84c5aae0aeba23e1f1428",
"medical_record_id": 10001,
"medical_record": {
"id": 10001,
"pet_profile_id": 44,
"module_type": 1,
"status": 1,
"lang": "zh-CN",
"created_at": "2026-09-14T10:00:00"
},
"initial_message": {
"id": 1,
"role": "user",
"content": "我的猫今天呕吐了三次,精神状态一般。",
"content_type": 1,
"created_at": "2026-09-14T10:00:00"
}
}
}| 参数名 | 类型 | 说明 |
|---|---|---|
code | integer | 业务状态码,200 表示处理成功。 |
message | string | 状态提示信息:成功固定为 "success"(网关统一归一化),失败时为安全的中文提示。不要用它做程序判断。 |
data | object | 返回数据主体包装对象。 |
session_id | string | 核心会话标识。后续发起多轮问答、提取关键词、生成推理解析、生成小结与报告时必须传入该值。 |
medical_record_id | integer | 关联的 AI 主病历记录 ID。 |
medical_record | object | 生成的 AI 主病历记录详情。 |
medical_record.id | integer | 病历记录 ID,与 medical_record_id 一致。 |
medical_record.pet_profile_id | integer | 关联的宠物档案 ID。 |
medical_record.module_type | integer | 业务模块:1 智能问诊。 |
medical_record.status | integer | 业务状态:实测会话刚创建时为 1,报告完成后为 2;判断报告是否完成请用 report_status。 |
medical_record.lang | string | 会话语言(如 zh-CN)。 |
medical_record.created_at | string | 病历创建时间(ISO 8601 格式)。 |
initial_message | object | 系统保存的首条主诉消息对象。 |
initial_message.id | integer | 首条消息自增 ID。 |
initial_message.role | string | 发言者角色:固定为 "user"(用户)。 |
initial_message.content | string | 主诉文本内容(与请求入参 content 一致)。 |
initial_message.content_type | integer | 消息类型:1 文本,2 图片,3 JSON。此处固定为 1。 |
initial_message.created_at | string | 消息写入时间(ISO 8601 格式)。 |