BossAgents 使用说明

系统状态

服务运行中 — 端口 3006，连接到 SCSAI PLM (114.113.153.234)

数字员工: 70 个（已从 87 个精简合并，功能零丢失）

演示模式: 点击聊天头部「🎬 演示模式」按钮，选择场景一键体验

一、快速入门

打开浏览器访问 http://localhost:3006，在底部聊天输入框直接输入自然语言指令即可。

⚠️ 不要加 @ 提到某个数字员工。直接打字，系统会自动判断是否分派给专业员工，还是由 AI 助手直接回答。

演示场景（无需记忆，直接打字）

| 你要说的（不加 @） | 系统会做的事情 |

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

| 查询 P-1001 的影响范围
或 帮我分析一下 P-1001 改动了会影响哪些地方
或 查询 P-1001 的变更影响 | L1 规则直通影响分析工具 → 反查 Where-Used → 找到 3 个上级装配（ASSY-A001/A002/A003）→ 生成影响分析报告（4 个零件、3 个 BOM、严重程度 Medium） |

| 检查 Part 数据质量
或 帮我体检一下 BOM 数据
或 数据质量巡检 | L1 规则直通数据巡检 → 扫描 1193 个 Part → 返回约 5500 个问题（缺失重量、成本、分类等），按严重程度分级 |

| 查看最近的治理记录
或 查看最近的操作历史
或 显示审计日志 | L1 规则直通审计日志 → 显示最近 20 条操作历史（巡检记录、创建事件、系统启停等） |

| 审批 ECR-2026-0005
或 批准变更单 ECR-2026-0005
或 通过审批 ECR-2026-0001 | L1 规则直通审批工具 → 走 ECR 本地审批闭环：submit→pending_approval→approved，批准后自动创建对应的 ECO（工程变更单） |

| 提交 ECR-2026-0005
或 驳回 ECR-2026-0002 | 提交→进入待审批；驳回→状态变 rejected（走本地状态机） |

| 发布 P-1001
或 将零件 P-1001 发布为 Released | L1 规则直通审批工具 → promoteItem → 调用 SCSAI PE_ManualRelease 方法（Sciot PLM 身份）→ Part 变为 Released（实测成功）。已发布的零件会提示"必须是 Preliminary/Manual Change 状态" |

✅ 三种场景全部为确定性 L1 直通（auto_execute），不依赖 LLM 调用工具，演示可重复、稳定。

✅ 审批/发布 也是 L1 直通 approve_item（bi_approve_item 规则）。审批对象走本地状态机闭环（可靠）；Part 发布走 SCSAI PE_ManualRelease 真实发布（需 Sciot PLM 身份 demo，2026-08-02 已修复，此前"受控"结论系权限问题）。

📌 如果你 @ 了某个数字员工（如 @小智-文档校验员 检查 Part 数据质量），系统会先校验该员工是否支持查询中的业务类型（Part/Document/BOM…）。不支持时消息会自动转给 AI 助手处理，不会错误地分给文档类员工。

二、后端 API 一览

2.1 影响分析

curl.exe -s -X POST http://localhost:3006/api/change/analyze -H "Content-Type: application/json" -d '{\"description\":\"查询 P-1001 的影响范围\"}'

返回示例:

{
  "success": true,
  "change_type": "part",
  "target_id": "284C6CFC12B34FACA25A416B3D2CD897",
  "affectedParts": 4,
  "affectedBoms": 3,
  "severity": "Medium"
}

2.2 数据巡检

curl.exe -s -X POST http://localhost:3006/api/ai-inspector/inspect -H "Content-Type: application/json" -d '{\"scope\":\"instance\",\"itemType\":\"Part\",\"autoFix\":false}'

2.3 审计日志

curl.exe -s http://localhost:3006/api/audit-logs

2.4 Where-Used 反查

curl.exe -s -X POST http://localhost:3006/api/change/where-used -H "Content-Type: application/json" -d '{\"item_id\":\"284C6CFC12B34FACA25A416B3D2CD897\",\"item_type\":\"Part\"}'

2.5 直接执行 AML 查询

