# 工业智能体场景蓝图：从订单到交付

> 方案深化稿。基于用户给出的场景示意图，面向本仓库的实际模块和接口重新定义。图片中的数字、客户、设备和执行状态仅作交互示例，不代表本系统真实数据或已实现功能。本文只设计，不改动业务代码。

工程实现参见 [LangGraph 定制技术方案](industrial-agent-langgraph-technical-design.md)，其中齐套分配与库存口径是本蓝图简化公式的实施细化。

前期数据准备与日常增量补录由 [工作文件补录核心能力](industrial-agent-document-onboarding-design.md) 承担；未核实的文件候选数据不能直接作为九场景中的当前业务事实。

## 一、产品目标

用户要的不是“能回答制造业问题的聊天框”，而是一个在现有 CRM、ERP、SRM、MES、WMS、质检、设备、售后、BPM 和 BI 上工作的**业务执行助理**：按计划主动巡检；用户提问时能沿订单与批次链找证据；给出可核算的结论；把需要处理的事项交给正确岗位；持续跟进到业务系统回写完成。

一个场景必须同时具备五部分才算交付：**触发条件 → 业务取证 → 确定性计算/判断 → 可核对的结果 → 人机边界与回写**。界面上的“已执行”仅在 Java 业务接口返回真实业务单号后出现。“预测”“建议”“草稿”“审批中”“已执行”“已关闭”是不同状态，不能混用。

## 二、九个场景路线

| 编号 | 场景 | 触发 | 主要系统 | 第一版产物 | 后续闭环 |
| --- | --- | --- | --- | --- | --- |
| 01 | 接单评审与交期答复 | 合同/销售订单创建或交期变更 | CRM、ERP、MES、WMS | 最早可承诺日与冲突清单 | 评审单、答复草稿、人工发送 |
| 02 | 开工齐套与缺料催交 | 次日工单定时巡检/工单下发 | MES、WMS、ERP、SRM | 齐套率、净缺口、采购关联 | 催交待办、回执与再次计算 |
| 03 | 工单超期巡检 | 每班/每日巡检和报工变化 | MES、排班、设备 | 真超期工单、卡点与责任组 | 指派待办、超时升级 |
| 04 | 插单与排程重算 | 急单申请/资源或设备变化 | CRM、ERP、MES、设备、排班 | 两套排程方案与受影响订单 | 人审后调用现有排程服务 |
| 05 | 发货与仓储拦截 | 发货通知/出库前检查 | WMS、ERP、OQC、批次/SN | 可发数量、阻断原因、位置 | 拣货/发货建议，单据照原审批 |
| 06 | 质量异常与停线复验 | IPQC 越限/NCR/设备检验事件 | MES-QC、工单、仓储、设备 | 影响批次和已流转范围 | 隔离建议、复验待办、停线申请待签 |
| 07 | 设备漏检与保养 | 点检时窗/运行时长到期 | 设备、工单、排班 | 漏检清单和关键设备排序 | 保养/补检待办与维修回执 |
| 08 | 委外加工对账 | 月结或外协单完结 | MES-WM、ERP、SRM | 发收耗损与价格差异清单 | 采购核实、财务审批后结算 |
| 09 | 客诉批次追溯 | 售后工单/客户批号提问 | 售后、ERP、WMS、MES-QC | 正反向追溯图、受影响客户 | 回复草稿、缺证据任务 |

横向能力包括**工单成本归集**、**经营异常问答**、**日/周报生成**。这些可消费九个场景的可信结果，但成本核算须先确认材料价、工时费率、委外费用、期间口径和财务责任人，不能直接把报工时数乘一个猜测费率。

## 三、场景细化

### 01 接单评审与交期答复

- **典型问句**：“客户要把这单提前到 15 号，能答应吗？”
- **取证**：CRM 合同/客户要求、ERP 销售订单行、MES MPS/工单与工艺路线、工单 BOM、WMS 可用库存和占用、在途采购与设备/班次能力。全部以同一订单行、产品 SKU、数量和单位为基准。
- **计算**：`最早物料齐套时间` 与各工序可用产能窗口结合，模拟最早完工与 OQC/出库时间；承诺日要加上配置的检验与物流提前期。现有生产 AI 交付预测可作参考，不能替代排程与库存硬约束。
- **结果**：可承诺日范围、相对客户要求的差额、受影响工单、关键路径和证据时间。若计算不可行，列出“加班/调设备/挪单”方案及每个方案挤占哪些订单。
- **动作边界**：生成接单评审草稿和客户回复草稿；销售/计划员选择方案，合同变更及客户消息必须由授权人提交。系统记录采用了哪个版本的排程数据。
- **缺口**：需要统一的订单到工单关联查询、库存可用量口径、排程模拟结果的版本快照、交期回复审批与发送入口。

