openbkn-ai

demand-deliverability-assessment

Use when a user asks whether a product demand (an existing forecast or a new order) can be delivered on knowledge network supply_942_verify: locate the forecast, read the inventory metric, run the kitting / net-demand function, and, only after explicit user confirmation, raise the simulated replenishment action.

openbkn-ai 1,407 139 Updated 2w ago

Resources

1
GitHub

Install

npx skillscat add openbkn-ai/bkn-foundry/demand-deliverability-assessment

Install via the SkillsCat registry.

SKILL.md

需求可交付性评估

这是一个业务流程编排 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,传已发布版本及 query.time={start,end}(Unix 毫秒);按物料拆分时在 query.group_by 中传定义声明的属性引用 从 entries[].value 读取并检查 model、status 否
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 执行步骤

  1. 解析需求:把用户给的产品解析为唯一编码。若给的是预测单号,用 query_object_instance 在「产品需求预测单」上按 billno 或 material_number 用 match 定位(这两个字段是全文索引字段,不要用 ==),取出 material_number 与 qty。名称命中多个编码时先澄清。
  2. 确认替代料策略:substitute_enabled 未给出时先问用户,不得默认。
  3. 读库存背景:调用指标 库存可用量,传业务问题对应的 Unix 毫秒时间窗,作为报告的库存基础数字。
  4. 齐套判断:调用函数 要X套净需求与齐套,传 product、qty、substitute_enabled。kitting_ok=true 直接给「可交付」结论并结束。
  5. 解释缺料:kitting_ok=false 时,按 gaps[] 的 net_requirement 从大到小列出前 5 项缺料;需要说明缺料来自哪一级主料时再调 BOM清单(depth=1)。
  6. 询问是否补货:向用户复述缺料清单与建议补货量,明确询问是否生成模拟补货计划。未得到肯定答复不得执行行动。
  7. 执行行动:用户确认后,先 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。
  8. 报告:按 references/report-spec.md 输出。行动回执必须标注「模拟」,不得表述为已下达采购。

完成门槛

  1. 产品已解析为唯一编码,substitute_enabled 已明确。
  2. 指标与函数结果都来自本网络的调用,不在本地重算。
  3. 行动只在用户明确确认后执行,且报告中标注为模拟。
  4. 任一能力不可用时如实记录 unavailable,不得用估算值替代。

参考

  • references/report-spec.md