AI Agent / 系统课时

设计循环与安全终止条件

设计循环与安全终止条件

智能体常要在“执行—检查—重试”之间循环,但只要出口依赖模型临场判断,就可能持续消耗调用次数。本节把循环条件写进显式状态,用完成标记、次数上限和框架级递归限制共同保证工作流最终停止。

学习目标

  • 用条件边构造能够返回前序节点的 LangGraph 循环
  • 用状态标记和计数器定义可验证的终止条件
  • 区分业务终止条件与框架级安全上限的职责

循环先要有可证明的出口

LangGraph 允许条件边重新指向已经执行过的节点,因此“重试”“反思后重写”“工具调用后再次规划”都可以表示为图中的环。真正的风险不是存在环,而是没有一个由程序能够判定的退出条件。

可靠的循环通常至少检查两个信号:任务是否已经完成,以及允许尝试的次数是否已经耗尽。前者负责正常结束,后者负责异常兜底。不要只让模型返回“继续”或“结束”作为唯一依据,因为模型输出可能反复选择继续。

LangGraph 循环与安全终止条件

用状态驱动循环

下面的最小示例模拟一个最多尝试 3 次的任务。work 每执行一次就增加计数,并在第二次尝试时模拟成功;route 只读取状态,不修改状态,根据完成标记和计数决定结束还是回到 work。

python
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']}"
)

预期输出

text
attempts=2, done=True, result=success

这里的循环不是靠节点名称或执行历史停止,而是靠持久化在状态中的 done 与 attempt_count。即使把成功条件改成永远失败,第三次尝试后也会因为 MAX_ATTEMPTS 而进入 END。

给循环设置两层安全边界

业务层上限应该写进状态和路由逻辑,因为它表达的是产品语义,例如“最多重试 3 次”“最多反思 5 轮”。达到上限后,工作流还能把最后一次结果保存下来,并按业务规则返回失败状态。

调用时的 recursion_limit 则是框架级防线,用来阻止由于错误连边、遗漏分支或其他控制流缺陷产生的无界执行。它不应该替代业务计数器:触发框架上限意味着工作流整体执行失败,而不是一次正常的业务结束。

什么时候应该直接终止

不是所有失败都值得重试。网络抖动、限流等暂时性故障可以进入下一轮;参数非法、权限不足、资源不存在等确定性错误,继续执行通常只会重复得到同样结果。实际工作流可以在状态中增加明确的错误类别,再让路由节点把不可恢复错误直接送往 END 或专门的失败处理节点。

因此,一个可维护的 LangGraph 循环应当同时回答三个问题:什么条件表示成功、什么条件表示已经没有继续尝试的价值、最多允许执行多少轮。只要这三个条件都由显式状态和确定性路由表达,循环就能被测试、观察并安全终止。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计循环与安全终止条件

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

登录哪都通