From 7019d4c5a6e01841796fc2c1350f0677bde975c7 Mon Sep 17 00:00:00 2001
From: Wang Defa <1+wangdefa@noreply.gitea.bcde.io>
Date: Fri, 17 Jul 2026 12:19:21 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3:=E8=AE=B0=E5=BD=95=20multi-a?=
 =?UTF-8?q?gent=20=E5=8A=A0=E5=AF=86=E6=8E=A8=E7=90=86=E6=B5=81=E5=BC=8F?=
 =?UTF-8?q?=E6=96=AD=E6=B5=81=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/AI网关.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/AI网关.md b/docs/AI网关.md
index d12cac4..a1f135b 100644
--- a/docs/AI网关.md
+++ b/docs/AI网关.md
@@ -218,6 +218,17 @@ Responses 合成的最小事件序列为：`response.created` →
 
 </details>
 
+### `multi-agent` 加密推理内容流式断流
+
+> [!WARNING]
+> 当 `multi-agent` 请求同时启用 `stream: true` 与
+> `include: ["reasoning.encrypted_content"]` 时，上游可能在序列化大体量
+> `encrypted_content` 事件期间静默断开连接，且不返回 `error` 或终态事件。
+>
+> 已复现场景中的断点位于 `output_index: 8` 附近：第三次搜索结束后，上游准备
+> 发送较大的加密推理块时连接被中止。`multi-agent` 产生的加密推理内容体积较大，
+> 因而更容易暴露该上游流式序列化缺陷。
+
 ### ZDR 与文件输入
 
 Responses 的 `input_file` 内容块（`file_url` / `file_data`）实测会被上游拒绝：