union-app-chat-stream 1.0.6 → 1.0.7

package/app/utils/function_utils.py

@@ -14,6 +14,7 @@ import yaml
 
 PROJECT_ROOT = Path(__file__).resolve().parents[2]
 DEFAULT_TOOL_DEFINITIONS_PATH = PROJECT_ROOT / "tools" / "tool_definitions.yaml"
+FIELD_DICTIONARY_PATH = PROJECT_ROOT / "tools" / "field_dictionary.yaml"
 
 
 @dataclass
@@ -47,6 +48,44 @@ def _load_yaml(path: Path) -> Dict[str, Any]:
     return data if isinstance(data, dict) else {}
 
 
+def _normalize_field_name(name: str) -> str:
+    return re.sub(r"[\s_-]+", "", str(name)).lower()
+
+
+@lru_cache(maxsize=1)
+def _field_dictionary_index() -> Dict[str, Any]:
+    if not FIELD_DICTIONARY_PATH.exists():
+        return {"fallback_description": "", "exact": {}, "normalized": {}, "relations": []}
+
+    config = _load_yaml(FIELD_DICTIONARY_PATH)
+    if not isinstance(config, dict):
+        config = {}
+
+    exact: Dict[str, Dict[str, Any]] = {}
+    normalized: Dict[str, Dict[str, Any]] = {}
+    fields = config.get("fields") if isinstance(config.get("fields"), dict) else {}
+    for canonical, raw_info in fields.items():
+        if not isinstance(raw_info, dict):
+            continue
+        info = {key: value for key, value in raw_info.items() if key not in {"aliases", "patterns"}}
+        info["canonical"] = canonical
+        exact[canonical] = info
+        normalized[_normalize_field_name(canonical)] = info
+        aliases = raw_info.get("aliases") if isinstance(raw_info.get("aliases"), list) else []
+        for alias in aliases:
+            alias = str(alias)
+            exact[alias] = info
+            normalized[_normalize_field_name(alias)] = info
+
+    relations = config.get("relations") if isinstance(config.get("relations"), list) else []
+    return {
+        "fallback_description": str(config.get("fallback_description") or ""),
+        "exact": exact,
+        "normalized": normalized,
+        "relations": relations,
+    }
+
+
 @lru_cache(maxsize=1)
 def _tool_definition_config() -> Dict[str, Any]:
     path = Path(os.environ.get("TOOL_DEFINITIONS_PATH", DEFAULT_TOOL_DEFINITIONS_PATH))
@@ -55,6 +94,7 @@ def _tool_definition_config() -> Dict[str, Any]:
 
 def reload_tool_configs():
     _tool_definition_config.cache_clear()
+    _field_dictionary_index.cache_clear()
 
 
 def _raw_tool_definitions() -> List[Dict[str, Any]]:
@@ -178,6 +218,56 @@ def _render_value(value: Any, args: Dict[str, Any], *, allow_missing: bool = Fal
     return value
 
 
+def _collect_data_fields(data: Any, sample_size: int = 5) -> List[str]:
+    if not isinstance(data, list):
+        return []
+    fields: List[str] = []
+    seen = set()
+    for item in data[:sample_size]:
+        if not isinstance(item, dict):
+            continue
+        for key in item:
+            key = str(key)
+            if key not in seen:
+                seen.add(key)
+                fields.append(key)
+    return fields
+
+
+def _build_field_context(data: Any) -> Dict[str, Any]:
+    fields = _collect_data_fields(data)
+    if not fields:
+        return {}
+
+    index = _field_dictionary_index()
+    fallback = index["fallback_description"]
+    descriptions: Dict[str, Dict[str, Any]] = {}
+    canonical_fields = set()
+    for field in fields:
+        info = index["exact"].get(field) or index["normalized"].get(_normalize_field_name(field))
+        if info:
+            descriptions[field] = dict(info)
+            canonical_fields.add(str(info["canonical"]))
+        elif fallback:
+            descriptions[field] = {"description": fallback}
+
+    relations = []
+    for relation in index["relations"]:
+        if not isinstance(relation, dict):
+            continue
+        when_all = relation.get("when_all")
+        description = relation.get("description")
+        if isinstance(when_all, list) and description and all(str(field) in canonical_fields for field in when_all):
+            relations.append(str(description))
+
+    context: Dict[str, Any] = {}
+    if descriptions:
+        context["field_descriptions"] = descriptions
+    if relations:
+        context["field_relations"] = relations
+    return context
+
+
 def _base_result(spec: Dict[str, Any], args: Dict[str, Any]) -> Dict[str, Any]:
     result = {
         "tool_name": spec["name"],
@@ -242,6 +332,7 @@ def _run_backend_tool(
     })
     if path:
         result["backend"]["path"] = path
+    result.update(_build_field_context(data))
     return result
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "union-app-chat-stream",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Union operations chat stream Flask application package.",
   "license": "UNLICENSED",
   "files": [

package/tools/field_dictionary.yaml

@@ -0,0 +1,28 @@
+fallback_description: 字段未命中全局字段字典。请结合字段名、字段值和上下文谨慎理解，不要编造枚举含义。
+fields:
+  sysSuccessPercent:
+    meaning: 系统成功率，表示成功交易占总交易的比例，通常越高越好。
+    aliases:
+      - sysSuccessPercent
+      - avgSuccessPercent
+      - avg_success_percent
+      - successPer
+  failRate:
+    meaning: 失败率，通常表示失败交易笔数占总交易笔数的比例。
+    aliases:
+      - failRate
+      - fail_rate
+  faultLevel:
+    meaning: 故障等级，表示故障严重程度。
+    enum:
+      P1: 重大故障
+      P2: 较大故障
+      P3: 一般故障
+    aliases:
+      - faultLevel
+      - fault_level
+relations:
+  - when_all:
+      - sysSuccessPercent
+      - failRate
+    description: 系统成功率和失败率通常反向相关。成功率下降时，应同时检查失败率是否上升。