报告撰写节点的「上游没有可引用的来源」认分析结论(_CITABLE 加分析结论,_no_evidence 照 00-总方案 D10):「证据来自」只选了分析卡时不再误报没有可引用的来源;分析卡做的结论总能引用,受管级别的正式出具没开「单元格引用」、上游有分析卡结论时也不再报「只有查询结果…无法引用单元格」;Agent 现场做的分析和它查的格同一个规矩,没开单元格引用时照报,说法写明「只有查询结果和 Agent 现场做的分析…无法引用单元格和这些分析结论」,只有查询时一字不变。测试:只有分析卡结论(开没开单元格引用都不报)、Agent 的分析按单元格引用的规矩、什么都没有时点名分析结论

This commit is contained in:
ThearchyHelios
2026-10-21 16:04:42 +08:00
parent 99b1406f8b
commit 6503b095cb
2 changed files with 49 additions and 6 deletions
+12 -6
View File
@@ -54,6 +54,7 @@ from typing import Any
from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage
from langgraph.func import task
from app.analysis.contract import LEDGER_KIND
from app.core.errors import describe_exception, not_configured
from app.core.events import EventType
from app.db.base import SessionLocal
@@ -73,6 +74,7 @@ from app.engine.evidence import (
UNIT_RULE,
StreamRenderer,
WriterCatalog,
analysis_card,
build_catalog,
catalog_budget,
compose_doc,
@@ -434,19 +436,23 @@ def report_cells_allowed(spec: GraphSpec, node: GraphNode, *, governed: bool) ->
#: 目录里能被报告引用的几种来源(沙箱代码节点的登记只为说清为什么不能引用,不算)
_CITABLE = {"metric": "口径卡指标", "query": "查询结果", "retrieval": "知识库检索", "input": "运行输入"}
_CITABLE = {"metric": "口径卡指标", "query": "查询结果", "retrieval": "知识库检索", "input": "运行输入",
LEDGER_KIND: "分析结论"}
def _no_evidence(catalog: dict[str, Any], cells: bool) -> str | None:
"""目录里没有可引用的来源时给一句话,说清缺的是哪种;有就返回 None。"""
"""目录里没有可引用的来源时给一句话,说清缺的是哪种;有就返回 None。分析结论按 00-总方案 D10 认:分析卡做的总能引用
(判定语、具名的数),Agent 现场做的和它查的格同一个规矩——受管级别的正式出具没开「单元格引用」时引用不了。"""
kinds = {entry.get("kind") for entry in catalog.values()}
if not kinds & set(_CITABLE):
return ("报告撰写节点的上游没有可引用的来源(" + "、".join(_CITABLE.values()) + "都没有),"
f"报告中的数字都会被判为没有出处。请在它前面接入取数节点或口径卡,或检查「{field_label('metrics_from')}」")
if not cells and not kinds & {"metric", "input"}:
# 只有查询和检索:单元格引用不了,检索片段本来就只能当依据,一个数都没处引
return (f"报告撰写节点的上游只有查询结果,没有口径卡指标,而{CELLS_REASON},当前无法引用单元格,"
"报告中的数字都会被判为没有出处。请在出具契约中开启「单元格引用」,或把要写的数字登记到口径卡")
if not cells and not kinds & {"metric", "input"} and not any(analysis_card(e) for e in catalog.values()):
# 只有查询、检索和 Agent 现场做的分析:单元格和这些分析结论引用不了,检索片段本来就只能当依据,一个数都没处引
agent = LEDGER_KIND in kinds
return (f"报告撰写节点的上游只有查询结果{'和 Agent 现场做的分析' if agent else ''},没有口径卡指标,而{CELLS_REASON},"
f"当前无法引用单元格{'和这些分析结论' if agent else ''},报告中的数字都会被判为没有出处。"
"请在出具契约中开启「单元格引用」,或把要写的数字登记到口径卡")
return None
@@ -265,6 +265,43 @@ async def test_the_scope_is_written_only_when_there_are_conclusions(monkeypatch,
assert "analysis_scope" not in doc
# --------------------------------------------------------------------------
# 上游的可引用来源认分析结论(00-总方案 D10)
# --------------------------------------------------------------------------
def card_entry(alias: str) -> dict:
"""分析卡做的结论(台账条目带 item、不带 call_id)。"""
return {**a_entry(alias, fake_result()), "item": "drop", "node_id": "card"}
def agent_entry(alias: str) -> dict:
"""Agent 的分析工具现场做的结论(带 call_id)。"""
return {**a_entry(alias, fake_result()), "call_id": "call-1", "node_id": "ask"}
@pytest.mark.parametrize("cells", [True, False])
def test_conclusions_from_an_analysis_card_are_citable_evidence(cells):
"""「证据来自」只选了分析卡:分析卡的结论总能引用(判定语、具名的数),不报「上游没有可引用的来源」;受管级别的正式
出具没开「单元格引用」时也不报「只有查询结果」。"""
assert report_mod._no_evidence({"A1": card_entry("A1")}, cells) is None
assert report_mod._no_evidence({"Q1": {"kind": "query"}, "A1": card_entry("A1")}, cells) is None
def test_conclusions_from_an_agent_follow_the_cells_rule():
catalog = {"Q1": {"kind": "query"}, "A1": agent_entry("A1")}
assert report_mod._no_evidence(catalog, True) is None
warning = report_mod._no_evidence(catalog, False)
assert warning and "只有查询结果和 Agent 现场做的分析" in warning and "无法引用单元格和这些分析结论" in warning
plain = report_mod._no_evidence({"Q1": {"kind": "query"}}, False)
assert plain and "只有查询结果,没有口径卡指标" in plain and "Agent" not in plain
def test_nothing_citable_names_analysis_conclusions_too():
warning = report_mod._no_evidence({}, True)
assert warning and all(kind in warning for kind in ("口径卡指标", "查询结果", "知识库检索", "运行输入", "分析结论"))
# --------------------------------------------------------------------------
# 判断词不改一句话算不算结论:已发布版本的档位不变
# --------------------------------------------------------------------------