refactor: unify system tools as resources

backend/services/system_tools.py

@@ -6,25 +6,56 @@ from collections.abc import Iterable, Mapping
 from typing import Any
 
 
-SYSTEM_TOOL_KINDS = frozenset(
-    {
-        "end_conversation",
-        "update_state",
-        "skip_turn",
-        "request_human_handoff",
-    }
-)
+SYSTEM_TOOL_SPECS: dict[str, dict[str, str]] = {
+    "end_conversation": {
+        "id": "tool_end_call_default",
+        "name": "结束对话",
+        "function_name": "end_conversation",
+        "description": (
+            "礼貌地结束本次对话。当用户明确告别、表示任务已完成"
+            "或要求挂断时调用。"
+        ),
+    },
+    "update_state": {
+        "id": "tool_update_state_default",
+        "name": "更新状态",
+        "function_name": "update_state",
+        "description": (
+            "静默更新本次对话中已经声明并明确授权的动态变量。"
+            "只提交本轮获得或确认的信息，更新后继续当前回答。"
+        ),
+    },
+    "skip_turn": {
+        "id": "tool_skip_turn_default",
+        "name": "跳过本轮",
+        "function_name": "skip_turn",
+        "description": (
+            "跳过当前轮次，不生成任何语音回复。"
+            "仅当用户明确要求稍等、话还没说完，或输入可确认只是噪音时调用。"
+        ),
+    },
+    "request_human_handoff": {
+        "id": "tool_request_human_handoff_default",
+        "name": "转接人工",
+        "function_name": "request_human_handoff",
+        "description": (
+            "提交人工接管请求。当用户明确要求人工服务、投诉升级或 AI 无法"
+            "解决时调用。该工具只提交请求，不代表人工已经接通；调用后继续"
+            "回复用户并说明正在等待人工响应。"
+        ),
+    },
+}
+
+SYSTEM_TOOL_KINDS = frozenset(SYSTEM_TOOL_SPECS)
 
 
-def normalize_system_tools(values: Iterable[Any] | None) -> tuple[str, ...]:
-    """Return known tool names once each while preserving editor order."""
-    return tuple(
-        dict.fromkeys(
-            str(value)
-            for value in values or ()
-            if str(value) in SYSTEM_TOOL_KINDS
-        )
-    )
+def system_tool_kind(definition: Mapping[str, Any] | None) -> str | None:
+    """Return the supported platform behavior declared by a System resource."""
+    config = (definition or {}).get("config")
+    if not isinstance(config, Mapping):
+        return None
+    kind = str(config.get("kind") or "")
+    return kind if kind in SYSTEM_TOOL_KINDS else None
 
 
 def state_update_properties(