Skip to content

流式生成推理说明 ​

流式输出当前轮问诊的思考推导过程与推理说明文本。前端可通过 SSE 实时接收中间思考过程,提升问诊过程的交互实时性。

请求地址 ​

POST
/v1/ms-ai-fast/ai-doc/reason-info

请求参数 ​

请求头 ​

请求头类型必填说明
Authorizationstring是访问凭证,采用 Bearer Token 规范,格式为 Bearer <ACCESS_TOKEN>。
Content-Typestring是请求体格式,固定为 application/json。
Acceptstring是客户端接收类型,固定为 text/event-stream。

请求体 (Body) ​

json
{
  "session_id": "session_6407c5cc22f84c5aae0aeba23e1f1428",
  "pet_profile_id": 44,
  "lang": "zh-CN"
}
参数名类型必填说明
session_idstring是会话唯一标识符。
pet_profile_idinteger否宠物档案 ID;若传入必须与会话一致。
langstring否语言代码,默认 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 对象中的字段。

参数名类型说明
typestring事件类型:metadata(开始)、content(增量)、done(完成结束)、error(异常)。
contentstringcontent 事件中的增量文本片段。
dataobjectdone 事件核心结果体。
session_idstring关联的当前会话 ID。
data.contentstring完整推理思考说明文本。拼接全部增量片段后的完整内容。
raw_contentstring模型原生返回内容。
gateway_request_idstring网关请求标识。

事件格式 ​

事件类型说明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 取值见错误处理。

最近更新

栖界开放平台 · API Documentation