1

docs/technical/API_SERVER_PLATFORM_LLM_PROXY_DESIGN_2026-04-21.md

@@ -120,3 +120,23 @@ Rust 首版返回：
 1. `platform-llm` 单测能捕获开启搜索时上游 JSON 包含 `web_search_options`。
 2. `api-server` 配置单测能验证角色扮演搜索开关默认开启、环境变量可关闭。
 3. 角色扮演剧情、NPC 对话、推理战斗文本请求都通过同一辅助函数设置搜索开关，避免漏接。
+
+## 9. AgentSession 创作问答联网搜索补充（2026-04-26）
+
+### 9.1 目标
+
+AgentSession 页面中的 RPG 世界共创、拼图共创、大鱼吃小鱼共创都属于创作问答链路。用户在这些页面里会要求模型补充现实题材、历史文化、地理器物、玩法参照与美术风格依据，因此创作 Agent 的文本问答默认开启上游联网搜索能力。
+
+### 9.2 落地范围
+
+1. `api-server` 配置增加 `GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED` / `CREATION_AGENT_LLM_WEB_SEARCH_ENABLED`，默认 `true`。
+2. `creation_agent_llm_turn` 作为三类 Agent 共用 LLM 骨架，必须接收显式 `enable_web_search` 参数，并在 `LlmTextRequest` 上设置该值。
+3. RPG 世界共创、拼图共创、大鱼吃小鱼共创的普通消息接口与 SSE 流式消息接口都传入同一配置值，避免只有某一种入口开启。
+4. RPG 世界共创里的动态状态推断属于对当前聊天状态的结构化判断，不需要联网搜索，继续保持默认关闭。
+5. `/api/llm/chat/completions` 通用代理继续不默认开启联网搜索。
+
+### 9.3 验收
+
+1. `api-server` 配置单测覆盖创作 Agent 联网搜索开关默认开启、环境变量可关闭。
+2. 创作 Agent 的共用 LLM 单测覆盖开启搜索时 `LlmTextRequest.enable_web_search` 为 `true`。
+3. 三类 Agent turn request 均包含 `enable_web_search` 字段，调用点全部来自 `state.config.creation_agent_llm_web_search_enabled`。