Wiki 知识库

全部文档 / 标签: 状态管理

28 篇
清除

Harness Engineering: How to Build AI Agents That Actually Work

文章指出大多数人在错误的层面修复 AI Agent 问题:模型失败时反复改提示词、换模型、加工具,却忽略了真正的问题是模型周围的环境——Harness。Harness Engineering 是构建围绕模型的系统,决定模型能看到什么、能做什么、记住什么、如何判定成功与失败。作者提出六大实践:将请求转化为带完成条件的任务契约;用渐进式披露提供项目地图而非塞满上下文;在模型与工具之间设置网关校验与策略授权;将记忆(事实、决策、状态、经验)移出对话外部存储;以可观测证据作为任务完成的门槛,优先用确定性检查。好的 Harness 能提升每一次运行的质量。

技术 › Harness Engineering Mori 2026-10-2617.5 KB 853.6K 475 84

AI 长篇小说长期记忆方案盘点:5 个开源项目解决剧情失忆吃书问题

作者分享了在番茄小说用 AI 写长篇的实践经验,指出大上下文窗口并不等于剧情逻辑连续性,核心在于状态锁、角色知识边界和改稿后的级联更新。文章深入分析了 5 个 GitHub 开源方案:oh-story(Codex 深度写手,追踪提交协议)、MuMuAINovel(中文 Web 工作台,可视化记忆管理)、Ani Book Skill(本地 YAML 工程化方案)、ainovel-cli(Go 语言多 Agent 引擎)、Webnovel Writer v6(Claude Code 插件),各自说明核心机制与实操避坑点。最后给出三个测试标准:道具连续性、角色知识隔离、改稿级联冲突检测。

技术 › LLM Passenger0522 2026-10-066.4 KB 81

LoopX 1.2:会话会结束,工作不该结束

LoopX 1.2 正式发布,重点打磨个人工作区、长程状态与恢复能力,并推进多 Agent 团队的实验功能。新版本引入管家模式,可统一管理运行在 Codex、Claude Code 等执行器上的多个 LoopX Agent,提供独立设置入口和预览式配置。状态内核方面,Todo、lease、quota 等收敛到共享类型化边界,支持 Goal 验收合同、跨 Agent 任务接续与恢复。实验性能力包括团队计划与分工、受控 CLI/MCP 委派、产物复核与版本追溯。LHTB 基准测试显示平均 reward 提升 10.6%。文章最后致谢 40 位社区贡献者的 264 个已合并 PR。

技术 › Agent Ruiteng Huang 2026-09-258.8 KB 4.3K 19 78

Agent Harness 不是 while 循环:omp²《Harness Playbook》深度解读

本文深度解读 omp 作者 Can Bölük 的《Harness Playbook》,提出 Agent Harness 是系统软件而非简单循环的核心命题。文章系统阐述 omp² 的架构蓝图:以唯一权威会话(DOM 树)解决 rewind/fork/resume 的状态一致性;沙箱只执行不决策;Convar 管值、Director 栈管行为的控制面设计;将模型兼容性作为结构化知识的推理层;精简工具名册以提升性能的深度内建工具;基于 RichText 流原语与 TLA+ 验证的渲染层;以及 Rust 核心 + Python 扩展的技术栈选择。文章认为该文将 Harness 工程提升为可推理的学科,同时指出其激进设计尚待落地验证。

技术 › Harness Engineering meng shao 2026-09-0517.1 KB 44.5K 248 86

Agent 为什么也需要一套自己的 Git

随着 AI Agent 从聊天机器人演变为长期自我改进的系统,其 Memory、Skill、Script、定时任务和权限等状态不断变化且相互依赖,容易陷入不一致的"半升级"状态。文章提出 Agent 需要一套类 Git 的版本管理体系(Agent Native Git),让每次自我修改成为可查看、可审查、可回退的完整"升级包"。文中以 Hermes 的 Memory Tool 和 Skill Ledger 为案例,分析了现有实现的差距,并提出候选版本、变更记录、冲突检测、分层存储等四项关键能力,以及基于 libgit2、gix、Dulwich 等开源实现的技术方案。

技术 › Agent Yinsen 2026-08-3017.2 KB 5.3K 29 80

构建弹性生产级 Agent Harness 的 5 层架构

