1. 从“指令执行”到“自主循环”：Agent运行范式的根本转变

在传统的自动化脚本或简单的任务编排工具中，我们习惯于一种“指令-响应”的线性思维：我发出一个命令，系统执行一个动作，然后结束。这种模式在处理确定性强、步骤固定的任务时非常高效。然而，当我们面对复杂、开放、需要动态决策的现实世界问题时，这种线性模式就捉襟见肘了。比如，让一个系统去“帮我规划一次完美的周末出游”，这就不再是一个简单的命令，而是一个需要感知信息（天气、交通、个人偏好）、制定计划（选择目的地、安排行程）、执行动作（查询、预订）、评估反馈（预算是否超支、时间是否合理）并可能随时调整的持续过程。

这就是Agent（智能体）概念的核心价值所在。它不再是一个被动的命令执行者，而是一个拥有一定自主性、能够与环境（包括用户、数据源、其他服务）持续交互并朝着目标推进的“虚拟执行者”。Harness Engineering，作为一个聚焦于如何有效构建、管理和驾驭这类智能体的工程实践领域，其核心挑战之一就是设计一个稳定、高效且可控的“运行时环境”。这个环境必须支撑Agent完成从单次响应到持续循环、从固定路径到动态路由、从孤立执行到丰富上下文感知的范式升级。

简单来说，Agent运行时机制就是智能体的“操作系统”或“中央神经系统”。它决定了Agent如何“思考”和“行动”。本次笔记将深入拆解这个核心系统的三大支柱：循环（Loop）、路由（Routing）和上下文（Context）。理解这三者，不仅是使用某个Agent框架（如Hermes Agent）的基础，更是设计任何具备持续交互与决策能力系统的关键。

2. 循环（Loop）：驱动Agent持续运作的引擎

循环是Agent运行时最基础、最直观的机制。它让Agent从一个“一次性函数”变成了一个“持续运行的服务”。但这里的循环远不止一个while True那么简单，它是一个有状态、有阶段、可中断、可观察的生命周期管理过程。

2.1 Agent循环的核心阶段：感知、思考、行动、评估

一个典型的Agent运行循环（如ReAct模式所归纳的）包含以下几个关键阶段，它们周而复始，推动任务前进：

1. 感知（Perceive）：Agent从环境中获取新的信息。这包括用户的输入、上一次行动执行后的结果（如API调用的返回数据）、定时触发的信号、或其他Agent发送的消息。在代码层面，这通常意味着从消息队列、事件总线或数据库轮询/订阅新事件。

2. 思考（Think）：基于当前获取的信息和内部状态，Agent决定下一步该做什么。这是Agent“智能”的集中体现。思考过程可能包括：

   • 目标分解：将复杂目标拆解为可执行的子任务。
   • 策略选择：在多个可行方案中评估并选择一个。
   • 工具调用决策：判断是否需要调用某个外部工具（如计算器、搜索引擎、代码执行器），以及调用哪个工具、传入什么参数。
   • 内容生成：决定如何组织语言来回复用户或生成下一步的指令。

   在现代基于大语言模型（LLM）的Agent中，“思考”往往通过精心设计的提示词（Prompt）来引导LLM生成结构化的“推理链”（Chain-of-Thought），其中明确包含对下一步行动的决策。

3. 行动（Act）：执行在“思考”阶段做出的决策。行动可以是：

   • 内部状态更新：修改Agent自己的记忆或任务状态。
   • 工具调用：执行一个函数，调用一个API，运行一段代码。
   • 对外输出：向用户发送一条消息，向另一个服务发送一个请求。
   • 创建子任务：将分解出的子任务派发给其他Agent或工作流。

4. 评估（Evaluate）：观察行动产生的结果，并判断当前循环的状态。评估需要回答几个问题：

   • 行动成功了吗？工具调用是否返回了预期结果？API返回了错误码还是成功数据？
   • 目标达成了吗？当前的结果是否已经满足了任务终止的条件？
   • 需要调整吗？结果是否偏离预期，是否需要重新规划或尝试替代方案？

评估的结果将直接反馈到下一个“感知”阶段，开启新一轮循环。这个“评估”环节是防止Agent陷入死循环或错误方向的关键安全阀。