### 02 开工齐套与缺料催交

- **典型问句**：“明天要开的工单，哪些料齐了？”
- **取证**：已批准工单 BOM 版本、工单需求量、WMS 库存的仓库/库位/批次/冻结/占用、领料记录、采购订单未到数量、供应商交期。
- **计算**：逐物料计算 `净可用 = 合格现存 − 已占用 − 冻结 − 不可用批次`，`净缺口 = max(需求 − 已领 − 净可用, 0)`；按相同物料、单位、采购来源合并缺口，同时保留工单分摊明细。不能把“在途”直接计入现存。
- **结果**：工单级齐套/欠料分类、按物料合并的采购催交清单、供应商承诺日与开工时间差、无采购单或交期不明项目。
- **动作边界**：可自动生成采购内部待办并提醒责任人；采购改交期、下单、替料、特采须走原业务审批。每次采购回执/入库后重算并显示变化。
- **缺口**：现有库存与 BOM 接口需聚合成一次可复用齐套快照；催交待办和供应商回执需要明确系统内承载方式。

### 03 工单超期巡检

- **典型问句**：“今天有哪些工单跟不上计划？”
- **取证**：工单工序计划节点、报工审批后的实际完成量、设备停机、班次日历、工单状态、责任班组。
- **计算**：排除已完成/取消/改期并重新基线的工单；仅在计划节点到期且实际进度不足时判超期。连续两班无有效报工是单独风险，不能自动等同“没干活”，还要核对报工审批中与离线补报。
- **结果**：超期清单、预计延误量、卡住的工序、连续未进展时长、责任组、下游交付影响。
- **动作边界**：生成班组长待办、截止时间、未回复升级规则；任何班组绩效判断由主管确认。状态由待办回执及新报工自动更新。
- **缺口**：需要统一计划节点与实际进度的时间口径、逾期基线版本，以及与现有通知/任务系统的对接。

### 04 插单与排程重算

- **典型问句**：“把这个急单插进去，会影响谁？”
- **取证**：订单优先级、已承诺交期、在制工单、工艺路线与设备效率、设备维护窗口、班组排班、物料齐套情况。
- **计算**：使用现有排程预览能力生成“保持现状”与“插单方案”两份快照，逐工单比较开始/结束时间、设备占用、改期天数和已承诺客户。
- **结果**：受益订单、受损订单、不可用资源、需同意的岗位、排程变化图；无法满足约束时返回原因，不输出“已安排”。
- **动作边界**：计划员确认、必要时销售确认客户交期后，Java 业务服务执行正式排程。Agent 不能自行覆盖已批准的工单计划。
- **仓库依据**：`MesProTaskController` 已有 `auto-schedule/preview` 和正式排程入口；跨订单影响比较与审批门槛需补充。

### 05 发货与仓储拦截

- **典型问句**：“这单明天能发吗？缺在哪一格？”
- **取证**：销售订单、发货通知、成品库存位置/批次/SN、库存冻结与占用、OQC 结论、拣货/装箱与出库状态。
- **计算**：按订单行与批次核算可发数量；列出质量未放行、冻结、已占用、库位不明或数量不足的阻断项。应使用仓储业务服务确认可用量，不复刻库存事务规则。
- **结果**：可发/不可发数量、阻断原因、预计解除时间、库位清单、同批次关联订单。
- **动作边界**：可生成拣货与补证据建议；库存调整、解冻、正式出库、发货通知仍走原系统权限及审批。
- **缺口**：需汇总 ERP 销售订单与 WMS 出库/库存占用/OQC 的查询视图。

### 06 质量异常与停线复验

- **典型问句**：“这批的缺陷是不是有点多？已经流到哪里？”
- **取证**：IPQC 指标值与检验标准版本、缺陷记录、工单批次、已产出量、下道工序流转、库存批次、设备或检验设备日志。
- **计算**：按指标规则判越限，统计连续次数、样本数量、影响批次/工件、已流转范围。区分“规则判越限”“建议隔离”“停线已批准”“实机停线已执行”。
- **结果**：异常单/NCR 草稿、影响面清单、复验任务、停线申请草稿；全部附原始检验记录与标准版本。
- **动作边界**：越限可自动告警与生成复验待办；隔离/库存冻结需仓储或质量授权；停线和复线分别由有权限岗位签字，Agent 不下发控制指令。
- **缺口**：本仓库有 IPQC、NCR 与工单关联，但图片中的检验设备数据采集、停线双签和控制系统回读需要新增集成与流程。

### 07 设备漏检与保养

