feat: 增强 Agent 系统和完善项目结构

主要改进:
- Agent 增强: 订单查询、售后支持、客服路由等功能优化
- 新增语言检测和 Token 管理模块
- 改进 Chatwoot webhook 处理和用户标识
- MCP 服务器增强: 订单 MCP 和 Strapi MCP 功能扩展
- 新增商城客户端、知识库、缓存和同步模块
- 添加多语言提示词系统 (YAML)
- 完善项目结构: 整理文档、脚本和测试文件
- 新增调试和测试工具脚本

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

agent/agents/order.py

@@ -21,62 +21,100 @@ ORDER_AGENT_PROMPT = """你是一个专业的 B2B 订单服务助手。
 
 ## 可用工具
 
-1. **query_order** - 查询订单
+1. **get_mall_order** - 从商城 API 查询订单（推荐使用）
+   - order_id: 订单号（必需）
+   - 说明：此工具会自动使用用户的身份 token 查询商城订单详情
+
+2. **query_order** - 查询历史订单
+   - user_id: 用户 ID（自动注入）
+   - account_id: 账户 ID（自动注入）
    - order_id: 订单号（可选，不填则查询最近订单）
    - date_start: 开始日期（可选）
    - date_end: 结束日期（可选）
    - status: 订单状态（可选）
 
-2. **track_logistics** - 物流跟踪
+3. **track_logistics** - 物流跟踪
    - order_id: 订单号
    - tracking_number: 物流单号（可选）
 
-3. **modify_order** - 修改订单
+4. **modify_order** - 修改订单
    - order_id: 订单号
+   - user_id: 用户 ID（自动注入）
    - modifications: 修改内容（address/items/quantity 等）
 
-4. **cancel_order** - 取消订单
+5. **cancel_order** - 取消订单
    - order_id: 订单号
+   - user_id: 用户 ID（自动注入）
    - reason: 取消原因
 
-5. **get_invoice** - 获取发票
+6. **get_invoice** - 获取发票
    - order_id: 订单号
    - invoice_type: 发票类型（normal/vat）
 
-## 工具调用格式
+## 回复格式要求
 
-当需要使用工具时，请返回 JSON 格式：
+**重要**：你必须始终返回完整的 JSON 对象，不要包含任何其他文本或解释。
+
+### 格式 1：调用工具
+当需要使用工具查询信息时，返回：
 ```json
 {
   "action": "call_tool",
-  "tool_name": "工具名称",
+  "tool_name": "get_mall_order",
   "arguments": {
-    "参数名": "参数值"
+    "order_id": "202071324"
   }
 }
 ```
 
-当需要向用户询问更多信息时：
+### 格式 2：询问信息
+当需要向用户询问更多信息时，返回：
 ```json
 {
   "action": "ask_info",
-  "question": "需要询问的问题"
+  "question": "请提供您的订单号"
 }
 ```
 
-当可以直接回答时：
+### 格式 3：直接回复
+当可以直接回答时，返回：
 ```json
 {
   "action": "respond",
-  "response": "回复内容"
+  "response": "您的订单已发货，预计3天内到达"
 }
 ```
 
-## 重要提示
-- 订单修改和取消是敏感操作，需要确认订单号
-- 如果用户没有提供订单号，先查询他的最近订单
-- 物流查询需要订单号或物流单号
-- 对于批量操作或大金额订单，建议转人工处理
+## 示例对话
+
+用户: "查询订单 202071324"
+回复:
+```json
+{
+  "action": "call_tool",
+  "tool_name": "get_mall_order",
+  "arguments": {
+    "order_id": "202071324"
+  }
+}
+```
+
+用户: "我的订单发货了吗？"
+回复:
+```json
+{
+  "action": "ask_info",
+  "question": "请提供您的订单号，以便查询订单状态"
+}
+```
+
+## 重要约束
+- **必须返回完整的 JSON 对象**，不要只返回部分内容
+- **不要添加任何 markdown 代码块标记**（如 \`\`\`json）
+- **不要添加任何解释性文字**，只返回 JSON
+- user_id 和 account_id 会自动注入到 arguments 中，无需手动添加
+- 如果用户提供了订单号，优先使用 get_mall_order 工具
+- 对于敏感操作（取消、修改），确保有明确的订单号
 """
 
 
@@ -131,27 +169,133 @@ async def order_agent(state: AgentState) -> AgentState:
     try:
         llm = get_llm_client()
         response = await llm.chat(messages, temperature=0.5)
-        
+
         # Parse response
         content = response.content.strip()