2.2 循环的控制与中断：避免“鬼打墙”

一个无限运行的循环是危险的。我们必须为循环设计明确的终止条件和中断机制。

• 正常终止条件：

  • 任务完成：明确的目标已达成（例如，“预订成功”状态被设置）。
  • 用户取消：接收到用户的停止指令。
  • 条件满足：达到了预设的迭代次数（max_iterations=10）或时间限制（timeout=300s）。

• 异常中断与回退：

  • 行动失败：工具调用抛出异常、API返回致命错误。这时循环不能简单地继续，而应进入“异常处理”子流程，可能包括重试、更换工具、或向上级Agent/用户请求帮助。
  • 逻辑矛盾：Agent的推理出现了无法自洽的情况，或检测到可能的安全风险（如试图执行危险操作）。
  • 看门狗（Watchdog）：一个独立的监控进程，如果发现Agent长时间卡在某个状态或无意义重复，强制将其中断。

在Harness Engineering实践中，我们常常需要为Agent配置这些策略。例如，在Hermes Agent或类似框架的配置文件中，你可能会看到诸如max_turns,timeout_seconds,retry_policy等参数，它们正是用来精细控制循环行为的。

实操心得：在初期开发中，务必为每个Agent设置一个较小的max_iterations（比如5-10次）。这能有效防止因逻辑错误或外部服务故障导致的无限循环消耗资源。同时，实现详细的循环日志，记录每一轮的感知、思考、行动和评估内容，这是后期调试和优化不可或缺的。

2.3 循环的调度模式：同步与异步

根据任务场景，Agent循环可以以不同模式运行：

• 同步循环：适用于需要即时、连贯交互的场景，如聊天机器人。用户问一句，Agent思考并执行一系列步骤后回复一句，循环暂停等待下一句用户输入。这种模式下，循环的“感知”阶段主要由用户输入驱动。
• 异步循环：适用于后台任务、批处理或长期运行的任务。Agent被触发后，在其生命周期内自主运行多个循环，期间可能主动去查询数据库、轮询API状态，而不需要用户持续输入。任务完成后，通过回调或通知告知用户。

在设计Agent系统时，选择同步还是异步，决定了整个系统的架构和用户体验。

3. 路由（Routing）：构建Agent协作网络的智能交换机

单个Agent的能力是有限的。复杂的任务通常需要多个各有所长的Agent协同工作，或者需要将任务动态分配给最适合的专家型Agent。这时，“路由”机制就登场了。它就像网络中的路由器或公司的调度中心，负责指挥任务和信息的流向。

3.1 路由的两种核心模式：策略路由与约定式路由

• 策略路由（Policy-based Routing）：这是最灵活和强大的路由方式。一个中央的“路由Agent”或“路由层”根据一套预定义的策略（Policy）来决定将任务分发给谁。策略可以基于：

  • 任务内容：分析用户请求的意图和领域（是编程问题、数据分析还是创意写作？），然后路由给对应的专家Agent。
  • Agent状态：哪个Agent当前空闲？哪个Agent最近在处理类似任务，上下文更热？
  • 负载均衡：避免单个Agent过载。
  • 优先级：高优先级任务路由给性能更稳定、资源更充足的Agent实例。

  例如，一个客服系统中，用户输入“我的订单物流有问题”，路由层可以将其从通用客服Agent路由到专门的“物流查询Agent”。

• 约定式路由（Convention-based Routing / Fixed Routing）：这是一种更简单、静态的路由方式。任务流向在系统设计时就通过工作流（Workflow）或编排（Orchestration）工具固定下来。比如，一个订单处理流水线：订单接收Agent->库存检查Agent->支付处理Agent->物流创建Agent。每个Agent完成自己的工作后，按照约定将输出和任务状态传递给流水线中的下一个Agent。

  策略路由 vs. 约定式路由对比表：

  特性	策略路由	约定式路由
  灵活性	高，可动态决策	低，流程固定
  复杂度	高，需要智能路由决策逻辑	低，流程清晰直观
  适用场景	开放域问答、复杂问题分解、动态协作	业务流程自动化、步骤明确的流水线作业
  典型实现	专用路由Agent、基于LLM的意图分类	Apache Airflow DAG、LangChain Chain

