AI Agent / 系统课时
设计循环与安全终止条件
设计循环与安全终止条件
智能体常要在“执行—检查—重试”之间循环,但只要出口依赖模型临场判断,就可能持续消耗调用次数。本节把循环条件写进显式状态,用完成标记、次数上限和框架级递归限制共同保证工作流最终停止。
学习目标
- 用条件边构造能够返回前序节点的 LangGraph 循环
- 用状态标记和计数器定义可验证的终止条件
- 区分业务终止条件与框架级安全上限的职责
循环先要有可证明的出口
LangGraph 允许条件边重新指向已经执行过的节点,因此“重试”“反思后重写”“工具调用后再次规划”都可以表示为图中的环。真正的风险不是存在环,而是没有一个由程序能够判定的退出条件。
可靠的循环通常至少检查两个信号:任务是否已经完成,以及允许尝试的次数是否已经耗尽。前者负责正常结束,后者负责异常兜底。不要只让模型返回“继续”或“结束”作为唯一依据,因为模型输出可能反复选择继续。

用状态驱动循环
下面的最小示例模拟一个最多尝试 3 次的任务。work 每执行一次就增加计数,并在第二次尝试时模拟成功;route 只读取状态,不修改状态,根据完成标记和计数决定结束还是回到 work。
from typing import Literal, TypedDict
from langgraph.graph import END, START, StateGraph
MAX_ATTEMPTS = 3
class LoopState(TypedDict):
attempt_count: int
done: bool
last_result: str
def work(state: LoopState) -> dict:
# 节点只负责执行一次尝试,并把本次结果写回状态。
attempt = state["attempt_count"] + 1
succeeded = attempt >= 2
return {
"attempt_count": attempt,
"done": succeeded,
"last_result": "success" if succeeded else "retryable_error",
}
def route(state: LoopState) -> Literal["retry", "end"]:
# 正常完成优先退出;达到硬上限时也必须停止。
if state["done"]:
return "end"
if state["attempt_count"] >= MAX_ATTEMPTS:
return "end"
return "retry"
builder = StateGraph(LoopState)
builder.add_node("work", work)
builder.add_edge(START, "work")
builder.add_conditional_edges(
"work",
route,
{"retry": "work", "end": END},
)
graph = builder.compile()
result = graph.invoke(
{"attempt_count": 0, "done": False, "last_result": ""},
{"recursion_limit": 10},
)
print(
f"attempts={result['attempt_count']}, "
f"done={result['done']}, "
f"result={result['last_result']}"
)预期输出
attempts=2, done=True, result=success这里的循环不是靠节点名称或执行历史停止,而是靠持久化在状态中的 done 与 attempt_count。即使把成功条件改成永远失败,第三次尝试后也会因为 MAX_ATTEMPTS 而进入 END。
给循环设置两层安全边界
业务层上限应该写进状态和路由逻辑,因为它表达的是产品语义,例如“最多重试 3 次”“最多反思 5 轮”。达到上限后,工作流还能把最后一次结果保存下来,并按业务规则返回失败状态。
调用时的 recursion_limit 则是框架级防线,用来阻止由于错误连边、遗漏分支或其他控制流缺陷产生的无界执行。它不应该替代业务计数器:触发框架上限意味着工作流整体执行失败,而不是一次正常的业务结束。
什么时候应该直接终止
不是所有失败都值得重试。网络抖动、限流等暂时性故障可以进入下一轮;参数非法、权限不足、资源不存在等确定性错误,继续执行通常只会重复得到同样结果。实际工作流可以在状态中增加明确的错误类别,再让路由节点把不可恢复错误直接送往 END 或专门的失败处理节点。
因此,一个可维护的 LangGraph 循环应当同时回答三个问题:什么条件表示成功、什么条件表示已经没有继续尝试的价值、最多允许执行多少轮。只要这三个条件都由显式状态和确定性路由表达,循环就能被测试、观察并安全终止。