curl.exe -s -X POST http://localhost:3006/api/unified/apply-aml -H "Content-Type: application/json" -d '{\"aml\":\"<AML><Item type=\\\"Part\\\" action=\\\"get\\\" select=\\\"name,item_number\\\" maxRecords=\\\"5\\\"><id>284C6CFC12B34FACA25A416B3D2CD897</id></Item></AML>\"}'

2.6 审批 / 发布（approve_item）

走聊天界面最方便（自动识别类型/编号/动作）。也可直接调接口：

# 审批一个 ECR（自动创建对应 ECO）
curl.exe -s -X POST http://localhost:3006/api/ai-agent/execute -H "Content-Type: application/json" -d '{\"toolName\":\"approve_item\",\"params\":{\"item_type\":\"ECR\",\"item_id\":\"ECR-2026-0005\",\"action\":\"approve\",\"comment\":\"审批通过\"}}'

approve_item 工具支持的参数：

| 参数 | 必填 | 说明 |

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

| item_type | 是 | Part / ECR / ECN / ECO / PR / Document / Vendor |

| item_id | 是 | 对象编号（ECR-2026-0005、P-1001）或 SCSAI GUID |

| action | 否 | approve（批准）/ reject（驳回）/ submit（提交）/ promote（发布）/ release（发布 ECN）/ implement（实施） |

| target_state | 否 | 目标状态名（promote/release 用，默认 Released） |

| comment | 否 | 审批意见 |

各类对象的行为：

| 类型 | 行为 | 是否可程序化流转 |

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

| ECR / ECN / ECO / PR | 走 本地状态机闭环（data/ecrs.json 等），submit→审批→自动创建 ECO | ✅ 可靠 |

| Part 等 SCSAI 对象 | 走 promoteItem → 调用 SCSAI PE_ManualRelease（Sciot PLM 身份），真实发布为 Released | ✅ 可发布（2026-08-02 修复） |

常用话术：

提交 ECR-2026-0005
审批 ECR-2026-0005
驳回 ECR-2026-0002
发布 P-1001        ← 发布为 Released（已发布的零件会提示需在 Preliminary/Manual Change 状态）

三、创建新对象

在聊天输入框直接输入：

帮我创建一个 Part，名称为"测试零件-001"，单位为 EA，重量 1.5kg

系统流程：

1. LLM 将自然语言解析为结构化 JSON
2. 调用 SCSAI 创建 Part 并填入字段
3. 如果 LLM 输出中包含嵌套的 relationships 或 item_properties，系统会自动递归创建子对象（最多嵌套 5 层）
4. 自动处理分类、编号等必填字段

四、常见问题

五、技术配置

六、统一采购对接架构

配置项

供应商切换（仅改 .env，业务代码零改动）

• PROCUREMENT_PROVIDER=jd → 仅京东商品
• PROCUREMENT_PROVIDER=alibaba → 仅阿里巴巴 1688 寻源
• PROCUREMENT_PROVIDER=auto → 比价聚合（京东 + 阿里巴巴并行查询，综合排序）

统一采购接口

统一商品/订单字段

• unifiedProductId: 格式 providerSource:原始SKU（如 jd:JD-DELI-001、alibaba:1688-xxx）
• providerSource: 供应商来源标记（jd/alibaba）
• 统一订单号: PROC+YYYYMMDD+4位序号（如 PROC202608300001）
• providerRoute: 路由标记（jd/alibaba/auto-aggregate/auto-smart）

演示话术

• 采购搜索订书机 → 统一比价结果（京东 + 阿里巴巴商品，标注来源）
• 确认采购下单 → 统一采购下单
• 查采购物流 PROC202608300001 → 统一物流时间轴

真实接入切换

1. 京东真实 API: 设置 JD_MOCK_ENABLED=false + JD_API_KEY=真实Key + JD_API_BASE_URL=真实地址
2. 阿里巴巴 1688 真实 API: 设置 ALIBABA_1688_MOCK_ENABLED=false + ALIBABA_1688_APP_KEY=真实Key + ALIBABA_1688_APP_SECRET=真实Secret + ALIBABA_1688_REFRESH_TOKEN=真实Token
3. 各 Provider 独立切换（京东真实 + 阿里巴巴模拟可共存）
4. 切换仅改 .env 配置，业务代码零改动