AI Agent / 系统课时

用 Command 更新并跳转

用 Command 更新并跳转

有些节点在做出局部决策时,既要把原因写回状态,又要立即选择下一节点。把这两件事拆成“节点更新 + 独立路由函数”反而会分散同一个决策。本节用 Command(update=..., goto=...) 把状态更新与跳转合并在一次节点返回中。

学习目标

  • 能在节点中返回 Command 同时更新状态并指定下一跳
  • 能为 Command 的可达节点写出明确的返回类型
  • 能判断何时应使用 Command,何时保留条件边

Command 合并了两类动作

普通节点通常返回状态更新,控制流则由边定义;Command 允许节点一次返回 update 和 goto,分别表示要合并到共享状态的更新,以及接下来要执行的节点。官方文档把它作为需要同时更新状态并路由时的直接用法。([Docs by LangChain][2])

它适合局部决策强绑定状态变更的场景,例如客服分诊节点决定转人工时,同时写入 route_reason;审批节点拒绝请求时,同时记录拒绝原因并跳到补充材料节点。此时把路由再拆成第二个函数,会让一次业务决策分散到两个位置。

Command 同时更新状态并跳转

跑通局部分诊决策

下面的 triage 根据严重程度选择自动处理或人工审核,并把路由原因一起写入状态。它没有额外的条件边,因为下一跳已经由 Command.goto 给出。

python
from typing import Literal, TypedDict
from langgraph.graph import END, START, StateGraph
from langgraph.types import Command

class TicketState(TypedDict, total=False):
    severity: str
    route_reason: str
    owner: str

def triage(
    state: TicketState,
) -> Command[Literal['auto_reply', 'human_review']]:
    if state['severity'] == 'high':
        # 跳转决定与原因更新属于同一业务决策,一起返回。
        return Command(
            update={'route_reason': 'high_severity'},
            goto='human_review',
        )
    return Command(
        update={'route_reason': 'normal_severity'},
        goto='auto_reply',
    )

def auto_reply(state: TicketState) -> dict:
    return {'owner': 'automation'}

def human_review(state: TicketState) -> dict:
    return {'owner': 'human'}

builder = StateGraph(TicketState)
builder.add_node('triage', triage)
builder.add_node('auto_reply', auto_reply)
builder.add_node('human_review', human_review)
builder.add_edge(START, 'triage')
# triage 已经动态决定下一跳,不再为它添加静态出边。
builder.add_edge('auto_reply', END)
builder.add_edge('human_review', END)

graph = builder.compile()

print(graph.invoke({'severity': 'high'})['owner'])
print(graph.invoke({'severity': 'low'})['owner'])

预期输出:

text
human
automation

高严重度请求会先把 route_reason 更新为 high_severity,再进入 human_review;普通请求则写入另一原因并进入 auto_reply。这让“为什么跳转”和“跳到哪里”保留在同一个节点实现里。

用类型标出可能的下一跳

节点返回 Command 时,应在返回类型中列出可能到达的节点,例如 Command[Literal['auto_reply', 'human_review']]。LangGraph 使用这些可达目标信息理解和渲染图结构;官方 Graph API 文档也要求在节点返回 Command 时声明这类目标。([Docs by LangChain][1])

类型标注还有工程价值:阅读函数签名就能知道该节点可能跳往哪里,代码审查时也更容易发现隐藏分支。若后续增加 fraud_review,应该同步把它加入 Literal,而不是只修改 goto 字符串。

不要让 Command 与静态出边打架

Command.goto 添加的是动态控制流;如果同一个节点又配置普通 add_edge 静态出边,静态目标和动态目标都可能执行。([Docs by LangChain][1]) 因此 triage 只接收入边,不再从它额外配置静态出边。

选择方式可以很直接:如果判断逻辑天然独立,只需要“看状态后选方向”,使用条件边;如果节点做出决定时还必须同步写入决定原因、标记或其他状态,使用 Command 更集中。两者都能做动态路由,但维护边界不同。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Command 更新并跳转

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通