mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-22 16:02:00 +00:00
驳回出口(后端):审批、补充输入、编辑稿件、动作确认、代码和工具审批、双盲裁决接了「驳回」出口时沿它往下走
以前这六类关卡被驳回一律抛 NodeRejected,运行收成 cancelled + end_reason=rejected,没有「驳回之后走另一条路」 (docs/design/orchestration-round/00-总方案.md §3)。现在画布上多一个可选的「驳回」出口(sourceHandle="rejected",和 分支、审批同一套连线机制): - engine/schema:GATE_TYPES(人工、调用工具、沙箱代码、双盲复算)、reject_targets(驳回出口连到哪几步)、approve_mode; 画布校验:别的节点接驳回出口报错(graph.reject_exit_invalid,条件分支的 case 标识可以叫 rejected,不算);审批同时设了 「驳回即终止运行」和驳回边的给一条提示(human.stop_on_reject_exit) - engine/compiler:接了驳回出口的关卡按出口路由(驳回出口 / 其余是普通出口,连线没写 sourceHandle 的照样是普通出口); NodeRejected 被接住时这一步正常结束:产出 NodeRejected.exit_payload()(rejected、decision、actor、note、kind、text, 审批另带 approved=false、「结果存为变量」照旧写 false),node.finished 带 outcome=rejected、哪种关卡、结论、谁、备注、 转到哪几步(to),trail 记 outcome=rejected;不重试、不被「出错时继续」接住,照旧 - engine/context:NodeRejected 加 stop(审批明说了驳回即终止的,驳回边照旧走不到)和 exit_payload;动作确认抛在发送之前, 走出口时什么都没发 - engine/runner:成功结束的运行途经驳回出口时,run.finished 带 rejected_via(在哪一步、谁、结论、转到哪),照实说「途经 驳回」;没有途经的终态事件一字不变 - engine/governance:发布检查各级都拦「驳回出口那条路走不到成果节点或结束」(reject_exit.no_end);退回上游再问一次的放过 - engine/layout:驳回出口排在普通出口下面 - apps/resolve:实例进度写「被驳回,转到「X」」(动作确认写「未确认(被驳回),转到…」,超时驳回写「超时驳回,转到…」); 实例状态(实例页头、列表、通知同一句)写「「x」被驳回,转到「y」」,走到另一个成果节点的照旧写那个成果节点;退回修改后 又批准了的按批准算;子工作流里的步骤不进实例进度 - 没接出口:行为一字不变(node.failed reason=rejected、运行 cancelled + rejected);审批没设驳回即终止、没接驳回边的老规矩 照旧。接了驳回边的审批,实例进度那一步的说法从「已驳回」改成「被驳回,转到「已退回」」(test_app_instance_page 跟着改) 另:engine/context 的 RunContext 加 prefix / global_id、事件经 stream_writer 发(子工作流把父运行的写入口交下来), 这一步本身不改变最外层的事件,下一个提交接上子工作流 测试:test_reject_exit(五类关卡接了出口各走一遍、批准走普通出口、超时驳回走出口、没接一字不变、驳回即终止优先、 重试和出错时继续不管驳回、退回修改再问一次、校验与发布检查、布局、实例进度);test_process_actions(动作确认走出口 不发送);test_dual_check_node(裁决走出口)
This commit is contained in:
@@ -7,7 +7,7 @@ from typing import Any
|
||||
from langgraph.config import get_stream_writer
|
||||
|
||||
from app.core.events import EventType
|
||||
from app.engine.schema import GraphNode, GraphSpec
|
||||
from app.engine.schema import REJECT_HANDLE, GraphNode, GraphSpec
|
||||
from app.engine.state import GraphState, template_context
|
||||
from app.engine.expressions import render_deep, render_template
|
||||
|
||||
@@ -34,6 +34,35 @@ class RunContext:
|
||||
agent_limits: dict[str, Any] | None = None
|
||||
extra: dict[str, Any] = field(default_factory=dict)
|
||||
|
||||
@property
|
||||
def prefix(self) -> str:
|
||||
"""子工作流里的节点在这次运行里的 id 前缀(「子工作流节点 id/」,嵌套的一层层接上);最外层是空串。"""
|
||||
return str(self.extra.get(PREFIX_KEY) or "")
|
||||
|
||||
def global_id(self, node_id: str) -> str:
|
||||
"""这张图里的节点 id → 这次运行里的 id(事件、工件上记的那个):最外层原样,子工作流里加前缀。"""
|
||||
return f"{self.prefix}{node_id}"
|
||||
|
||||
|
||||
#: 子工作流里的节点 id 前缀(RunContext.extra 里的键,engine/nodes/multi.run_subgraph 放)
|
||||
PREFIX_KEY = "node_prefix"
|
||||
#: 父运行的事件流(RunContext.extra 里的键,同上)。子工作流在父节点里用 ainvoke 跑,LangGraph 不把它的 custom 事件交给
|
||||
#: 父图的流(ainvoke 不开 custom 模式,get_stream_writer 拿到的是空的那个):子工作流里每一步以前在运行的事件里一条都
|
||||
#: 没有,时间线看不到、封存也不含它查过的数。所以 run_subgraph 把父图那一刻的写入口交下来,子工作流的节点经它发
|
||||
STREAM_KEY = "stream_writer"
|
||||
|
||||
|
||||
def stream_writer(run: RunContext) -> Any:
|
||||
"""往这次运行的事件流里写事件的入口:子工作流里是父运行交下来的那个,否则是 LangGraph 这一刻的。不在图执行上下文里
|
||||
(单元测试直接调执行器)时为 None。"""
|
||||
writer = run.extra.get(STREAM_KEY)
|
||||
if writer is not None:
|
||||
return writer
|
||||
try:
|
||||
return get_stream_writer()
|
||||
except Exception: # noqa: BLE001 - 不在图执行上下文里
|
||||
return None
|
||||
|
||||
|
||||
@dataclass
|
||||
class NodeContext:
|
||||
@@ -51,10 +80,13 @@ class NodeContext:
|
||||
|
||||
runner 在另一端消费,转成落库的 RunEvent 并广播给前端 —— 画布上的节点高亮、
|
||||
token 流、工具调用卡片全都来自这里。
|
||||
|
||||
子工作流里的节点经父运行交下来的写入口发(stream_writer),节点 id 带上前缀(RunContext.global_id):
|
||||
「子工作流节点 id/节点 id」,嵌套的一层层接上。事件里别的字段(台账条目、口径卡上记的输入)照旧写这张图里的 id,
|
||||
读的一方按事件的节点 id 认它在哪一层(api/evidence 的 _scoped)。
|
||||
"""
|
||||
try:
|
||||
writer = get_stream_writer()
|
||||
except Exception: # noqa: BLE001 - 不在图执行上下文里(比如单元测试)
|
||||
writer = stream_writer(self.run)
|
||||
if writer is None:
|
||||
return
|
||||
if str(event_type) == EventType.LLM_END and "unpriced" not in data:
|
||||
from app.providers.catalog import unpriced_call
|
||||
@@ -66,7 +98,7 @@ class NodeContext:
|
||||
{
|
||||
"__agentlab__": True,
|
||||
"type": str(event_type),
|
||||
"node_id": self.node.id,
|
||||
"node_id": self.run.global_id(self.node.id),
|
||||
"ts": time.time(),
|
||||
"data": data,
|
||||
}
|
||||
@@ -121,18 +153,36 @@ class NodeRejected(NodeError):
|
||||
|
||||
是 NodeError 的子类:节点这一步照旧记 node.failed(时间线、实例进度按它收尾);但不重试、不被 on_error=continue
|
||||
接住(engine/compiler._execute:那两项是给故障准备的,驳回被吞掉运行就以 succeeded 结束了)。原话(str)照旧写给人看,
|
||||
Run.error 和以前一字不差。kind 见 REJECTION_KINDS;decision 是 reject 或 expired_reject(同待办的结论)。"""
|
||||
Run.error 和以前一字不差。kind 见 REJECTION_KINDS;decision 是 reject 或 expired_reject(同待办的结论)。
|
||||
|
||||
节点在画布上接了「驳回」出口(REJECT_HANDLE,engine/schema.reject_targets)时,驳回不让运行结束:compiler 接住它,
|
||||
这一步正常结束、产出 exit_payload()、沿驳回那条边往下走(docs/design/orchestration-round/00-总方案.md §3)。stop 为真
|
||||
的除外:审批节点明说了「驳回即终止运行」,那条驳回边照旧走不到(以前就是这样),运行照旧收成被驳回。"""
|
||||
|
||||
def __init__(self, node_id: str, message: str, *, kind: str, decision: str = "reject",
|
||||
actor: str | None = None, note: str = "") -> None:
|
||||
actor: str | None = None, note: str = "", stop: bool = False) -> None:
|
||||
super().__init__(node_id, message)
|
||||
self.kind = kind
|
||||
self.decision = decision
|
||||
self.actor = actor
|
||||
self.note = note
|
||||
self.stop = stop
|
||||
|
||||
@classmethod
|
||||
def of(cls, ctx: Any, message: str, *, kind: str, decision: Any) -> NodeRejected:
|
||||
def of(cls, ctx: Any, message: str, *, kind: str, decision: Any, stop: bool = False) -> NodeRejected:
|
||||
"""按节点上下文和读出来的审批结论(engine/approval.Decision)造一个:谁驳回的取 ctx.actor()。"""
|
||||
return cls(ctx.node.id, message, kind=kind, decision="expired_reject" if decision.expired else "reject",
|
||||
actor=ctx.actor(), note=decision.note or "")
|
||||
actor=ctx.actor(), note=decision.note or "", stop=stop)
|
||||
|
||||
def exit_payload(self) -> dict[str, Any]:
|
||||
"""走驳回出口时这一步的产出:{rejected, decision, actor, note, kind, text},加路由用的 __decision__。
|
||||
|
||||
text 是原话(「「付款」未确认(被驳回),没有发送」),下游的「通知」「退回修改」写 {{ nodes.<id>.text }} 就有一句
|
||||
说得清的话;note 是驳回人写的备注。审批模式另带 approved=false:以前接了驳回边的审批节点产出就是
|
||||
{approved: false, note},下游模板读 approved 的照旧读得到。"""
|
||||
out: dict[str, Any] = {"rejected": True, "decision": self.decision, "actor": self.actor, "note": self.note,
|
||||
"kind": self.kind, "text": str(self), "__decision__": REJECT_HANDLE}
|
||||
if self.kind == "approve":
|
||||
out["approved"] = False
|
||||
return out
|
||||
|
||||
|
||||
Reference in New Issue
Block a user