BossAgents 规则模板管理系统架构文档

版本: 1.0 | 更新日期: 2026-05-31

1. 系统架构概览

1.1 核心理念

BossAgents 采用 "规则驱动 + LLM增强" 的架构思想：

• 规则是确定性逻辑，负责快速判断和标准操作
• 模板定义数据结构，确保输出格式一致
• 提示词是LLM交互协议，让AI理解业务上下文
• 三者共同驱动基础数字员工能力，再由业务数字员工组合调用

1.2 整体架构图

``

┌─────────────────────────────────────────────────────────────────────────┐

│ 业务数字员工层 (Digital Staff) │

│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │

│ │ DS-ECR-001 │ │ DS-VEN-001 │ │ DS-COST-001 │ │ DS-SYS-001 │ │

│ │ ECR审核员 │ │ 供应商管家 │ │ 成本优化师 │ │ 系统运维师 │ │

│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │

├─────────┼────────────────┼────────────────┼──────────────────────────────┤

│ ▼ ▼ ▼ │

│ ┌──────────────────────────────────────────────────────────────────┐ │

│ │ 基础数字员工能力层 (Capabilities) │ │

│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │

│ │ │ Identify │ │ Create │ │ Repair │ │ Optimize │ │ │

│ │ │ 识别能力 │ │ 创建能力 │ │ 修复能力 │ │ 优化能力 │ │ │

│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │

│ │ ┌──────────┐ ┌──────────┐ │ │

│ │ │ Compare │ │ Generate │ ← 统一通过 Rule Engine 执行 │ │

│ │ │ 比对能力 │ │ 生成能力 │ │ │

│ │ └──────────┘ └──────────┘ │ │

│ └──────────────────────────────────────────────────────────────────┘ │

├──────────────────────────────────────────────────────────────────────────┤

│ ┌──────────────────────────────────────────────────────────────────┐ │

│ │ 配置层 ── sciot_import.db (统一配置库) │ │

│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │

│ │ │ sciot_rules_v2 │ │ sciot_templates│ │ prompt_templates│ │ │

│ │ │ 统一规则引擎 │ │ 对象模板库 │ │ 提示词模板库 │ │ │

│ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │

│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │

│ │ │ sciot_properties│ │sciot_sequences│ │sciot_relationships│ │ │

│ │ │ 对象属性定义 │ │ 编号序列 │ │ 关系类型定义 │ │ │

│ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │

│ └──────────────────────────────────────────────────────────────────┘ │

├──────────────────────────────────────────────────────────────────────────┤

│ 数据源层 │

│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │

│ │ PLM/AML XML │ │ SCSAI 实时API │ │ 手动创建 │ │

│ │ 导入解析 │ │ 在线同步 │ │ UI维护 │ │

│ └────────────────┘ └────────────────┘ └────────────────┘ │

└──────────────────────────────────────────────────────────────────────────┘

`

2. 数据流图

2.1 对象创建完整流程

`

用户描述 "创建项目X"

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 1. 获取Schema │

│ GET /api/aml/unified/schema/Project │

│ 返回: { llmFields: [...], autoFields: [...], properties: [...] } │

└─────────────────────────────────────────────────────────────────────────┘

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 2. 获取模板 │

│ GET /api/sciot/type-template/Project │

│ 返回: { properties, relationships, list_values, lifecycle, ... } │

└─────────────────────────────────────────────────────────────────────────┘

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 3. 获取/构建提示词 │

│ GET /api/aml/sciot/prompts → 优先使用预生成的提示词 │

│ 或 POST /api/rule-engine/pregenerate-prompt → 动态生成 │

└─────────────────────────────────────────────────────────────────────────┘

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 4. 调用LLM生成JSON │

│ POST /api/llm/chat │

│ 输入: 提示词 + 用户描述 │

│ 输出: { item_type, properties, relationships, ... } │

└─────────────────────────────────────────────────────────────────────────┘

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 5. 规则引擎处理 │

│ POST /api/rule-engine/create-item │

│ 流程: validate → create_pre → 组装AML → create_post │

└─────────────────────────────────────────────────────────────────────────┘

│

▼

┌─────────────────────────────────────────────────────────────────────────┐

│ 6. 提交SCSAI │

│ POST /SCSAI-api/ApplyItem │

│ 输入: AML XML │

│ 输出: { Item: { id: "..." } } │

└─────────────────────────────────────────────────────────────────────────┘

`

2.2 规则引擎执行流程

`

execute(scope, context, options)

│

├── 1. getRules({ scope, item_type, is_active: true })

│ └── 从 sciot_rules_v2 表查询规则

│

├── 2. 按 priority 排序（P0 → P1 → P2 → P3）

│

├── 3. 逐条执行

│ ├── _evaluateCondition(rule, context) → match?

│ │ └── 检查 condition.field + condition.operator

│ │

│ └── if (match) _executeAction(rule, context)

│ ├── block → 返回 { blocked: true }

│ ├── warn → 记录警告

│ ├── suggest → 可能调用LLM

│ └── auto_fix → 修改context数据

│

├── 4. 记录历史 _recordHistory()

│

└── 5. 冲突解决

├── first_match → break（只执行第一条匹配）

├── merge → continue（执行所有匹配）

└── stop → break（有命中就停止）

