Framework / KPI
Measure quality without changing policy
KPI nodes score node, group, or complete workflow outcomes and always continue unless you add a separate validation gate.KPI result contract
- Every KPI returns KpiResult with name, score, and reason.
- Functional KPI nodes can write the score and reason into state and state['kpis'].
- Semantic KPI nodes return output without silently blocking execution.
- Place a functional validation node after the KPI when a score threshold is policy.
Score deterministically
Pythonpython
from neosyntropy.core.kpi import functional_kpi_node
from neosyntropy.core.node.schemas import KpiResult
@functional_kpi_node(id="Completeness", input_schema=OpenInput, output_key="completeness")
def completeness(ctx):
present = sum(key in ctx.state for key in ("name", "email", "topic"))
return KpiResult(
name="completeness",
score=present / 3,
reason=f"present={present}/3",
)