openbkn-ai {{Skill 标题}}
这是一个业务流程编排 Skill。它不自带算法、不写 URL、不带 Token；所有取数与计算都通过当前知识网络已挂载的指标、函数和行动完成。Agent 读完本文后，按「能力依赖」表用平台工具逐步调用即可。
Skill Card
| 字段 | 值 |
|---|---|
bkn_scope |
{{kn_id}} |
trigger |
{{用户会怎么问，列 2 到 3 种说法}} |
优先指标 |
{{指标名称}} |
优先函数 |
{{函数名称}} |
可选行动 |
{{行动名称}}（须用户确认） |
open_parameters |
{{Agent 必须从用户那里拿到的参数，逐个列出}} |
能力依赖
Agent 用 search_capabilities 按名称在本网络内找到函数与 MCP 工具，用 get_kn_detail / get_object_types 找到指标与行动类型。名称与执行工厂、知识网络中的登记完全一致，不要改写。
| 名称 | 类型 | 用途 | 调用方式 | 结果怎么读 | 需确认 |
|---|---|---|---|---|---|
| {{指标名称}} | 指标 | {{用途}} | query_metric，time.instant=true；需拆维度时加 analysis_dimensions |
datas[0].values[0] |
否 |
| {{函数名称}} | 函数 | {{用途}} | execute_tool，参数 {{参数名逐个列出，标明必填}} |
{{关键返回字段与含义}} | 否 |
| {{行动名称}} | 行动 | {{用途}} | 先 get_action_info 取参数 schema，再 execute_action |
{{回执关键字段}} | 是 |
不在依赖表里的能力不要调用；表里的能力若在本网络找不到，如实告知用户「该能力未挂载」，不要换用其他网络或平台级目录里的同名能力。
Agent 执行步骤
- 解析需求：{{把用户输入解析成函数需要的参数；文本字段定位用
match，不要用==}}。 - 确认前置参数：{{哪些参数缺失时必须先问用户，不得默认}}。
- 读指标：调用 {{指标名称}}，{{怎么用这个数字}}。
- 调函数：调用 {{函数名称}}，传 {{参数}}。{{什么结果直接给结论并结束}}。
- 解释结果：{{结果不理想时怎么拆解、列前几项}}。
- 询问是否执行行动：向用户复述{{要执行什么、影响什么}}，明确询问。未得到肯定答复不得执行行动。
- 执行行动：用户确认后，先
get_action_info取「{{行动名称}}」的参数，再execute_action。参数映射：{{函数结果的哪个字段填到行动的哪个参数}}。 - 报告：按
references/report-spec.md输出。行动回执必须标注{{模拟 / 已提交}}。
完成门槛
- {{参数已解析且必填项已确认}}。
- 指标与函数结果都来自本网络的调用，不在本地重算。
- 行动只在用户明确确认后执行。
- 任一能力不可用时如实记录
unavailable，不得用估算值替代。
参考
references/report-spec.md