agentworkshop 0.7.71 → 0.8.1

package/.AgentWorkShop/prompts/host-tools.json

@@ -2011,6 +2011,42 @@
     "noRefs": true,
     "riskClass": "read"
   },
+  {
+    "name": "aml_model_annotate",
+    "label": "AML 模型描述维护",
+    "riskClass": "write",
+    "description": "维护模型的人读身份:label(一句话名称)与/或 description(这个模型代表什么工况、目标与适用边界)。只改元数据,不改阶段/工件/指标,不影响门禁。Agent 训练登记模型后应主动补齐描述,人类在 /aml 模型台账可见。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "model_id": {
+          "type": "string",
+          "description": "模型 id(必填;aml_leaderboard / aml_model_find 可查)"
+        },
+        "label": {
+          "type": "string",
+          "description": "一句话名称(≤200 字)"
+        },
+        "description": {
+          "type": "string",
+          "description": "人读描述:工况/目标/适用边界(≤500 字)"
+        }
+      },
+      "required": [
+        "model_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "model_id",
+          "kind": "model",
+          "mode": "write"
+        }
+      ]
+    }
+  },
   {
     "name": "twin_provider_catalog",
     "label": "Twin Provider Catalog",
@@ -3607,5 +3643,424 @@
       ]
     },
     "riskClass": "read"
