mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-16 05:01:58 +00:00
46eb674bc2
派生边界收死在固定层:新增 metrics 节点(口径卡),指标由 AST 白名单 求值器确定性计算,产出受控指标集(含口径名与版本)。叙述层没有算术 权限——不是求模型别编数,而是它编了也过不了校验。 output 节点配 contract 即升级为出具契约:核对必需/期望指标是否齐、 从叙述中抽取所有数字逐个回指指标集(支持千分位、百分数↔比率、 万/亿后缀、按书写精度给舍入容差;日期、ISO 周、枚举序号、引用标记 不参与回指),三档判定 formal / degraded / withheld,缺口清单和 口径版本一起印在成果上,另发 issuance 事件入流水。白名单(allow_numbers) 是模板配置的一部分,进版本、被审查。 新增模板⑧周报:取数固定 → 口径卡算数 → LLM 只许引用清单 → 出具 逐数回指,是'模板定骨架、agent 填关节'的完整示范。 回指校验器 10 用例 + 三档判定 + 端到端五场景全部通过。
79 lines
3.1 KiB
Python
79 lines
3.1 KiB
Python
from __future__ import annotations
|
||
|
||
from typing import Any
|
||
|
||
from app.core.events import EventType
|
||
from app.engine.context import NodeContext, NodeError
|
||
from app.engine.expressions import ExpressionError, eval_expression
|
||
from app.engine.state import GraphState, template_context
|
||
|
||
|
||
async def run_metrics(state: GraphState, ctx: NodeContext) -> dict[str, Any]:
|
||
"""口径卡:把数值计算收进固定层,产出受控的指标集(MetricSet)。
|
||
|
||
表达式走 AST 白名单求值器——确定性、无模型参与、可复算。
|
||
下游叙述节点只许引用这里登记过的数,出具校验器按这份清单抽数字回指。
|
||
这就是"叙述层无算术权限"的机制载体:不是求模型别算,而是它算了也过不了校验。
|
||
"""
|
||
definitions = ctx.cfg("metrics", []) or []
|
||
if not definitions:
|
||
raise NodeError(ctx.node.id, "口径卡没有定义任何指标")
|
||
|
||
tctx = template_context(state)
|
||
caliber = ctx.render_str(ctx.cfg("caliber", "") or ctx.node.title, state)
|
||
caliber_version = str(ctx.cfg("caliber_version", "") or "v1")
|
||
|
||
metrics: list[dict[str, Any]] = []
|
||
errors: list[str] = []
|
||
for definition in definitions:
|
||
metric_id = str(definition.get("id") or "").strip()
|
||
expr = str(definition.get("expression") or "").strip()
|
||
if not metric_id or not expr:
|
||
errors.append(f"指标定义不完整:{definition}")
|
||
continue
|
||
try:
|
||
value = eval_expression(expr, tctx)
|
||
except ExpressionError as e:
|
||
errors.append(f"{metric_id}: 表达式错误({e})")
|
||
continue
|
||
except ZeroDivisionError:
|
||
errors.append(f"{metric_id}: 除以零")
|
||
continue
|
||
decimals = definition.get("decimals")
|
||
if isinstance(value, float) and decimals is not None:
|
||
value = round(value, int(decimals))
|
||
metrics.append(
|
||
{
|
||
"id": metric_id,
|
||
"name": definition.get("name") or metric_id,
|
||
"unit": definition.get("unit") or "",
|
||
"value": value,
|
||
"expression": expr,
|
||
}
|
||
)
|
||
|
||
if errors:
|
||
# 口径卡是固定层:任何一个指标算不出来都是模板缺陷,不能带病出具
|
||
raise NodeError(ctx.node.id, "口径卡计算失败:" + ";".join(errors))
|
||
|
||
# text 是给叙述节点 prompt 用的清单——它是叙述层唯一的数字来源
|
||
lines = [f"- {m['id']}({m['name']})= {m['value']}{m['unit']}" for m in metrics]
|
||
result = {
|
||
"kind": "metric_set",
|
||
"caliber": caliber,
|
||
"caliber_version": caliber_version,
|
||
"metrics": metrics,
|
||
"text": f"指标清单(口径 {caliber} @ {caliber_version}):\n" + "\n".join(lines),
|
||
}
|
||
ctx.emit(
|
||
EventType.LOG,
|
||
level="info",
|
||
message=f"口径卡 {caliber}@{caliber_version}:产出 {len(metrics)} 个受控指标",
|
||
)
|
||
|
||
updates: dict[str, Any] = {"nodes": {ctx.node.id: result}}
|
||
var_name = ctx.cfg("assign_to", "")
|
||
if var_name:
|
||
updates["vars"] = {var_name: result}
|
||
return updates
|