1

docs/technical/LLM_MODEL_ROUTING_RPG_AND_CREATION_2026-04-30.md

@@ -39,6 +39,8 @@
 - protocol: `/responses`
 - web_search: 开启时映射为 `tools: [{ "type": "web_search", "max_keyword": 3 }]`
 
+联网搜索是模板创作的增强能力，不是 Agent 对话主链的硬依赖。若上游 Responses SSE 返回 `ToolNotOpen` 或“账号未开通 web search”类错误，`creation_agent_llm_turn` 必须使用同一 system/user prompt 自动降级为无联网搜索重试一次；只有重试仍失败时才向玩法层返回“生成失败”。这样 RPG Agent、大鱼 Agent、拼图 Agent 都能在未开通搜索插件的环境中继续完成基础 JSON turn。
+
 覆盖入口：
 
 1. `creation_agent_llm_turn.rs`
@@ -74,6 +76,7 @@ Responses 非流式解析优先读取 `output_text`，再兼容 `output[].conten
 1. RPG 运行时 LLM 请求在代码层显式带 `doubao-seed-character-251128`。
 2. 创作模板 LLM 请求在代码层显式带 `deepseek-v3-2-251201` 与 Responses 协议。
 3. `platform-llm` 单测覆盖 Responses 非流式、Responses SSE、Responses web_search tools 请求体。
-4. `cargo test -p platform-llm --manifest-path server-rs/Cargo.toml` 通过。
-5. `cargo test -p api-server creation_agent_llm_turn --manifest-path server-rs/Cargo.toml` 通过。
-6. 修改后按项目约束使用 `npm run api-server:maincloud` 重新启动后端，并执行相应自动测试。
+4. `api-server` 单测覆盖创作 Agent 对 `ToolNotOpen` / 未开通 web search 错误的识别，确保可触发无搜索重试。
+5. `cargo test -p platform-llm --manifest-path server-rs/Cargo.toml` 通过。
+6. `cargo test -p api-server creation_agent_llm_turn --manifest-path server-rs/Cargo.toml` 通过。
+7. 修改后按项目约束使用 `npm run api-server:maincloud` 重新启动后端，并执行相应自动测试。