3.2 路由决策的关键输入：意图识别与上下文摘要

路由要做出正确决策，离不开对两样东西的准确理解：

1. 意图识别（Intent Recognition）：当前的任务或消息到底属于哪一类？这通常是一个分类问题。可以用规则引擎（关键词匹配）、机器学习分类器，或者直接利用LLM的强大理解能力（通过Prompt让其判断任务领域）。准确的意图识别是高效路由的前提。

2. 上下文摘要（Context Summarization）：任务在传递时，不能把整个历史对话都扔给下一个Agent，那会很快耗尽上下文窗口并引入噪音。因此，在路由节点，需要对当前任务的历史和状态进行摘要，提取出对后续处理最关键的信息，形成一个精简的“任务简报”，随路由指令一起下发。这就是Claude Code的“上下文分层”或“压缩上下文”思想的应用。

3.3 路由失败与降级处理

路由不可能永远正确。必须考虑失败情况：

• 目标Agent不存在或不可用：就像热词中提到的“切换路由状态失败: codex 当前供应商不存在”。这时需要有降级策略，例如路由给一个通用的后备Agent，或者向用户返回明确的错误信息并请求澄清。
• 路由决策模糊：当意图识别置信度很低时，是猜测一个路由，还是直接向用户提问？通常，设置一个置信度阈值，低于阈值则进入“人工确认”或“澄清问询”流程是更稳妥的做法。

踩坑实录：在一次多Agent客服系统开发中，我们最初没有实现路由失败的回退机制。当某个专业技能Agent因部署问题宕机时，用户的特定问题请求会被静默丢弃，导致用户等待超时。后来我们引入了“熔断器”模式和通用后备Agent，一旦检测到目标Agent不可用，立即将请求路由给能处理一般性问题的后备Agent，并记录告警，用户体验和系统健壮性大幅提升。

4. 上下文（Context）：赋予Agent记忆与情境感知能力

如果说循环是引擎，路由是交通网，那么上下文就是Agent的“工作记忆”和“情境白板”。它是Agent在单次循环乃至整个任务生命周期中所能访问和利用的所有信息的集合。没有上下文，Agent就是“金鱼”，每个循环都是全新的开始，无法进行连贯的对话和复杂的多步任务。

4.1 上下文的层次与组成

Agent的上下文是一个多层次的结构：

1. 会话上下文（Conversation Context）：最直接的上下文，即当前对话的历史消息序列（用户输入、Agent回复）。这是维持对话连贯性的基础。大语言模型（LLM）的上下文窗口长度（如128K）直接限制了能保留多少历史消息。

2. 任务上下文（Task Context）：为完成当前特定任务而维护的状态和信息。这包括：

   • 任务目标：最初要做什么。
   • 已执行步骤：已经做了哪些操作，结果如何。
   • 中间结果：从工具调用、API返回中提取的关键数据。
   • 任务状态：进行中、暂停、成功、失败。

3. 长期记忆（Long-term Memory）：超越当前会话和任务的信息。这可能存储在向量数据库（用于语义搜索）、图数据库（用于存储关系）或传统数据库中。例如，Agent可以记住用户的偏好（“该用户喜欢用Markdown格式回复”），或者从过去的类似任务中学习经验。

4. 系统上下文（System Context）：关于Agent自身和运行环境的信息。例如：

   • Agent的身份与能力：我是谁？我会用什么工具？
   • 当前时间、日期。
   • 可访问的外部资源列表（如可用API端点）。

4.2 上下文的管理与优化挑战

管理上下文是Harness Engineering中的一大挑战，核心问题是如何在有限资源（主要是LLM的上下文窗口）内，放入最相关、最有价值的信息。

• 关键挑战：上下文窗口限制与信息过载即使是最新的LLM，其上下文窗口也是有限的。将整个对话历史、所有工具输出都塞进去，不仅会快速耗尽窗口，还会用大量无关信息干扰LLM的判断，导致性能下降（这种现象常被称为“上下文稀释”）。

