需求可交付性评估
这是一个业务流程编排 Skill。它不自带算法、不写 URL、不带 Token;所有取数与计算都通过当前知识网络已挂载的指标、函数和行动完成。Agent 读完本文后,按「能力依赖」表用平台工具逐步调用即可。
Skill Card
| 字段 | 值 |
|---|---|
bkn_scope |
supply_942_verify |
trigger |
「这单能不能按期交」「预测单 X 现在能交多少」「新增 N 套 Y 产品能否承接」 |
优先指标 |
库存可用量 |
优先函数 |
要X套净需求与齐套;解释缺料结构时补 BOM清单 |
可选行动 |
模拟确认补货计划(须用户确认) |
open_parameters |
product(产品编码)、qty(需求套数)、substitute_enabled(替代料策略)、warehouse_scope? |
能力依赖
Agent 用 search_capabilities 按名称在本网络内找到函数,用 get_kn_detail / get_object_types 找到指标与行动类型。名称与执行工厂、知识网络中的登记完全一致,不要改写。
| 名称 | 类型 | 用途 | 调用方式 | 结果怎么读 | 需确认 |
|---|---|---|---|---|---|
| 库存可用量 | 指标 | 可用库存总口径 | query_metric,time.instant=true;需按物料拆分时加 analysis_dimensions=["material_code"] |
datas[0].values[0] 为合计可用量 |
否 |
| BOM清单 | 函数 | 展开产品一级主料 | execute_tool,参数 product(必填)、depth=1 |
l1_lines[] 为一级主料,line_count 为 BOM 行数 |
否 |
| 要X套净需求与齐套 | 函数 | 齐套判断与缺料 | execute_tool,参数 product、qty、substitute_enabled(必须明确 true/false) |
kitting_ok 为齐套结论;gaps[] 为缺料,取 net_requirement 与 recommended_replenishment_qty |
否 |
| l1_kitting_check | 函数 | 一级主料快速齐套检查(不含在途与替代料) | execute_tool,参数 kn_id、product、qty |
kitting_ok、gap_count、gaps[](net_requirement) |
否 |
| 模拟确认补货计划 | 行动 | 生成模拟补货计划回执 | 先 get_action_info 取参数 schema,再 execute_action;dynamic_params.request_json 为 JSON 字符串,dynamic_params.simulation=true |
回执带 simulation=true、business_write=false,不代表真实业务写入 |
是 |
不在依赖表里的能力不要调用;表里的能力若在本网络找不到,如实告知用户「该能力未挂载」,不要换用其他网络或平台级目录里的同名能力。
Agent 执行步骤
- 解析需求:把用户给的产品解析为唯一编码。若给的是预测单号,用
query_object_instance在「产品需求预测单」上按billno或material_number用match定位(这两个字段是全文索引字段,不要用==),取出material_number与qty。名称命中多个编码时先澄清。 - 确认替代料策略:
substitute_enabled未给出时先问用户,不得默认。 - 读库存背景:调用指标 库存可用量(instant),作为报告的库存基础数字。
- 齐套判断:调用函数 要X套净需求与齐套,传
product、qty、substitute_enabled。kitting_ok=true直接给「可交付」结论并结束。 - 解释缺料:
kitting_ok=false时,按gaps[]的net_requirement从大到小列出前 5 项缺料;需要说明缺料来自哪一级主料时再调 BOM清单(depth=1)。 - 询问是否补货:向用户复述缺料清单与建议补货量,明确询问是否生成模拟补货计划。未得到肯定答复不得执行行动。
- 执行行动:用户确认后,先
get_action_info取「模拟确认补货计划」的参数,再execute_action。参数映射:取gaps[]中net_requirement最大的一项作为瓶颈料,request_json为{"request_id":"DEMO-DLV-<产品编码>","demo_approved":true,"eligible_on_hand":<该项 available_qty>,"reserved":0,"net_demand":<该项 recommended_replenishment_qty>,"safety_stock":0,"qualified_in_transit":<该项 in_transit_qty>,"moq":1,"pack_size":1},simulation=true。 - 报告:按
references/report-spec.md输出。行动回执必须标注「模拟」,不得表述为已下达采购。
完成门槛
- 产品已解析为唯一编码,
substitute_enabled已明确。 - 指标与函数结果都来自本网络的调用,不在本地重算。
- 行动只在用户明确确认后执行,且报告中标注为模拟。
- 任一能力不可用时如实记录
unavailable,不得用估算值替代。
参考
references/report-spec.md