文章指出 Agent 可靠性的关键在于模型之外的确定性软件基础设施,即 Harness Engineering。作者提出构建弹性生产 harness 的 5 层方法:1)从模型优先转向系统优先架构,结构化工作流可将任务完成率从 31.7% 提升至 78.0%;2)实现持久化状态与检查点,避免长时间运行中丢失进度;3)通过角色分离(规划者、生成者、评估者)构建验证闭环;4)利用 hooks 和隔离运行时(如沙箱、网关)确保安全边界,防御提示注入;5)记录结构化追踪便于调试与自动化修复。文中结合 Google Antigravity、ADK 2.0、Gemini Enterprise 等工具给出实践建议。

技术 › Harness Engineering Google Cloud Tech 2026-08-298.7 KB 35.7K 263 81

从零开始,用 LangGraph 搭建你的第一个 AI Agent

本文是一篇面向初学者的 LangGraph 实战教程,介绍如何用 Python 从零搭建一个具备工具调用、推理决策和会话记忆能力的 AI Agent。文章首先讲解 LangGraph 的三个核心概念:State(状态/共享记忆)、Node(执行步骤)和 Edge(跳转逻辑),随后通过完整代码演示项目创建、工具定义、模型节点编写、条件路由实现、Graph 组装,以及通过 InMemorySaver 和 thread_id 实现多轮对话记忆。最终实现一个 ReAct 循环(思考→行动→观察→回答)的基础 Agent,并给出网页搜索、数据库查询、RAG 检索等扩展方向。

技术 › Agent Smartpig 2026-08-2815.0 KB 14.6K 131 77

DeepSeek Harness:把边界写成契约

本文深入解析了DeepSeek Harness的设计哲学,强调“事实有据,权限有度”的核心理念。文章通过多个实例展示了该框架如何将Agent状态管理、工具调用、子代理运行等关键环节转化为可验证的运行时契约,确保每个重要事实都有明确的拥有者,并通过原子比较、权限控制等机制避免状态不一致和越权操作。作者认为,DeepSeek Harness的精华在于其架构设计原则:为每种能力明确truth owner、authority gate、durable record、model projection和recovery rule,从而将隐性边界转化为可测试的契约。

技术 › Harness Engineering Dongxi 东锡 NLP 2026-08-164.9 KB 28.2K 40 71

From Prompt to Agent System With Kimi K3: the 9-step roadmap

本文详细介绍了如何从单个提示词构建一个完整的代理系统,以Kimi K3模型为例,通过9个步骤逐步实现:从基础API调用、输出约束、工具集成、循环机制、停止门控、状态管理、路由决策、答案验证到预算控制。文章强调,代理系统的核心在于围绕模型构建的框架,而非模型本身,并展示了如何通过代码实现这些组件,使系统能够自主决策、执行工具调用并验证结果。

技术 › Agent Alex 2026-08-1510.5 KB 46.8K 47 82

Grok Bot: How to build a self-improving system with Grok 4.6 in 10 steps

本文介绍如何利用Grok 4.6构建一个自我改进的Grok Bot系统,通过10个步骤实现长期运行和持续优化。系统核心是一个包含六个文件的工作区,包括验收标准、工人合约、验证者合约、可信状态、经验教训和提升者,形成一个闭环:工人生成候选结果,验证者独立检查,通过后提升者更新可信状态。文章详细说明了每个文件的编写方法、运行流程和失败处理规则,并提供了成本计算公式,旨在帮助读者构建一个可靠、可迭代的AI代理系统。

技术 › Agent GenAI 2026-08-1516.5 KB 16.5K 29 79

The $1.2M Agent Engineering skill is now open source. Here it is.

本文基于Anthropic对40万次真实编码会话的研究,揭示了高效使用AI代理的关键:人类负责规划,AI负责执行。文章指出,领域专家通过单一指令能获得更完整的任务结果,而代理的复杂任务完成能力每七个月翻倍。作者详细介绍了Anthropic开源的长期运行代理框架,包括Default-FAIL验证、独立评估器和会话间状态保存等核心设计,并对比了SWE-agent与Agentless方法,强调复杂性与任务匹配的重要性。最后,文章重新定义了工程师的角色:从编写代码转向设计代理环境、分解任务和验证结果。