• 解决方案：摘要、压缩与选择性注入

  1. 动态摘要（Dynamic Summarization）：不是保存所有原始消息，而是定期（或在上下文将满时）对之前的对话进行摘要，用一段简短的文字概括核心内容和决定，然后用摘要替换掉大段的原始历史。这就是“ClaudeCode压缩上下文命令”背后思想的体现。
  2. 选择性上下文加载（Selective Context Loading）：根据当前循环要处理的具体问题，从长期记忆或历史中，只检索与之最相关的片段注入上下文。这通常借助向量数据库的相似性搜索来实现。
  3. 分层上下文（Hierarchical Context）：像Claude Code那样，将上下文分为不同的层次或“频道”，例如“系统指令层”、“核心任务层”、“参考文档层”。在不同阶段，向LLM展示不同层次的上下文，减少干扰。
  4. 外部状态管理：将大量的、非核心的中间状态（如大型JSON数据、代码文件内容）存储在Agent外部（如数据库、文件系统），只在上下文中保留其引用或关键摘要。当需要时，再按需加载。

4.3 上下文在循环与路由中的流动

上下文是连接循环和路由的粘合剂。

• 在循环内部，上一个循环的“评估”结果和行动输出，会成为下一个循环“感知”阶段输入的一部分，从而在上下文中延续。
• 在路由过程中，当任务从一个Agent传递给另一个Agent时，必须将必要的任务上下文（经过摘要和压缩）一并传递过去，否则接收方Agent将无法理解任务的来龙去脉，相当于重新开始。

一个常见的反模式是，路由时只传递了用户的最新一句话，而丢失了之前所有的任务状态，导致协作断裂。因此，设计一个轻量、高效、可序列化的上下文传递协议，是多Agent系统设计的关键。

5. 实战推演：构建一个旅行规划Agent的运行时

让我们通过一个简化的“周末旅行规划Agent”例子，将循环、路由、上下文三者串联起来。

目标：用户说“我想这个周末去杭州玩，预算2000元，请帮我规划一下”。

系统设计：

• 主控Agent（Orchestrator）：负责总体协调，具备路由能力。
• 子Agent专家：信息收集Agent、行程规划Agent、预算评估Agent。

运行时推演：

1. 循环启动（感知）：主控Agent接收到用户请求。
2. 思考与路由决策：主控Agent分析意图，识别为“复杂任务-旅行规划”。它决定采用策略路由，先启动信息收集Agent。
   • 上下文传递：主控Agent将用户原始请求（目标、预算、时间）作为初始任务上下文，发送给信息收集Agent。
3. 子Agent循环1（信息收集）：
   • 感知：信息收集Agent收到任务上下文。
   • 思考：它决定需要查询杭州周末天气、热门景点、交通方式和酒店价格。
   • 行动：并发调用多个工具：天气API、旅游知识库搜索、交通查询API、酒店价格爬虫。
   • 评估：收集到所有数据，整理成一份结构化摘要（如：“周末晴，18-25度；西湖、灵隐寺热门；高铁票充裕，约150元；经济型酒店均价300/晚”）。
   • 循环结束/路由：将这份摘要和原始目标一起，作为更新后的任务上下文，返回给主控Agent。
4. 主控路由：主控Agent收到信息摘要，判断信息已齐备，于是将任务路由给行程规划Agent。
5. 子Agent循环2（行程规划）：
   • 感知：行程规划Agent收到目标、预算和收集到的信息摘要。
   • 思考：基于天数、兴趣点和预算，规划一个两日游行程草案。
   • 行动：利用LLM生成一个详细的日程安排（Day1上午西湖，下午灵隐寺...）。
   • 评估：生成初步计划。
   • 循环结束/路由：将行程草案加入上下文，返回主控。
6. 子Agent循环3（预算评估）：
   • 主控将行程草案和2000元预算目标路由给预算评估Agent。
   • 该Agent调用计算工具，累加交通、住宿、门票、餐饮的估算费用。
   • 发现总费用约为2200元，超出预算。它将此评估结果（“超支200元”）和修改建议（“建议将酒店标准降低或减少一顿大餐”）加入上下文返回。
