AI Agent / 系统课时
用 Command 更新并跳转
用 Command 更新并跳转
有些节点在做出局部决策时,既要把原因写回状态,又要立即选择下一节点。把这两件事拆成“节点更新 + 独立路由函数”反而会分散同一个决策。本节用 Command(update=..., goto=...) 把状态更新与跳转合并在一次节点返回中。
学习目标
- 能在节点中返回
Command同时更新状态并指定下一跳 - 能为
Command的可达节点写出明确的返回类型 - 能判断何时应使用
Command,何时保留条件边
Command 合并了两类动作
普通节点通常返回状态更新,控制流则由边定义;Command 允许节点一次返回 update 和 goto,分别表示要合并到共享状态的更新,以及接下来要执行的节点。官方文档把它作为需要同时更新状态并路由时的直接用法。([Docs by LangChain][2])
它适合局部决策强绑定状态变更的场景,例如客服分诊节点决定转人工时,同时写入 route_reason;审批节点拒绝请求时,同时记录拒绝原因并跳到补充材料节点。此时把路由再拆成第二个函数,会让一次业务决策分散到两个位置。

跑通局部分诊决策
下面的 triage 根据严重程度选择自动处理或人工审核,并把路由原因一起写入状态。它没有额外的条件边,因为下一跳已经由 Command.goto 给出。
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'])预期输出:
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 更集中。两者都能做动态路由,但维护边界不同。