AGENT PRODUCTION ENGINEERING

BUILD AGENTS
THAT SURVIVE
PRODUCTION.

Production-grade engineering patterns for autonomous AI agents.
让 AI Agent 从「能运行」,进化到「能够长期稳定运行」

HERMES PRODUCTION CONSOLE
● Scheduler ACTIVE
● Maker EXECUTING
● Checker VALIDATING
● State SYNCHRONIZED
QUALITY SCORE
92%
SYSTEM HEALTH
98%
LAST CHECKPOINT 2m ago
SYSTEM ● ONLINE

DIAGNOSIS

WHY AGENTS FAIL IN PRODUCTION

Agent 在生产环境里的失败不是随机的,而是六类结构性问题。每一条都对应一个已被验证的工程解法。

PROBLEM 01

STATE LOSS

SESSION ENDS. THE AGENT FORGETS EVERYTHING.

会话结束,Agent 忘记一切。

ENGINEERING ANSWER→ STATE FILE
PROBLEM 02

SILENT FAILURE

THE AGENT FAILED. NOBODY KNOWS.

任务失败了,没有人知道。

ENGINEERING ANSWER→ MAKER / CHECKER
PROBLEM 03

CRON DRIFT

THE JOB RUNS. BUT NOT AS EXPECTED.

任务在跑,但不是预期的样子。

ENGINEERING ANSWER→ CRON JOB
PROBLEM 04

CONTEXT EXPLOSION

ERRORS KEEP ACCUMULATING. CONTEXT KEEPS GROWING.

错误不断堆积,上下文持续膨胀。

ENGINEERING ANSWER→ ERROR COMPACT
PROBLEM 05

SELF VALIDATION

THE AGENT VALIDATES ITSELF. THE VALIDATION IS NOT INDEPENDENT.

自己给自己打分,验证并不独立。

ENGINEERING ANSWER→ MAKER / CHECKER
PROBLEM 06

SKILL REGRESSION

NEW SKILL. OLD CAPABILITY BREAKS.

新模式上线,旧能力回归了。

ENGINEERING ANSWER→ EVOLUTION GATE

PROBLEM → PATTERN → RESULT

EACH PROBLEM HAS AN ENGINEERING ANSWER

不是技巧清单,而是「问题 → 模式 → 结果」的因果链。

STATE LOSSSTATE FILEPERSISTENT AGENT
SILENT FAILUREMAKER / CHECKERINDEPENDENT VALIDATION
CRON RUNS WRONGCRON JOBRELIABLE AUTOMATION
CONTEXT EXPLOSIONERROR COMPACTBOUNDED CONTEXT
SELF VALIDATIONMAKER / CHECKERINDEPENDENT GATE
SKILL REGRESSIONEVOLUTION GATEVERIFIED EVOLUTION

THE SYSTEM

ONE PRODUCTION-READY LOOP

调度触发 → 生成 → 独立验证 → 持久化 → 通知;失败则压缩错误重试,超限升级人工。节点可点击进入对应 Pattern。

这条流水线本身就是 Pattern 的组合:Cron Job 负责可靠触发,Maker / Checker 负责输出质量,State File + Checkpoint 负责断电恢复,Error Compact 负责失败不污染上下文。完整拆解见 Architecture 页。

PATTERNS WORK TOGETHER.

A SYSTEM, NOT A TRICK LIST

Production agents are built from systems of patterns, not isolated techniques. 悬停高亮关联,点击进入公约。