7. 主控的最终循环：
   • 主控Agent接收到所有子Agent的结果。它发现预算评估未通过。
   • 思考：需要调整计划。它决定将“预算不足”的信息和原始上下文，再次路由给行程规划Agent，要求其重新规划。
   • 行程规划Agent在新的循环中，会接收到包含“上一版草案”和“超支警告”的上下文，从而在其思考过程中考虑成本约束，生成一个调整后的方案。
8. 循环终止：当新版计划经预算评估Agent审核通过后，主控Agent将最终行程和预算表汇总，输出给用户，任务完成，循环终止。

在整个过程中，循环驱动每个Agent一步步工作；路由由主控Agent根据任务阶段动态调度；而上下文像一份不断增补的“任务卷宗”，在所有参与方之间流转，确保了工作的连续性和一致性。

6. 避坑指南：运行时机制中的常见陷阱与调试技巧

即使理解了原理，在实际构建Agent系统时，依然会踩很多坑。以下是一些典型问题及应对思路：

• 陷阱一：Agent陷入死循环或无效循环

  • 现象：Agent反复执行相似操作，无法推进任务，或者在一个简单问题上循环多次。
  • 根因：
    1. 终止条件定义模糊或永远无法满足。
    2. 工具调用结果解析失败，导致评估阶段无法正确判断状态。
    3. LLM的思考（推理链）出现逻辑闭环，自己说服自己不断重复某个错误步骤。
  • 排查与解决：
    • 强化日志：在循环的每个阶段（感知、思考、行动、评估）输出详细的、结构化的日志，特别是思考阶段的完整推理链（Chain-of-Thought）。这是调试的黄金资料。
    • 设置硬性限制：务必设置max_iterations和timeout。
    • 引入外部验证：对于关键状态判断，除了依赖LLM的自我评估，可以引入一个简单的规则引擎或另一个轻量级Agent进行二次校验。

• 陷阱二：路由错误导致任务“迷路”

  • 现象：任务被分配给完全错误的Agent，或者在一个Agent组内来回传递没有进展。
  • 根因：
    1. 意图识别模型不准，或Prompt设计有缺陷。
    2. 路由策略有漏洞，未覆盖所有边界情况。
    3. 上下文在路由过程中丢失关键信息，导致接收方Agent无法理解任务。
  • 排查与解决：
    • 测试路由决策：构建一个包含各种边缘案例的测试集，单独测试路由层的决策输出，看是否符合预期。
    • 实施路由追踪：为每个任务生成唯一ID，并在每次路由时记录“由谁、在何时、基于什么上下文、路由给了谁”。这能清晰画出任务流转图谱。
    • 设计上下文快照：在路由发生前，对传递的上下文进行快照并记录。当接收方出现问题时，可以对比快照，检查信息是否完整传递。

• 陷阱三：上下文爆炸或信息丢失

  • 现象：LLM响应速度变慢、质量下降（上下文稀释），或者Agent“忘记”了之前重要的约定和结果。
  • 根因：
    1. 无节制地将所有历史信息灌入上下文。
    2. 摘要算法过于激进，丢失了关键细节。
    3. 不同Agent对上下文数据的格式理解不一致，导致解析失败。
  • 排查与解决：
    • 监控上下文长度：在每次调用LLM前，记录当前Prompt的Token数量，设置警报阈值。
    • A/B测试摘要策略：对比使用完整历史、使用摘要、使用选择性加载在不同任务上的效果，找到最佳平衡点。
    • 定义上下文Schema：为在Agent间传递的任务上下文定义一个清晰、版本化的数据结构（如使用Protobuf或JSON Schema）。这确保了信息能被正确序列化和反序列化。

构建稳定可靠的Agent运行时，本质上是在可控的自主性和系统的确定性之间寻找平衡。循环提供了自主推进的动力，路由提供了灵活协作的智慧，而上下文则是维系这一切的记忆纽带。理解并设计好这三者，你的智能体才能真正“活”起来，稳健地处理那些充满不确定性的复杂任务。这不仅仅是配置一个框架，更是一种全新的、关于如何构建具有持续交互能力软件系统的工程思维。