技术 › Agent Sprytix 2026-08-1214.7 KB 450.5K 171 76

图工程:构建多智能体系统的完全指南

构建多智能体系统的核心挑战不在于提升单个智能体的能力,而在于如何协调工作流,这被称为“图工程”。文章指出,应将系统视为依赖图,区分真实依赖与虚假顺序,并引入结构化状态。同时强调要控制并行宽度以优化成本,关注关键路径以降低延迟。此外,建议在最终推理前使用代码进行确定性的数据压缩与归约,并采用非对称验证机制,从而打造高效、易调试的AI系统。

技术 › Agent Lunar 2026-08-0917.8 KB 2M 571 88

LangGraph 生产环境最佳实践

本文总结了将 LangGraph 智能体从原型推向生产环境的最佳实践。针对高并发、连接池耗尽等线上常见故障,文章提出了四大核心支柱:状态与检查点管理、系统可靠性(含重试与人类介入)、可观测性及部署扩展。作者详细解析了如何科学设计状态结构、正确选择 Postgres 检查点策略与线程隔离,并提供了避免无限工具循环、实现幂等性恢复的健壮代码模式,助力构建稳定可靠的线上系统。

技术 › Agent Vikas gupta 2026-08-0922.0 KB 8.5K 18 92

循环智能体的失效与图架构改造指南

作者分享了将单一的“循环”智能体重构为“图”架构的实战经验。文章指出,当生产输出的智能体同时负责自我评估时,会导致审核机制失效(橡皮图章)。为解决此问题,作者将任务拆分为研究员、作者和审核员三个独立节点,严格限制各节点对状态数据的读写权限,并引入条件路由进行质量把控。改造后,初稿通过率从45%提升至82.5%,有效提升了系统可靠性。

技术 › Agent Gipp 2026-08-0714.4 KB 235.1K 130 86

Graph Engineering: The Anthropic Method for Agent Self-Review

文章介绍了Anthropic工程师采用的“图工程”方法,通过将Agent控制从模型内部转移到图结构节点,解决了长任务中的状态丢失和漂移问题。文章详细阐述了如何构建评判器、编写规则书、测试规则及将状态存储在磁盘而非上下文窗口中,从而实现大规模代码迁移和自动化审查。

技术 › Agent Yarchi 2026-08-0615.5 KB 483.7K 326

AI Agent 连续运行 200+ 小时:LoopX 如何让长程执行不失忆、不漂移

文章介绍了开源项目 LoopX,一个面向超长程 Agent 的 control plane,实现了 Agent 连续运行 200+ 小时。LoopX 通过外置结构化状态、六层架构设计及可执行 Kanban 概念,解决了长程任务中的状态管理、权限控制、恢复机制等核心问题,确保 Agent 在无人干预或有人干预时均能稳定运行。

技术 › Agent Ruiteng Huang 2026-08-0335.0 KB 37.9K 153

上下文能塞 50 万 token,Agent 为什么还是记错中间结果?

文章探讨了即使大模型支持超长上下文窗口,Agent 在处理复杂任务时仍难以维护有效中间状态的问题。作者介绍了评测框架 ArbiGraph,该框架利用可执行任务图来测试模型的状态管理、依赖传递及抗干扰能力。实验表明,随着任务链路和分支复杂度的增加,模型准确率显著下降,强调上下文管理的核心在于维护可流动、可失效的计算状态,而非单纯扩容。

技术 › Agent 烟花老师 2026-08-0113.6 KB 4.1K 24

Run Your Harness Outside of the Sandbox (Why and How)

本文探讨了2026年以来关于Agent运行位置的争论,指出行业趋势是将Agent运行在沙箱之外。作者详细解释了沙箱内运行的三个主要问题:爆炸半径、信任边界和沙箱的间歇性运行,并提出了将沙箱作为工具暴露的正确架构,最后提供了基于Vercel AI SDK的实现示例和生产环境中的挑战。

技术 › Agent Nathan Flurry 2026-07-2816.4 KB 80.8K 433

Graph Engineering:从 0 到 1 小白完整教程

