流式生成推理说明
流式输出当前轮问诊的思考推导过程与推理说明文本。前端可通过 SSE 实时接收中间思考过程,提升问诊过程的交互实时性。
请求地址
POST
/v1/ms-ai-fast/ai-doc/reason-info
请求参数
请求头
| 请求头 | 类型 | 必填 | 说明 |
|---|---|---|---|
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_182390"}
data: {"type":"content","content":"正在分析患宠呕吐物特征及可能诱因..."}
data: {"type":"done","data":{"session_id":"session_6407c5cc22f84c5aae0aeba23e1f1428","data":{"content":"患宠出现急性呕吐伴精神不振,需进一步排查饮食不耐受或异物阻塞风险。"},"raw_content":"模型原始输出","gateway_request_id":"gw_req_182390"}}下表路径相对于响应 data:data.xxx 表示内层 data 对象中的字段。
| 参数名 | 类型 | 说明 |
|---|---|---|
type | string | 事件类型:metadata(开始)、content(增量)、done(完成结束)、error(异常)。 |
content | string | content 事件中的增量文本片段。 |
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_REASON_STREAM_FAILED","error_code":5401,"message":"流式生成问诊推理说明失败","retryable":true,"recommended_action":"retry_later"} |
done 事件中的 content 等于全部 content 事件内容的拼接;raw_content 仅供排查使用;error_code 取值见错误处理。