+  },
+  {
+    "name": "ontology_scene_inspect",
+    "label": "本体场景语义",
+    "riskClass": "read",
+    "description": "只读查询某产线的已发布工业本体:实体(设备/变量/质量指标)、它们与数采节点/数控节点/配方参数的语义绑定、已验证影响关系、约束规则的编译决策与运行时守卫。用于在优化/诊断前确认「这个变量是什么、单位是什么、受哪条规则限制、来源是哪一版本体」。分页返回(offset/limit),不写任何状态。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "line_id": {
+          "type": "string",
+          "description": "产线 id(必填;line_context 可看到当前产线)"
+        },
+        "query": {
+          "type": "string",
+          "description": "按实体 key/名称/类型模糊筛选(可选)"
+        },
+        "offset": {
+          "type": "number",
+          "description": "分页偏移(缺省 0)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "每页实体数(1-200,缺省 50)"
+        }
+      },
+      "required": [
+        "line_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "refs": [
+        {
+          "param": "line_id",
+          "kind": "line",
+          "mode": "read"
+        }
+      ],
+      "readableLineNodes": true
+    }
+  },
+  {
+    "name": "ontology_node_neighbors",
+    "label": "本体节点邻接",
+    "riskClass": "read",
+    "description": "只读查询某产线已发布本体中以某个实体为中心的邻接/多跳子图:中心实体(含单位/角色/描述与平台绑定)、各跳邻居节点(key/hop/类型/角色)、关联边(id/关系类型/方向/证据档/hop)与截断标记。用于回答「这个变量与哪些量直接相关、间接影响链有多长、这条边是什么证据档」。entity_key 可先用 ontology_scene_inspect 查到;不写任何状态。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "line_id": {
+          "type": "string",
+          "description": "产线 id(必填;line_context 可看到当前产线)"
+        },
+        "entity_key": {
+          "type": "string",
+          "description": "中心实体 key(必填,如 mv.hold_pressure;可先用 ontology_scene_inspect 查)"
+        },
+        "hops": {
+          "type": "number",
+          "description": "跳数(1-3,缺省 1;2 起可看到间接关联)"
+        },
+        "direction": {
+          "type": "string",
+          "enum": [
+            "both",
+            "out",
+            "in"
+          ],
+          "description": "遍历方向:both=双向(缺省)/out=只沿 src→dst/in=只沿 dst→src"
+        },
+        "kinds": {
+          "type": "string",
+          "description": "关系类型过滤(逗号分隔,如 influences,constrainsBy;缺省=全部)"
+        }
+      },
+      "required": [
+        "line_id",
+        "entity_key"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "refs": [
+        {
+          "param": "line_id",
+          "kind": "line",
+          "mode": "read"
+        }
+      ],
+      "readableLineNodes": true
+    }
+  },
+  {
+    "name": "ontology_draft_create",
+    "label": "本体草稿创建",
+    "riskClass": "write",
+    "description": "创建一个本体草稿(工业语义资产的工作副本)。可空白起草,或从该本体最新的已发布版本克隆后演进。同一本体同一属主只允许一个活跃草稿(重复创建返回 409)。创建后可用 ontology_draft_update 写入实体/关系/规则/绑定,用 ontology_draft_validate 校验,用 ontology_compile_preview 预览编译产物。草稿不会影响任何运行中的求解或下发。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "ontology_id": {
+          "type": "string",
+          "description": "本体 id(必填;形如 ont-pva-line01)"
+        },
+        "line_id": {
+          "type": "string",
+          "description": "授权锚定产线 id(建议填写;留空=全局本体)"
+        },
+        "name": {
+          "type": "string",
+          "description": "本体名称(可选)"
+        },
+        "clone_from_version": {
+          "type": "boolean",
+          "description": "true=从该本体最新已发布版本克隆(必填 false 或省略=空白起草)"
+        }
+      },
+      "required": [
+        "ontology_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "refs": [
+        {
+          "param": "line_id",
+          "kind": "line",
+          "mode": "read"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_draft_update",
+    "label": "本体草稿写入",
+    "riskClass": "write",
+    "description": "以整份文档覆盖写入本体草稿(乐观锁:必须带 expected_rev,取最近一次 validate/update 返回的 rev)。服务端会先做结构校验(实体 key 唯一、引用不悬空、证据级别自洽、单位量纲相容)与语义绑定活体校验(目标节点存在/归属/单位/读写能力),不通过则拒绝落库并返回具体原因。并发修改返回 409。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(必填)"
+        },
+        "expected_rev": {
+          "type": "number",
+          "description": "当前草稿修订号(必填;乐观锁)"
+        },
+        "doc": {
+          "type": "object",
+          "description": "整份本体文档 {schemaVersion:1,name,lineId,entities,relations,rules,bindings}"
+        }
+      },
+      "required": [
+        "draft_id",
+        "expected_rev",
+        "doc"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "write"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_draft_validate",
+    "label": "本体草稿校验",
+    "riskClass": "read",
+    "description": "校验本体草稿并返回结构化报告:实体/关系/规则/绑定计数、生命周期分布、错误与告警(带代码与可行动建议)、以及语义绑定的活体校验失败项(目标不存在/跨线/单位不相容/只读通道声明写/写语义重复)。只读,不修改草稿。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(必填)"
+        }
+      },
+      "required": [
+        "draft_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "read"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_draft_autofix",
+    "label": "本体草稿自动修复",
+    "riskClass": "write",
+    "description": "对本体草稿执行安全自动修复并落库(乐观锁 rev):补写文档/实体/规则描述、量纲跟随单位、规则与绑定作用域回填产线、悬空引用与重复 id 确定性修复、scale 归一;证据不足的控制级硬规则回退为 validated(证据不会被伪造)。返回修复清单与修复后校验结论,平台侧绑定漂移仍如实报告。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(必填)"
+        }
+      },
+      "required": [
+        "draft_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "write"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_rule_explain",
+    "label": "本体规则解释",
+    "riskClass": "read",
+    "description": "解释一条本体规则的完整语义:声明式 DSL、证据级别与来源、生命周期状态、编译决策(compiled/guard/explained/rejected)与决策码、以及会落到哪类产物(求解界/步限/运行时守卫/仅解释)和适用配方与工况。用于回答「为什么这个建议受限制」。可按草稿来源或已发布版本来源查询。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "rule_id": {
+          "type": "string",
+          "description": "规则 id 或 key(必填)"
+        },
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(与 ontology_id 二选一)"
+        },
+        "ontology_id": {
+          "type": "string",
+          "description": "本体 id(查已发布版本来源)"
+        },
+        "version": {
+          "type": "number",
+          "description": "本体版本号(缺省=最近版本)"
+        }
+      },
+      "required": [
+        "rule_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "read"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_compile_preview",
+    "label": "本体编译预览",
+    "riskClass": "read",
+    "description": "把本体草稿编译成四类控制侧产物草案并返回摘要:问题中间表示的可调界与目标界(只收紧)、运行时守卫(条件满足时禁止某类增量)、训练特征候选与时滞先验、场景契约补丁,以及每条规则的溯源决策。不落库、不改变任何运行中的 Profile;approved_only=true 可模拟发布路径(未获批硬约束会被拒)。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(必填)"
+        },
+        "approved_only": {
+          "type": "boolean",
+          "description": "true=仅接受 approved_for_control 规则产出控制侧产物(模拟发布)"
+        }
+      },
+      "required": [
+        "draft_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "read"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_publish_propose",
+    "label": "本体发布提议",
+    "riskClass": "write",
+    "description": "为草稿中处于 validated 的规则提请第二人批准(生成审批单 approvalId),并记录一次发布提议。注意:本工具不能发布版本——批准由人类在 /ontology 审批面裁决,冻结发布仅管理员在 REST 面执行;本工具不写设备、不绕过 HITL 与 D13。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "draft_id": {
+          "type": "string",
+          "description": "草稿 id(必填)"
+        }
+      },
+      "required": [
+        "draft_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "draft_id",
+          "kind": "ontology_draft",
+          "mode": "write"
+        }
+      ]
+    }
+  },
+  {
+    "name": "ontology_version_compare",
+    "label": "本体版本比较",
+    "riskClass": "read",
+    "description": "比较本体两个已发布版本的差异(实体/关系/规则/绑定四段:新增/删除/变更)。不给版本号时返回版本清单。用于回答「这版本体改了什么、为什么控制行为变了」。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "ontology_id": {
+          "type": "string",
+          "description": "本体 id(必填)"
+        },
+        "from": {
+          "type": "number",
+          "description": "起始版本号(可选;缺省列出版本)"
+        },
+        "to": {
+          "type": "number",
+          "description": "目标版本号(可选)"
+        },
+        "version": {
+          "type": "number",
+          "description": "用于归属校验的版本号(可选;缺省取最新)"
+        }
+      },
+      "required": [
+        "ontology_id"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "ontology_id",
+          "kind": "ontology_version",
+          "mode": "read"
+        }
+      ]
+    }
+  },
+  {
+    "name": "optimizer_profile_propose",
+    "label": "模型采纳提议",
+    "description": "AI-first 模型迭代闭环的采纳环节:把 AML 新训练登记的模型采纳为指定优化器 Profile 的新版本——复制当前已发布配置、换上新模型工件、生成草稿并挂人工审批卡;批准后自动冻结发布并把绑定在旧版本的 Agent 全部重绑(在飞求解 BINDING_STALE 收敛),下一次 optimizer_solve 即用新模型。拒绝/超时零写,理由逐字回流。必须给出采纳理由(训练指标对比/互校结论)。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "model_id": {
+          "type": "string",
+          "description": "新模型 id(必填;aml_job_submit 训练完成登记,aml_leaderboard/aml_model_find 可查)"
+        },
+        "profile_id": {
+          "type": "string",
+          "description": "目标 Profile id(本 Agent 只绑一个时可省略;多绑定必填)"
+        },
+        "template_ref": {
+          "type": "string",
+          "description": "可选切换问题模板(linear_mpc_quadratic@1/steady_response@1;须与模型工件兼容)"
+        },
+        "solver_ref": {
+          "type": "string",
+          "description": "可选切换求解器(osqp_mpc@1/scipy_slsqp@1;须与模板兼容)"
+        },
+        "reason": {
+          "type": "string",
+          "description": "采纳理由(必填):训练指标对比/互校结论/业务动因,审批卡展示"
+        },
+        "profile_name": {
+          "type": "string",
+          "description": "可选:新版本人读名称(缺省沿用基线)"
+        },
+        "profile_description": {
+          "type": "string",
+          "description": "可选:新版本人读描述(这个求解配置代表什么工况/目标);缺省沿用基线,人类在 /optimizer 台账可见"
+        }
+      },
+      "required": [
+        "model_id",
+        "reason"
+      ],
+      "additionalProperties": false
+    },
+    "references": {
+      "chained": [
+        {
+          "param": "model_id",
+          "kind": "model",
+          "mode": "read"
+        }
+      ]
+    },
+    "riskClass": "write"
   }
 ]