- **典型问句**：“昨天的点检有没有没做的？哪些会影响关键工序？”
- **取证**：设备台账、点检计划/记录、保养计划/记录、维修单、工单设备分配、班次与设备运行时长（若有可信采集源）。
- **计算**：按设备适用计划、班次窗口和有效提交记录找漏检；排除停用、维护中和计划暂停的设备。按照未来生产占用和工序关键性排序。
- **结果**：漏检设备、最后有效点检时间、预计影响工单、今日到期保养、已存在维修单。
- **动作边界**：生成补检与保养待办，避免重复建单；维修人完成并回写记录后关闭。是否继续使用设备由设备负责人依据现场检查决定。
- **缺口**：运行时长触发需可靠 IoT/设备采集源；仅有手工台账时先按计划周期触发。

### 08 委外加工对账

- **典型问句**：“这个月委外的账差在哪几笔？”
- **取证**：外协工单、外协发料/入库、IQC 合格量、供应商、采购或合同约定损耗率与单价、来票与付款状态。
- **计算**：逐单逐物料比对发料、收回、报废/退料、合同允许损耗，计算超耗数量；逐合同版本比较结算价与约定价，列出数量差和价差。单位换算、税率、币种、退补料要明确处理。
- **结果**：差异台账，含单号、依据、数量、金额、责任待确认项；不能把未验收的收货当作合格入库。
- **动作边界**：采购核实并记录供应商答复，财务复核后才生成应付或扣款。Agent 可以跟踪逾期未核实项，不能自行判定损耗归属。
- **缺口**：MES 已有外协发料/入库对象；合同约定损耗、加工价和结算口径是否在当前系统完整可查需进一步盘点。

### 09 客诉批次追溯

- **典型问句**：“客户投诉的这个批号，是哪批料做的？还发给了谁？”
- **取证**：售后工单、ERP 销售订单、WMS 销售出库/SN/批次、MES 工单领料、来料批次、IQC/IPQC/OQC 与质检报告版本。
- **计算**：沿“出货批次→工单产出→领料批次→到货/供应商”反向追溯，再从可疑来料批次正向寻找其它工单、库存和客户。每条边记录来源单据、数量、时间和可信度。
- **结果**：可展开的追溯图、受影响客户/库存/在制清单、证据断点、客户回复草稿。纸质报告或未电子归档资料明确列为断点，不能给出完整追溯结论。
- **动作边界**：客服与质量负责人确认外部回复；是否通知其他客户、召回、冻结库存等由对应负责人决定。
- **仓库依据**：现有批次前向/后向及工序追溯入口可复用；售后与出库的跨域关联、报告附件完整性还需验证。

## 四、支撑上述场景的统一能力

### 4.1 订单与批次关系图

统一键为业务对象引用 `module + object_type + id + code`，边来自业务外键或回调记录。主线为：

```mermaid
flowchart LR
  CRM[CRM 合同] --> SO[ERP 销售订单]
  SO --> MPS[MES MPS]
  MPS --> WO[生产工单]
  WO --> BOM[工单 BOM]
  WO --> FB[工序任务/报工]
  BOM --> ST[库存/占用/领料批次]
  FB --> QC[IPQC/OQC]
  FB --> FG[成品批次/SN]
  FG --> SHIP[出库/发货]
  SHIP --> AFTER[售后/客诉]
  ST --> SUP[采购/供应商/IQC]
```

每条关联分为**直接外键、业务回调、规则推导、人工确认**四种。仅前两种可作为“已确认事实”。业务编号相似、时间接近不能自动认作同一单据。

### 4.2 主动运行与持续跟进

- 定时任务：次日齐套（建议早班前）、工单超期（每班）、设备点检（计划窗口后）、委外对账（月结）。具体时间取企业班次/节假日设置，不硬编码图片里的 07:30、08:00、06:30。
- 事件触发：订单交期变更、采购交期更新、报工审批、质检越限、维修状态变化、出库完成、售后工单创建。
- 巡检结果要去重：`场景 + 业务对象 + 基线版本 + 时间窗口` 形成事件键；仅关键事实变化时重新通知。待办有负责人、到期时间、回执状态、升级路径和关闭条件。
- 工作流状态：`待取证 → 计算中 → 待人工判断/待审批 → 已提交业务系统 → 业务处理中 → 已验证关闭`，另有 `证据不足`、`过期需重算`、`执行失败`。Agent 的任务完成不代表业务单据完成。

### 4.3 回答与操作卡片

对话是入口，卡片是可操作的工作台。每个结果卡至少显示：**结论、统计口径/时间、关键数字、证据单据、做过的三步、建议动作、当前状态、责任人、下一次检查时间**。点击数字可展开明细，点击证据跳原业务页面；“确认发送/审批/改排程”按钮只在有权限且数据未过期时出现。

