流式生成问诊小结
问诊问答环节结束后,由 AI 汇总全流程主诉、多轮症状问答及补充图片分析,流式输出高度凝练的阶段性问诊小结。
请求地址
POST
/v1/ms-ai-fast/ai-doc/summary
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。 |
Content-Type | string | 是 | 请求体格式,固定为 application/json。 |
Accept | string | 是 | 客户端接收类型,固定为 text/event-stream。 |
请求体 (Body)
json
{
"session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
"pet_profile_id": 44,
"lang": "zh-CN"
}| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
session_id | string | 是 | 会话唯一标识符。 |
pet_profile_id | integer | 否 | 宠物档案 ID;若传入必须与会话一致。 |
lang | string | 否 | 语言代码,默认 zh-CN。 |
响应头
http
Content-Type: text/event-stream; charset=utf-8
Cache-Control: no-cache
Transfer-Encoding: chunked响应不返回 Content-Length,必须按流式读取。帧格式、事件类型与代理缓冲说明见流式响应。
响应示例
text
data: {"type":"metadata","gateway_request_id":"gw_req_691823"}
data: {"type":"content","content":"患宠今日出现频繁呕吐伴轻度嗜睡,食欲减退。"}
data: {"type":"done","data":{"session_id":"session_6407c5cc22f84c5aae0aeba23e1f1428","data":{"content":"患宠今日出现频繁呕吐伴轻度嗜睡,食欲减退。结合病史,初步考虑急性胃肠炎可能,建议禁食水观察并生成完整健康报告。"},"raw_content":"模型原生输出","gateway_request_id":"gw_req_691823"}}下表路径相对于响应 data:data.xxx 表示内层 data 对象中的字段。
| 参数名 | 类型 | 说明 |
|---|---|---|
type | string | 事件类型:metadata(开始)、content(增量)、done(完成结束)、error(异常)。 |
data | object | done 事件核心数据对象。 |
session_id | string | 关联的当前会话 ID。 |
data.content | string | 问诊全流程小结最终完整文本。直接渲染在小结卡片或作为生成报告前的确认文案。 |
raw_content | string | 模型原生返回内容(供排查使用)。 |
gateway_request_id | string | 网关请求标识。 |
事件格式
| 事件类型 | 说明 | data: 原文 |
|---|---|---|
metadata | 流开始事件,每个流只出现一次 | {"type":"metadata","gateway_request_id":"<REQUEST_ID>"} |
content | 数据流事件,可多次出现;只用于逐段展示,不能用它判断是否结束 | {"type":"content","content":"中间小结文本"} |
done | 流结束事件;只有收到它才算成功 | {"type":"done","data":{"session_id":"<SESSION_ID>","data":{"content":"完整问诊小结"},"raw_content":"模型原始输出","gateway_request_id":"<REQUEST_ID>"}} |
error | 错误事件;仅在 retryable 为 true 时可有限重试 | {"type":"error","code":"AI_DOC_SUMMARY_STREAM_FAILED","error_code":5401,"message":"流式生成问诊总结失败","retryable":true,"recommended_action":"retry_later"} |
done 事件中的 content 等于全部 content 事件内容的拼接;小结流没有以 done 结束时,不要提交报告任务。