feat: 新增方案 C 的 Handoff 路由宿主，并让抽城市支持自然语言。

把图 JSON 编译成 CreateHandoffBuilderWith + WithHandoff；Agent 固定 Id 以免交接工具名错位；DeepSeek 关闭 thinking，避免多轮丢掉 reasoning_content 导致 400。
2026-09-01 17:56:41 +08:00
parent 2c5c6fd118
commit b0e89b6092
25 changed files with 960 additions and 27 deletions
@@ -13,22 +13,39 @@ namespace MAF1.Agents.FileCity;
 /// </summary>
 public static class FileCityAgent
 {
+    public const string DefaultDescription = "从文件或用户描述中提取有效城市名。";
+
    /// <summary>创建带 ReadTextFile 工具的聊天 Agent。模型必须先读文件，不能凭文件名猜内容。</summary>
-    public static AIAgent Create(AgentFactory factory)
+    public static AIAgent Create(
+        AgentFactory factory,
+        string name = "FileCityAgent",
+        string? description = null,
+        string? extraInstructions = null)
    {
-        return factory.CreateAgent(
-            name: "FileCityAgent",
-            instructions:
+        string instructions =
            """
-            你负责读取用户指定的本地文件，并从中提取有效城市名。
-            必须先调用 ReadTextFile 读取文件，不要猜测文件内容。
+            你负责从用户材料里提取有效城市名。
+            用户可能给你两种输入，你必须自己判断：
+            1) 本地文件路径（如 Data/cities.txt、C:\\a.txt）→ 必须先调用 ReadTextFile 读文件，不要猜内容。
+            2) 自然语言描述或城市名单（如「帮我查成都和杭州的天气」「明天去上海」）→ 不要调用 ReadTextFile，直接从用户消息里提取城市。
+            不要把描述、问句、城市名当成文件路径去读。
            有效城市名：现实世界中真实存在的城市（如 成都、北京、Amsterdam）。
            忽略空行、注释、人名、水果、随意单词等不是城市的内容。
+            城市可能出现在句子、列表或表格里，都要提取。
            只输出一个 JSON 对象，不要 Markdown，不要其它说明：
            {"hasValidCities": true, "cities": ["成都"], "reason": "说明"}
            若没有有效城市：{"hasValidCities": false, "cities": [], "reason": "原因"}
-            cities 去重，保持文件中的出现顺序。
-            """,
+            cities 去重，保持出现顺序。
+            """;
+        if (!string.IsNullOrWhiteSpace(extraInstructions))
+        {
+            instructions = instructions + "\n" + extraInstructions;
+        }
+
+        return factory.CreateAgent(
+            name: name,
+            instructions: instructions,
+            description: string.IsNullOrWhiteSpace(description) ? DefaultDescription : description,
            tools: [AIFunctionFactory.Create(FileTools.ReadTextFile)]);
    }