`

3. 核心数据表

3.1 sciot_rules_v2（统一规则表）

| 字段 | 类型 | 说明 |

|------|------|------|

| id | TEXT | 规则ID（主键） |

| name | TEXT | 规则名称 |

| scope | TEXT | 作用域：identify/validate/create_pre/create_post/repair/optimize/compare |

| item_type_name | TEXT | 适用对象类型（null=通用） |

| severity | TEXT | 严重级别：error/warning/info/hint |

| priority | INTEGER | 优先级：0=P0(阻塞), 1=P1(高), 2=P2(中), 3=P3(低) |

| condition | TEXT | 条件JSON：{ field, operator, value } |

| action_type | TEXT | 动作类型：block/warn/suggest/auto_fix |

| action_script | TEXT | 动作脚本（JS代码） |

| conflict_strategy | TEXT | 冲突策略：first_match/merge/stop |

| is_active | INTEGER | 是否启用 |

| is_builtin | INTEGER | 是否内置规则 |

scope 说明：

| scope | 用途 | 执行时机 |

|-------|------|----------|

| validate | 校验规则 | 创建前校验，失败则阻止创建 |

| create_pre | 创建前预处理 | 校验通过后，填充默认值、生成编号 |

| create_post | 创建后处理 | SCSAI提交成功后，创建关联对象、发送通知 |

| repair | 修复规则 | 修复能力调用 |

| optimize | 优化规则 | 优化能力调用 |

3.2 sciot_templates（对象模板表）

| 字段 | 类型 | 说明 |

|------|------|------|

| item_type_name | TEXT | 对象类型名称 |

| llm_fields | TEXT | LLM可生成字段（JSON数组） |

| auto_fields | TEXT | 系统自动填充字段（JSON数组） |

| generation_rules | TEXT | 子对象生成规则（JSON） |

| aml_template | TEXT | AML模板XML |

字段分类用途：

• llm_fields: 出现在提示词中，让LLM生成值
• auto_fields: 不出现在提示词中，由系统自动处理（编号、创建时间等）

3.3 sciot_properties（对象属性定义表）

| 字段 | 类型 | 说明 |

|------|------|------|

| item_type_name | TEXT | 所属对象类型 |

| name | TEXT | 属性名 |

| data_type | TEXT | 数据类型：string/integer/date/list/item/foreign/sequence |

| is_required | INTEGER | 是否必填 |

| is_hidden | INTEGER | 是否隐藏（UI不显示） |

| readonly | INTEGER | 是否只读 |

| default_value | TEXT | 默认值 |

| data_source | TEXT | list类型的数据源 |

data_type 关键类型：

• list: 枚举类型，可选值从 sciot_list_values 获取
• item: 引用类型，指向另一个Item（如 wbs_id → WBS Element）
• foreign: 外键类型
• sequence: 自动编号类型

3.4 prompt_templates（提示词模板表）

3.5 sciot_sequences（编号序列表）

| 字段 | 类型 | 说明 |

|------|------|------|

| name | TEXT | 序列名称（通常是对象类型名 + " Number"） |

| prefix | TEXT | 编号前缀 |

| current_value | INTEGER | 当前值 |

| pad_to | INTEGER | 补零位数 |

编号生成：prefix + String(current_value + 1).padStart(pad_to, '0')

4. 核心API

4.1 规则引擎API

4.2 SCIOT数据API

5. 故障排查指南

5.1 问题定位流程

`

问题发生

│

├── 1. 浏览器控制台 → 前端错误、API调用失败

│

├── 2. 服务端日志 → server-log.txt

│

├── 3. 检查数据库 → sqlite3 sciot_import.db

│

└── 4. 规则执行历史 → GET /api/rule-engine/history

`

5.2 常见问题

5.3 调试SQL

`sql

-- 查看规则统计

SELECT scope, COUNT(*) as count, SUM(CASE WHEN is_active=1 THEN 1 ELSE 0 END) as active

FROM sciot_rules_v2 GROUP BY scope;

-- 查看模板覆盖率

SELECT t.name,

CASE WHEN tmpl.id IS NOT NULL THEN 'YES' ELSE 'NO' END as has_template,

CASE WHEN pt.id IS NOT NULL THEN 'YES' ELSE 'NO' END as has_prompt

FROM sciot_item_types t

LEFT JOIN sciot_templates tmpl ON t.name = tmpl.item_type_name

LEFT JOIN prompt_templates pt ON t.name = pt.item_type_name;

-- 查看执行历史

SELECT r.name, h.item_type, h.action, h.duration_ms, h.executed_at

FROM sciot_rule_history h

JOIN sciot_rules_v2 r ON h.rule_id = r.id

ORDER BY h.executed_at DESC LIMIT 50;

-- 查看高误报率规则

SELECT name, hit_count, user_correction_count,

ROUND(user_correction_count * 100.0 / NULLIF(hit_count, 0), 2) as correction_rate

FROM sciot_rules_v2 WHERE hit_count > 10 ORDER BY correction_rate DESC;

`

6. 优化建议

6.1 已识别问题

6.2 性能优化

1. 为 sciot_rules_v2 添加索引：(scope, item_type_name, is_active, priority)
2. 规则执行支持并行（无依赖的规则）
3. 实现缓存预热：启动时预加载常用规则

6.3 功能增强

1. 规则测试沙箱：POST /api/rule-engine/test`
2. 规则自优化：分析执行历史，自动调整优先级
3. 提示词A/B测试：通过parent_id和score字段支持

7. 文件索引

文档更新时间: 2026-05-31