Cover of Agent Harnesses, edition 2026.11.2, code ZZGV-NEGC Agent Harnesses ZZGV-NEGC 2 editions since Nov 2026 Rolling Edition 2026.11.2

智能体运行框架

版次 2026.11.2 示例于 2026年11月20日 通过 64个示例中有64个通过 变化内容

AI 翻译。由人工以英文核验。 我们如何制作图书

译自英文版图书,版次 2026.11.2。 阅读原文

围绕模型构建代码,打造一个可以放心让其使用真实工具的智能体:循环、工具、上下文、权限、沙箱、子智能体和测试,并以一个面向小型 Python 库的维护智能体为例。

适合谁 本书写给这样的工程师:你已调用过模型的 API,也做过演示用的智能体,现在必须做出一个能在真实工具上运行、无需有人逐步盯守的智能体。你会用 Python 编写代码,了解 JSON 和 HTTP。无需具备模型内部原理或 MCP 方面的背景知识。

开始阅读
版次历史自 2026年十一月 以来的 2个版次每个版次及其变更内容
2026.11.12026.11.2
2026.11.2 · 2026年11月20日库更新文本未更改,针对新版本的 5个示例

目录

12章,阅读约需 7小时 53分钟,包含 64个示例。

  1. 1为模型配上工具和循环

    读完本章,你可以让模型在一个循环中运行,并为它提供三个工具:一个读取文件,一个运行测试,一个以修改后的文件结束任务。

  2. 2在任务完成或陷入停滞时停止循环

    读完本章,你应当能够根据测试框架为每次运行记录的那一个词,说明这次运行为何停止,并能添加两条规则,用来结束已经不再取得进展的运行。

  3. 3给模型一套无法误用的工具

    读完本章,你将能够为模型提供一套工具:在任何工具运行之前,由运行框架(harness)先检查其参数;你还将能够写出模型可以据以行动的拒绝信息。

  4. 4脚本化、回放、本地与托管模型的统一接口

    读完本章,你将能在脚本化模型、回放的运行记录、本地模型和兼容 OpenAI 的端点上运行同一个循环,而无需改动循环本身。

  5. 5在任务增长时保持上下文有用

    读完本章,你将能够计算一次运行的提示词还剩多少空间,在运行框架无法精确计数时估算提示词的大小,并在压缩一次运行较早的步骤时,不把工具调用与其结果拆开。

  6. 6为会修改内容的工具设置关卡

    学完本章,你将能够把智能体的改动保留在它自己的副本中,直到有人表示同意;能够检查这个同意是否覆盖了对方所读到的那一处确切改动;还能把一次拒绝作为运行终止的原因交还给智能体。

  7. 7在沙箱中运行智能体的代码,并让机密不进入它的视野

    学完本章,你可以为智能体运行一条命令,并为它设置时间限制、按进程计的内存上限、CPU 上限和文件大小上限,使用由允许列表构建的环境,并以一份临时副本作为它的工作目录。

  8. 8把子任务交给子循环,再交回一次停止

    读完本章,你可以把一个子任务交给拥有独立步数预算的子循环,并得到一份摘要和一个停止原因,而不是子循环的完整记录。

  9. 9将运行框架连接到 MCP 服务器

    读完本章,你将能够把测试框架连接到由他人运行的 MCP 服务器,以不会与框架自带工具名称冲突的名称查看每个服务器的工具,并让对其中任何一个工具的每次调用都经过审批关卡。

  10. 10测试智能体,再用任务集衡量它

    学完本章,你可以用预先写好的回复脚本测试智能体的运行框架,用统一的“完成”标准在任务集上给智能体打分,并给出带有范围的计数。

  11. 11追踪每次运行并统计其开销

    读完本章,你应当能够让每次运行为每一步写下一条记录,并保存到后续读者可以解析的文件中;为每条记录赋予 ID,把它与所属的运行和具体的调用关联起来;并能以词元数说明一次运行的开销。

  12. 12当智能体是错误的设计时

    读完本章,你可以将本案例中的任意一项任务归入固定流水线、单次模型调用或带关卡的智能体三类之一,并说明记录下来的运行结果对该任务显示了什么。

引用本节

格式

每种格式均引用英文原书,本译本以其为准。

每种格式都会注明该版次。其链接会打开当前版次,节标题处会说明该节文本最后一次修改的时间。访问日期和检索日期即为您打开此页的当天。