文章介绍了 Graph Engineering,一种通过流程图协调多个 AI 协作完成复杂任务的方法。它将复杂任务拆解为节点、边和状态,解决了单 Loop 应对复杂任务时的局限性。文章详细解析了 Graph 的核心概念、与 Loop 的关系、四个核心模块及具体实践模板,并提供了新手学习路径。

技术 › Agent Adrian Punk 2026-07-2716.0 KB 265.6K 688

Graph Engineering 101: When a Loop Isn’t Enough

文章探讨了AI Agent从简单的ReAct循环向图工程架构的演进。循环模式在处理复杂、多步骤及需人工介入的任务时存在状态持久化、错误处理和分支逻辑的局限性。图工程通过显式的节点、边和状态管理,解决了并发、暂停恢复及复杂流程控制问题,为构建更健壮的Agent系统提供了架构基础。

技术 › Agent Alex Prompter 2026-07-2247.4 KB 478.1K 369

如何使用 Claude Code 创建循环工作流

本文提出了一种通过“循环”机制优化 Claude 工作流的方法,旨在解决传统一次性会话在重复性任务中效率低下的问题。作者定义了包含触发、上下文、行动、验证、状态更新和决策的六步循环结构,并详解了由 TASK.md、PROGRESS.md、LOOP_INSTRUCTIONS.md 和 outputs 组成的四文件系统,以实现状态持久化和流程自动化。

技术 › Claude Code Rahul 2026-07-0737.2 KB 492.7K 271

长任务 Agent 的最小工程闭环

本文针对长任务 Agent 容易出现的“带不住状态、估不准工作量、评不好输出”三大问题,提出工程化的解决方案。文章通过引入状态层、规划层和验证层,构建了一个包含监督机制的五层架构,旨在通过外部控制和证据链,而非单纯的 Prompt 优化,来实现稳定、可落地的 Agent 系统。

技术 › Agent 烟花老师 2026-05-2630.3 KB 39.9K 313 91

ActiveGraph: 长期运行 Agent 的连续性架构层

文章作者 Yohei 提出了 ActiveGraph 的概念,旨在解决长期运行 AI Agent 的状态连续性问题。作者回顾了 BabyAGI 的发展历程,指出当前 Agent 系统主要围绕“反应”构建,缺乏持续的状态管理。ActiveGraph 试图将任务、记忆、决策、证据等所有状态视为一个共享的演化图,从而实现 Agent 的持久化、自我修正和逻辑追溯,适用于需要严格推理过程的企业级场景。

技术 › Agent Yohei 2026-05-209.6 KB 54.7K 151 68

Hermes 24小时工作的秘密:Cron、Gateway 和 Heartbeat

文章分析了基于 Hermes 的 Agent 无法实现长期自治的原因,指出问题不在于模型或提示词,而在于缺乏后台调度机制。作者详细介绍了实现 24 小时工作的四个核心组件:Gateway(后台闹钟)、Cron(定时唤醒)、Heartbeat(唤醒指令)和状态文件(上下文存储),并提供了具体的文件结构配置建议。

技术 › Hermes Bridge Wang 2026-05-189.0 KB 73.3K 536 92

Memory Is State, Not a Service

本文指出企业 AI 工具普遍存在“记忆碎片化”问题,主张构建“公司大脑”应将记忆视为共享状态而非独立服务。文章提出语义记忆文件系统架构,通过实体、事实、状态变化和关系存储,利用本体论作为透镜,让同一记忆在不同角色和 Agent 面前呈现不同上下文,从而解决信息孤岛,实现人机共享的可信赖记忆底座。

技术 › Agent Ashwin Gopinath 2026-05-0618.9 KB 43.2K 313 78

构建长时间运行 AI Agent 的 5 种设计模式

文章探讨了在构建需要持续运行数天甚至数周的 AI Agent 时所面临的挑战,并介绍了 Google Cloud Agent Runtime 支持的五种核心设计模式。这些模式包括:检查点与恢复以确保容错性、委托审批以实现人机协同、分层记忆架构以管理长期上下文、环境处理以应对无监督任务,以及针对多 Agent 协同的舰队编排。文章强调了状态管理、治理策略和基础设施在将 Agent 从演示转化为生产级系统中的重要性。

技术 › Agent Google Cloud Tech 2026-04-2322.0 KB 175.7K 1.3K 86