PATTERNSWORK TOGETHER检查点模式长任务中途挂了从哪恢复STATE.md 跨运行状态管理Read Before Run, Write After Every Step进化闸门 G1-G5五维加权评估、经验价值判定、回归对比、Deploy or RollbackMaker/Checker 双角色分离生成与验证不在同一个 Agent控制流分离确定性代码 vs LLM 路由矩阵,能用代码的别用 LLMCron 任务设计模式幂等、防重复、防静默失败(含 Hermes 原生 Monitor 模式)Memory OS五层记忆架构、向量/图谱/RRF 检索、写侧纪律与每日复盘成本护栏三级预算响应(预警/降级/熔断)防止 token/API 调用失控错误压缩模式将原始错误压缩为结构化摘要,防止 Agent 失焦人工介入升级高风险/低置信度/连续失败时升级到人工兜底多 Agent 协作隔离命名空间/文件锁/令牌桶防止资源竞争数据驱动技能优化以真实运营数据驱动技能迭代,技能是活文档Hermes 自更新安全流程更新前备份、更新后验证、失败归因、可回滚技能进化管理如何从 v1 升级到 v2,不破坏现有工作流数据保留与隐私STATE.md/日志中的敏感信息清单、保留期限、自动清理密钥管理API Key、Token、密码的存放和轮换规范反面模式(Anti-Patterns)生产中常见的 Hermes Agent 错误实践及纠正方案Hermes 能力 × 生产模式映射2026-09 工具能力总览,把新能力对号入座到既有模式模式组合指南何时使用哪个 Convention,以及如何组合可观测性/决策追溯结构化日志记录决策链路、置信度、备选方案

PATTERN LIBRARY

FEATURED PATTERNS

三个最核心的生产组件,建议按此顺序理解整个系统。

SECONDARY PATTERNS

MATURITY MODEL

FROM AGENT TO PRODUCTION SYSTEM

从 Prompt 到自主系统的六级阶梯;每一级由对应 Pattern 托底。

PROMPT
SKILL
LOOP
STATEFUL AGENT
VERIFIED AGENT
AUTONOMOUS AGENT
L1

ASSISTANT

人触发、人检查、人兜底。Prompt 与 Skill 即可起步。

REQUIRED PATTERNS
State File

L2

COPILOT

定时自主运行,输出经独立验证,失败可恢复。

REQUIRED PATTERNS
Cron Job Maker / Checker Checkpoint

L3

AUTONOMOUS AGENT

长期进化:可观测、可回归、可安全自我更新。

REQUIRED PATTERNS
Memory OS Evolution Gate Self Update

CASE STUDIES

RUNNING IN PRODUCTION, NOT IN A DEMO

四条 Pattern 在真实 7×24 工作流中的组合应用。

CASE STUDY

能力验证案例(2026-09-05)

实际调用打开 example.com:

→ VIEW CASE STUDY
CASE STUDY

CRON SAFETY INTEGRATION

Wrap a scheduled Hermes task with maturity staging, state tracking, idempotency, compact errors, and hard stops.

→ VIEW CASE STUDY
CASE STUDY

DAILY NEWS DIGEST

Run a daily digest loop that collects candidate links, filters duplicates, drafts a concise summary,

→ VIEW CASE STUDY
CASE STUDY

实战案例S

本目录存放 Hermes Production Patterns 的真实落地案例。每个案例都遵循「先有真实运行,再有文档」——能复现的输出比描述更有说服力。

→ VIEW CASE STUDY
CASE STUDY

MAKER/CHECKER ARTICLE PIPELINE

Maker 写稿后,启动一个独立的 Agent 实例加载 maker-checker skill 做验证:

→ VIEW CASE STUDY
CASE STUDY

WECHAT ARTICLE PIPELINE

Use Hermes Agent to write, detect AI-taste, de-AI-fy, and publish WeChat Official Account articles.

→ VIEW CASE STUDY

ON-RAMP

CHOOSE YOUR PATH

按你的角色直接开始,30 秒找到第一个要读的 Pattern。

BEGINNER

I'M NEW TO AGENT ENGINEERING

推荐路线:

AUTOMATION BUILDER

I'M BUILDING AUTOMATION

推荐路线:

PRODUCTION ENGINEER

I'M BUILDING AUTONOMOUS AGENTS

推荐路线:

HOW READY IS YOUR AGENT?

PRODUCTION READINESS CHECK

回答四个问题,评估你的 Agent 的生产就绪程度。

01

Does your agent persist state across sessions?

START TODAY

BUILD AGENTS THAT SURVIVE PRODUCTION.

clone 仓库即可把全部 15 条公约装进你的 Hermes。