OpenAI 智能体工程指南:实战技巧与构建模式
文章解读了 OpenAI 官方关于智能体工程的实战指南,详细介绍了构建长期稳定 Agent 的三个核心要素:技能、Shell 工具和上下文压缩。文中结合 Glean 等企业的生产数据,提供了 10 条关键实战技巧(如技能描述即决策边界、负面示例防误触等)及三种从简单到高级的构建模式,旨在解决系统提示词膨胀和工具调用准确性问题。
文章解读了 OpenAI 官方关于智能体工程的实战指南,详细介绍了构建长期稳定 Agent 的三个核心要素:技能、Shell 工具和上下文压缩。文中结合 Glean 等企业的生产数据,提供了 10 条关键实战技巧(如技能描述即决策边界、负面示例防误触等)及三种从简单到高级的构建模式,旨在解决系统提示词膨胀和工具调用准确性问题。
文章结构清晰、落地性极强,系统介绍了基于Skills、Shell和Compaction构建Agent的10条实战技巧与3种模式,且对2026年的最新技术生态具备高度时效性。
本文深入解析Agent工程中常被混淆的三个架构层级:Harness工程构建模型运行环境与基础能力;Loop工程设计工作反馈循环,通过验证与迭代提升质量;Graph工程则显式定义工作流拓扑,控制节点分支与状态转换。文章强调理清环境、反馈与流的关系对构建生产级Agent至关重要。
本文深入探讨了 Agent Harness 的概念,即包裹在 LLM 外部、将无状态模型转化为可用智能体的完整软件基础设施。文章引用了 Anthropic、OpenAI 和 LangChain 的实践,详细拆解了生产级 Harness 的 12 个核心组件(如编排循环、记忆系统、上下文管理、验证循环等),并阐述了如何通过优化这层“操作系统”来解决遗忘、工具调用失败和上下文腐烂等工程难题。
本文旨在探讨如何像管理代码一样管理 Claude Code 的配置目录 .claude/。文章首先指出了混乱的目录结构会随着项目增长导致维护困难,随后提出了一套包含 CLAUDE.md、settings.json、rules/、hooks/、commands/、skills/ 和 agents/ 的标准化目录蓝图。接着,文章详细阐述了核心原则,包括顶层设计的轻重分离、规则模块化、自动化脚本与复用工作流的区别,以及团队与个人配置的边界。最后提供了从简单到复杂的渐进式成长路径,帮助开发者构建可预测、可维护且易于团队协作的 AI 辅助开发环境。
本文指出构建 AI 产品的核心不在于选择模型,而在于架构设计。作者分享了 10 个实用经验,强调从工作流而非模型入手、重视检索优于微调、将提示工程视为系统工程、关注延迟优化、为智能体设置护栏、妥善处理记忆、建立评估管道以及优化成本。最终,多智能体系统将是未来趋势。
文章介绍如何在OpenAI发布Dots常驻Agent和GPT-6 Astra(百万token记忆)后,搭建一个24/7自主运行的AI工作流。核心难题是常驻Agent会高频产生大量简单决策,用前沿模型成本高昂。解决方案是TypeSafe推出的System One模型Jev:它只能输出结构化决策(是/否、选择、评分)并附带置信度,单价仅$0.042/百万token,使百万次决策成本约$42。文章展示了将Jev作为低层决策器、Astra作为高阶思考引擎的组合架构,让独立开发者从写代码转变为定义任务、设限并审核产出的监督者角色。
本文介绍 2026 年构建多模型 AI Agent 团队的完整方法。作者指出使用单一模型会导致高成本低效、专业能力受限以及单供应商故障/盲点风险,主张按任务步骤选择合适模型。文章梳理了 2026 年 9 月的主流模型阵容(Claude Opus/Sonnet/Haiku/Fable 5.1、GPT-6 Astra、TypeSafe Jev)及定价,提出五层架构:路由器、编排器、专家模型、评审者(critic)和纯代码层,并讲解如何先对工作负载分类(决策、简单生成、真实工作、难题),再为每层选择最划算的模型。文中附有统一封装多供应商 API 的示例代码,涵盖 effort 参数与 thinking block 处理细节。
作者总结了 AI 开发中四个关键的二元选择:一是优先使用现成的开源能力(skill)而非从零开发,通过 GitHub star 数判断成熟度;二是 OpenClaw(龙虾)适合已搭好管道的日常自动化(BAU),而搭建复杂系统应使用 Claude Code、Codex、Jules 等开发工具;三是多 agent 并非越多越好,应先单 agent,确实不够用再逐个增加,复杂度是敌人;四是确定性逻辑用脚本执行,大模型只用于需要判断的环节,高风险决策需人工审批,最终形成脚本+大模型+human approval gate 的结构。正确选择可节省大量时间。
本文深度拆解 Lauren 的 pstack 第二篇,探讨如何让 AI Coding Agent 在写代码前正确理解问题。文章介绍了 /how、/why、/teach、/recall 等上下文工具的用法,强调用代码而非文档来规划:先写使用教程倒推架构,通过低成本原型比较不同方案,用 /architect 让多模型并行设计并交叉评审,以及在多阶段计划中要求每一步都以可复查的证据结束。作者认为,Agent 可能比人更快更强,但最终是否接受方案仍需人来判断,验证应从开发前就开始参与决策。
OpenAI初创团队Applied AI负责人Wulfie Bain指出,即使是顶级AI创业公司,其提示词也普遍存在矛盾与歧义。核心原因在于提示词的演进是增量式的:只加不删,无人端到端审查,导致“意面式”提示词;而工程师依赖隐式知识解读提示词,忽略了模型缺乏这些背景。作者主张将提示词视为产品决策和代码来对待——结构化、模块化、可维护(MECE原则)。通过重构提示词,多家创业公司实现了提速50%、留存提升40%、成本降低30%的效果。
Anthropic开源了此前为商家打造的Claude购物AI助手(Commerce Agents),提供购物Agent和商家Agent两套完整可运行实现,覆盖零售、旅游、电信、票务四个行业,包含代码、技能、工具契约和安全门禁。文章总结了核心经验:用一个聪明大脑搭配一摞skills而非拆分多个小AI,系统提示词放高频逻辑、技能放长尾功能;智能体应调用企业已有引擎而非自行计算;将UI定义为工具调用输出结构化参数;优化延迟与缓存命中率;用户偏好存数据库而非模型;涉及钱的操作必须人工审批,并辅以自动化测试。