-        if content.startswith("```"):
-            content = content.split("```")[1]
-            if content.startswith("json"):
-                content = content[4:]
-        
-        result = json.loads(content)
+        logger.info(
+            "LLM response received",
+            conversation_id=state["conversation_id"],
+            response_length=len(content),
+            response_preview=content[:300]
+        )
+
+        # 检查是否是简化的工具调用格式：工具名称\n{参数}
+        # 例如：get_mall_order\n{"order_id": "202071324"}
+        if "\n" in content and "{" in content:
+            lines = content.split("\n")
+            if len(lines) >= 2:
+                tool_name_line = lines[0].strip()
+                json_line = "\n".join(lines[1:]).strip()
+
+                # 如果第一行看起来像工具名称（不包含 {），且第二行是 JSON
+                if "{" not in tool_name_line and "{" in json_line:
+                    logger.info(
+                        "Detected simplified tool call format",
+                        tool_name=tool_name_line,
+                        json_preview=json_line[:200]
+                    )
+
+                    try:
+                        arguments = json.loads(json_line)
+                        # 直接构建工具调用
+                        arguments["user_id"] = state["user_id"]
+                        arguments["account_id"] = state["account_id"]
+
+                        # Inject user_token if available
+                        if state.get("user_token"):
+                            arguments["user_token"] = state["user_token"]
+                            logger.info("Injected user_token into tool call")
+
+                        # Use entity if available
+                        if "order_id" not in arguments and state["entities"].get("order_id"):
+                            arguments["order_id"] = state["entities"]["order_id"]
+
+                        state = add_tool_call(
+                            state,
+                            tool_name=tool_name_line,
+                            arguments=arguments,
+                            server="order"
+                        )
+                        state["state"] = ConversationState.TOOL_CALLING.value
+
+                        logger.info(
+                            "Tool call added from simplified format",
+                            tool_name=tool_name_line,
+                            arguments_keys=list(arguments.keys())
+                        )
+
+                        return state
+                    except json.JSONDecodeError as e:
+                        logger.warning(
+                            "Failed to parse simplified format",
+                            error=str(e),
+                            json_line=json_line[:200]
+                        )
+
+        # 清理内容，去除可能的 markdown 代码块标记
+        # 例如：```json\n{...}\n``` 或 ```\n{...}\n```
+        if "```" in content:
+            # 找到第一个 ``` 后的内容
+            parts = content.split("```")
+            if len(parts) >= 2:
+                content = parts[1].strip()
+                # 去掉可能的 "json" 标记
+                if content.startswith("json"):
+                    content = content[4:].strip()
+                # 去掉结尾的 ``` 标记
+                if content.endswith("```"):
+                    content = content[:-3].strip()
+
+        # 尝试提取 JSON 对象（处理周围可能有文本的情况）
+        json_start = content.find("{")
+        json_end = content.rfind("}")
+        if json_start != -1 and json_end != -1 and json_end > json_start:
+            content = content[json_start:json_end + 1]
+
+        logger.info(
+            "Cleaned content for JSON parsing",
+            conversation_id=state["conversation_id"],
+            content_length=len(content),
+            content_preview=content[:500]
+        )
+
+        try:
+            result = json.loads(content)
+        except json.JSONDecodeError as e:
+            logger.error(
+                "Failed to parse LLM response as JSON",
+                conversation_id=state["conversation_id"],
+                error=str(e),
+                content_preview=content[:500]
+            )
+            # 如果解析失败，尝试将原始内容作为直接回复
+            state = set_response(state, response.content)
+            return state
+
         action = result.get("action")
-        
+
+        logger.info(
+            "LLM action parsed",
+            conversation_id=state["conversation_id"],
+            action=action,
+            tool_name=result.get("tool_name")
+        )
+
         if action == "call_tool":
             # Inject user context into arguments
             arguments = result.get("arguments", {})
             arguments["user_id"] = state["user_id"]
             arguments["account_id"] = state["account_id"]
-            
+
+            # Inject user_token if available (for Mall API calls)
+            if state.get("user_token"):
+                arguments["user_token"] = state["user_token"]
+                logger.debug("Injected user_token into tool call")
+
             # Use entity if available
             if "order_id" not in arguments and state["entities"].get("order_id"):
                 arguments["order_id"] = state["entities"]["order_id"]
-            
+
             state = add_tool_call(
                 state,
                 tool_name=result["tool_name"],
@@ -159,6 +303,12 @@ async def order_agent(state: AgentState) -> AgentState:
                 server="order"
             )
             state["state"] = ConversationState.TOOL_CALLING.value
+
+            logger.info(
+                "Tool call added",
+                tool_name=result["tool_name"],
+                arguments_keys=list(arguments.keys())
+            )
             
         elif action == "ask_info":
             state = set_response(state, result["question"])
@@ -171,13 +321,9 @@ async def order_agent(state: AgentState) -> AgentState:
         elif action == "handoff":
             state["requires_human"] = True
             state["handoff_reason"] = result.get("reason", "Complex order operation")
-            
+
         return state
-        
-    except json.JSONDecodeError:
-        state = set_response(state, response.content)
-        return state
-        
+
     except Exception as e:
         logger.error("Order agent failed", error=str(e))
         state["error"] = str(e)