采用与当前 Vue 管理端一致的操作型布局：左侧任务/场景导航，中间结论与证据，右侧待办与审批状态。移动端优先显示结论、待办和证据摘要，复杂追溯图提供表格替代。所有状态同时用文字和颜色表达，按钮有明确的加载、失败、无权限和数据过期反馈。图片里的样式可作视觉参考，真实界面必须显示真实单号及执行结果。

**场景 02 的界面样例（纯示例数据）**：用户问“明天计划开工的 10 张工单，哪些能开？”卡片先答“6 张齐套，4 张缺料”，显示“检查了 10 份工单 BOM、库存/占用、7 张关联采购单”，再列出每张欠料工单的物料、净缺口、采购单及供应商交期。下一张卡展示“采购催交待办草稿：2 名负责人、截止今日 16:00”。用户确认后，Java 服务返回待办编号，界面才改为“已派发”；采购回执或库存入库后重新计算，旧结论显示“数据已变化，请查看新版”。数字、动作和证据始终可展开核对。

### 4.4 人机边界矩阵

| 级别 | 例子 | 默认行为 |
| --- | --- | --- |
| L0 自动取证 | 查工单、库存、批次、检验、审批状态 | 有权限即可运行并留痕 |
| L1 自动计算/提醒 | 齐套、逾期、漏检、差异、内部提醒 | 规则版本化、可撤回提醒、可复算 |
| L2 待办/草稿 | 催交待办、复验待办、回复稿、评审稿 | 按岗位授权，回显草稿与业务单号 |
| L3 审批后写入 | 排程变更、库存隔离/解冻、采购单、财务结算 | Java 校验、BPM 审批、幂等执行、回读验证 |
| L4 现场安全决定 | 停线/复线、设备继续使用、特采/放行、召回 | 必须由有权人员决定；Agent 只提供证据与申请 |

### 4.5 技术落点

Python 独立服务采用“场景编排器 + 领域工具注册表 + 确定性计算器 + 知识检索 + 模型说明器”。Java 增加面向智能体的内部聚合 API，负责现有用户身份、数据范围、业务校验和审批。Python 不直接操作业务数据库。首批工具包括 `get_order_context`、`calculate_material_readiness`、`preview_schedule`、`inspect_workorder_progress`、`trace_batch`、`get_quality_context`、`get_equipment_due`、`reconcile_outsource`；每个工具有输入/输出 schema、权限、版本和测试基准。

## 五、与当前仓库的接入核对

| 能力 | 代码中已看到的入口 | 仍需建设或核实 |
| --- | --- | --- |
| 生产预测 | `MesProAiController` 四类预测 | 与确定性排程/库存口径融合、结果校准 |
| 生产排程 | `MesProTaskController` 预览和执行 | 多方案比较、受影响订单、审批门槛 |
| 仓储 | 物料库存、占用、出库、批次追溯控制器 | 跨仓/批次的净可用聚合和源数据时点 |
| 质检 | IQC/IPQC/OQC/RQC、NCR、质检报告 | 检验设备采集、停线/复线签批、报告附件补全 |
| 设备 | 点检计划/记录、保养/维修控制器 | 运行时长采集、关键工序影响排序 |
| 委外 | 外协发料与入库控制器 | 合同价/损耗率、完整月结与归责流程 |
| 销售与售后 | CRM 合同、ERP 销售订单、售后工单 | 统一订单到批次链与跨系统客户回复流程 |
| 审批/通知 | BPM 与系统通知基础能力 | Agent 专用待办、提醒回执、审计视图 |

这些“已看到的入口”只证明对象和部分操作存在；上线前仍须检查参数、权限注解、数据范围、单据状态机和真实数据完整度。

## 六、建议的首批交付组合

推荐以 **01 接单评审 + 02 开工齐套 + 03 超期巡检** 为第一条纵向链：销售能回答能否接，计划知道能否开工，车间知道哪里卡住。这条链能复用现有生产预测、库存和排程入口，并为其余场景打下订单关系图、主动巡检、待办回执和证据卡基础。

第二条链做 **06 质量异常 + 09 批次追溯**，重点验证跨批次关联与“证据断点”表达。第三条链做 **07 设备 + 08 委外 + 05 发货**；04 排程正式执行待审批链完善后开放。

验收不以演示对话流畅为准，而以业务结果为准：结论能复算、受影响单据不漏不串、权限不穿透、待办真的到人、审批与业务单号能回读、数据变化后能撤销过期结论。每个场景至少准备正常、数据缺失、跨权限、单据变更和动作失败样本。

**待最终选择**：九场景路线与推荐交付顺序是否符合企业优先级；是否把“工单成本归集”和“经营问答”提升为第一批。确认后再将本蓝图收敛为接口清单、数据契约、页面流程和实施任务。