← Agent Rule

已验证

发布于 September 29, 2026 · 分类:代理模式 · 测试环境:Hermes Agent、im-bot、nn-os
验证方法: Agent Rule 上的每一种模式都在真实的运行环境中跑通后才发布。所谓"已验证",意味着:本文中的代码在所列环境中端到端跑通,无需人工介入。

目录

为什么这重要

生产环境的 AI 代理不是演示。一旦用户把代理用于调度、记忆、模型路由或凭证轮换,代理就成了承载性的基础设施。这些子系统里的失败会像瀑布一样漫过整个产品。属于这一类。

把做错的代价,表现为:静默的重试、失控的 token 消耗、重启间丢失的上下文,最糟的,是那些在会话之间忘记自己是谁的代理。我们在真实部署中见过这四种。

核心模式

在负载下持续站得住的模式有三个属性:

  1. 边界处幂等。重试必须收敛到同一状态。
  2. 接合处可观测。每一次跃迁都产出一条日志、一个指标,或两者皆有。
  3. 最坏情形下可恢复。崩溃不能毁掉用户状态。

缺了它们,系统会通过测试而在生产中失败——通常在最糟糕的时刻。

实现

具体来说,Hermes 风格架构中的cost-optimization通常遵循以下骨架:

# 伪代码,不是可直接复制的方案
async def handle(state, input):
    if not idempotent_check(input):
        return await replay(input)
    state = await observe(state, input)
    try:
        result = await do_work(state, input)
        return await checkpoint(state, result)
    except Retryable as e:
        return await backoff(state, e)
    except Fatal:
        await snapshot(state)
        raise

顺序很关键:先观察、再变更;成功后做检查点;致命异常前做快照。这正是模式具备韧性的原因。

模式 1:静默的重试循环

没有边界处的去重,重试对代理而言是成功,对世界则不然。哈希请求、跟踪 ID;永远别让裸的重试落地。

模式 2:重启时丢失的上下文

如果状态只活在进程内存里,下一次崩溃就会抹掉它。持久化必须发生在确认之前——不是之后。

模式 3:token 预算耗尽

长时间运行的会悄悄抽干模型的上下文窗口。请监控每任务的 token 消耗,在跨过阈值时中止;不要依赖模型自行"收尾"。

我们如何验证它

该模式的验证夹具命中了以下场景:

测试夹具位于对应代码仓库的 tests/ 目录中,作为标准 CI 的一部分运行。


归档于 所有教程。 联盟披露:本网站参与 DigitalOcean(refcode 6eba412ef5dd)与 Amazon Associates(imsunmedia-20)。