From 8c2ff49b506c579ddf101659ab3e035746c10af3 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Sat, 17 Oct 2026 12:17:21 +0800 Subject: [PATCH] =?UTF-8?q?use=5Fcaliber=20=E7=9A=84=E5=8D=8F=E8=AE=AE?= =?UTF-8?q?=E5=86=99=E6=B8=85=20card=20=E5=A1=AB=E4=BB=80=E4=B9=88?= =?UTF-8?q?=EF=BC=8C=E5=86=99=E9=94=99=E4=BA=86=E4=BA=A4=E5=9B=9E=E7=9A=84?= =?UTF-8?q?=E5=8E=9F=E5=9B=A0=E8=83=BD=E4=B8=80=E6=AC=A1=E6=94=B9=E5=AF=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 真实验收里模型第一次常把 card 写成自己起的 c1 被拒,之后才改对:协议示例写的是 "card":"口径卡节点 id",紧接着又说 「口径卡(节点 id 就是 c1)」,两个 id 混在一起。 - api/copilot_context.USE_CALIBER_PROMPT:示例写 "card":"card";说清 workflow_id、version、card 原样照抄,只改 id、metrics、 inputs;card 是那一版工作流图里口径卡的节点 id(查看结果的写法里写好了),id 是这次选用自己起的名字、生成的口径卡用它当 节点 id;add_edge c1 → report 里的 c1 是自己起的 id。 - look/calibers.DETAIL_COMPOSE_PROMPT:同样写明 card 原样照抄、id 自己起。 - ledger/compose:card 写错时说清 card 要填节点 id、可填的有哪几个(「节点 id」(口径卡「名字」)),写成了自己起的 id 的 另说一句「「c1」是你给这次选用起的 id,不是口径卡的节点 id」;几张卡要选时同样列节点 id。校验不放宽。 测试:tests/test_ledger_compose.py 新增两条(协议写清两个 id;card 写成自己的 id 被拒、原因说清该写什么,照着改成节点 id 就过)。改回原来的文字再跑,两条失败。 --- backend/app/api/copilot_context.py | 16 +++++++++------ backend/app/ledger/compose.py | 15 +++++++++----- backend/app/look/calibers.py | 4 ++-- backend/tests/test_ledger_compose.py | 30 ++++++++++++++++++++++++++++ 4 files changed, 52 insertions(+), 13 deletions(-) diff --git a/backend/app/api/copilot_context.py b/backend/app/api/copilot_context.py index 71f90fab..56351f90 100644 --- a/backend/app/api/copilot_context.py +++ b/backend/app/api/copilot_context.py @@ -71,13 +71,17 @@ LOOK_WHEN_ANSWER_PROMPT = LOOK_WHEN_PROMPT.replace( 口径,交给 agent 去查,系统会自动拿它的 SQL 和口径对账。查库交给 agent 时它运行时会自己查表结构:只有从概览看不出 该用哪个库、用户点了表名时才看表,把看到的表名写进 agent 的提示词""") -#: 问数据里输出协议多的一段:选用口径(ledger/compose.py)。只在这一轮能看已发布口径时接在协议后面 +#: 问数据里输出协议多的一段:选用口径(ledger/compose.py)。只在这一轮能看已发布口径时接在协议后面。 +#: 两个 id 写清楚(真实验收里模型第一次常把 card 写成自己起的 c1,被拒之后才改对):card 是那一版工作流图里口径卡的节点 id, +#: 照抄查看结果;id 是这次选用自己起的名字,生成的口径卡用它当节点 id USE_CALIBER_PROMPT = """- 选用已发布口径(只在问数据里、look 过 caliber 之后): - {"op":"use_caliber","id":"c1","workflow_id":"…","version":3,"card":"口径卡节点 id","metrics":["指标id"],"inputs":{"字段":"值"}} - 照抄查看结果里给的写法,只改 id、metrics、inputs。系统按那一版生成取数节点(c1_<原 id>)和口径卡(节点 id 就是 c1), - 并把入口连到取数、取数连到口径卡;你**不要**自己写这几个节点,也不要改它们。接下来只需把口径卡连到报告 - (add_edge c1 → report),报告里用 [[m:指标id]] 引用。inputs 按口径的入口字段填(日期、门店这类问题里给出的条件), - 填不对会被拒收、原因会交回给你改;口径对不上问法时不要选用""" + {"op":"use_caliber","id":"c1","workflow_id":"…","version":3,"card":"card","metrics":["指标id"],"inputs":{"字段":"值"}} + 照抄查看结果里给的那一行写法:workflow_id、version、card 原样照抄,只改 id、metrics、inputs。两个 id 别弄混: + · card 填那一版工作流图里口径卡的节点 id(查看结果的写法里已经写好,例如 "card"),指明选哪一张卡,不是你起的名字; + · id 是你给这次选用起的名字(简短英文小写,例如 c1),系统生成的口径卡就用它当节点 id,取数节点是 c1_<原 id>。 + 系统把入口连到取数、取数连到口径卡;你**不要**自己写这几个节点,也不要改它们。接下来只需把口径卡连到报告 + (add_edge c1 → report,这里的 c1 是你起的 id),报告里用 [[m:指标id]] 引用。inputs 按口径的入口字段填(日期、门店这类 + 问题里给出的条件),填不对会被拒收、原因会交回给你改;口径对不上问法时不要选用""" #: 系统代为查看时写进记录的需求(界面上显示) SYSTEM_LOOK_FIX_NEED = "要修的工作流里,查库节点的 SQL 用到的表" diff --git a/backend/app/ledger/compose.py b/backend/app/ledger/compose.py index 160557f5..50374dd8 100644 --- a/backend/app/ledger/compose.py +++ b/backend/app/ledger/compose.py @@ -47,8 +47,11 @@ _NUMBER = re.compile(r"^\s*-?\d+(?:\.\d+)?\s*$") #: 写给模型的拒收说明(也上界面:过程里那一行) NOT_LISTED = "只能选用这一轮查看到的已发布口径:「{workflow}」v{version} 不在里面(口径要先 look,版本以查看结果为准)" WRONG_VERSION = "「{workflow}」这一轮能选用的是 v{latest}(最新的已发布版本),不是 v{version}" -CARD_UNKNOWN = "「{workflow}」v{version} 里没有口径卡「{card}」(有:{cards})" -CARD_AMBIGUOUS = "「{workflow}」v{version} 有几张口径卡({cards}),请在 card 里写选用哪一张" +#: card 写错时交回的原因要能一次改对:说清 card 填什么、可填哪几个(节点 id);写成了自己起的 id 的另说一句 +CARD_UNKNOWN = ("「{workflow}」v{version} 里没有口径卡「{card}」:card 要填那一版工作流图里口径卡的节点 id,可填的有 {cards}" + "(照抄查看结果里 use_caliber 写法中的 card)") +CARD_IS_OP_ID = ";「{card}」是你给这次选用起的 id,不是口径卡的节点 id" +CARD_AMBIGUOUS = "「{workflow}」v{version} 有几张口径卡(节点 id:{cards}),请在 card 里写选用哪一张的节点 id" NOT_COMPOSABLE = "「{workflow}」v{version} 的口径卡「{card}」不能组合:{reason}" BAD_ID = "use_caliber 的 id 要写成简短的英文小写加下划线(例如 c1),它就是口径卡的节点 id,当前为「{id}」" ID_TAKEN = "use_caliber 的 id「{id}」和图里已有的节点「{node}」撞了,请换一个" @@ -233,12 +236,14 @@ class Composer: if str(version) != str(latest): raise ComposeRefused(WRONG_VERSION.format(workflow=name, latest=latest, version=version)) card = str(op.get("card") or "").strip() - listed = [f"{o.card}({o.node_id})" for o in cards] + listed = [f"「{o.node_id}」(口径卡「{o.card}」)" for o in cards] if card: hit = next((o for o in cards if card in (o.node_id, o.card)), None) if hit is None: - raise ComposeRefused(CARD_UNKNOWN.format(workflow=name, version=latest, card=card, - cards=_names(listed))) + why = CARD_UNKNOWN.format(workflow=name, version=latest, card=card, cards=_names(listed)) + if card == str(op.get("id") or "").strip(): + why += CARD_IS_OP_ID.format(card=card) + raise ComposeRefused(why) return hit if len(cards) > 1: raise ComposeRefused(CARD_AMBIGUOUS.format(workflow=name, version=latest, cards=_names(listed))) diff --git a/backend/app/look/calibers.py b/backend/app/look/calibers.py index 3a5ea8f0..17cbc5c4 100644 --- a/backend/app/look/calibers.py +++ b/backend/app/look/calibers.py @@ -41,8 +41,8 @@ DETAIL_NOT_REUSABLE_PROMPT = " 不能复用:{reason}。请按表重新对" DETAIL_FIELDS_PROMPT = " 口径「{workflow}」v{version} 的入口字段:{fields}" DETAIL_FIELD_PROMPT = "{name}({bits}){desc}" DETAIL_NO_FIELDS_PROMPT = " 口径「{workflow}」v{version} 的入口没有字段" -DETAIL_COMPOSE_PROMPT = (" 能组合:选用写法 {op}(id 自己起,它就是口径卡的节点 id;inputs 按上面的入口字段填,没写的取缺省值;" - "metrics 写要用的指标 id)") +DETAIL_COMPOSE_PROMPT = (" 能组合:选用写法 {op}(card 原样照抄,是那一版图里口径卡的节点 id;id 自己起,生成的口径卡用它当节点 id;" + "inputs 按上面的入口字段填,没写的取缺省值;metrics 写要用的指标 id)") DETAIL_NOT_COMPOSABLE_PROMPT = " 不能组合:{reason}。这份口径只能作为参考,查库交给 agent" BRIEF_PROMPT = "· {name}({workflow} v{version}):字数超过上限,只列名字,要看指标式时点名再 look" MISSING_PROMPT = "没找到口径:{items}(只能查看已发布且未退役的版本里的口径卡;别拿名字相近的顶替)" diff --git a/backend/tests/test_ledger_compose.py b/backend/tests/test_ledger_compose.py index 7dce61e4..6d50941e 100644 --- a/backend/tests/test_ledger_compose.py +++ b/backend/tests/test_ledger_compose.py @@ -292,3 +292,33 @@ async def test_users_do_not_get_calibers_in_the_answer_look(monkeypatch): with pytest.raises(RuntimeError): await copilot.answer_ops(GenerateIn(instruction="x", intent="build")).__anext__() assert seen["kinds"] == ("table", "capability") + + +# -------------------------------------------------------------------------- +# card 填什么:协议写清两个 id,写错了交回的原因能一次改对(校验不放宽) +# -------------------------------------------------------------------------- + + +def test_the_protocol_says_card_is_the_cards_node_id_and_id_is_the_name_you_give(): + text = copilot_context.USE_CALIBER_PROMPT + assert '"card":"card"' in text and '"card":"口径卡节点 id"' not in text + assert "card 填那一版工作流图里口径卡的节点 id" in text and "不是你起的名字" in text + assert "id 是你给这次选用起的名字" in text and "workflow_id、version、card 原样照抄" in text + + +async def test_writing_your_own_id_as_the_card_is_refused_with_what_to_write_instead(): + wf = await S.publish() + pool = await composer() + with pytest.raises(compose.ComposeRefused) as e: + pool.compose(use(wf, card="c1"), taken={"start"}) + message = e.value.message + assert "没有口径卡「c1」" in message and "card 要填那一版工作流图里口径卡的节点 id" in message + assert "可填的有 「card」(口径卡「card」)" in message, message + assert "「c1」是你给这次选用起的 id,不是口径卡的节点 id" in message + # 别的写错(不是自己起的 id)不多那一句 + with pytest.raises(compose.ComposeRefused) as other: + pool.compose(use(wf, card="other"), taken={"start"}) + assert "是你给这次选用起的 id" not in other.value.message + # 校验不放宽:照着交回的原因改成节点 id 就过 + made = pool.compose(use(wf, card="card"), taken={"start"}) + assert made.op_id == "c1"