freeCodeCamp 长文:用 TypeScript 从零手写一个 AI Agent Harness
adnan_hashmi · x · 2026-10-22
freeCodeCamp 发布 Gabor Koos 的长篇教程,回答大多数 agent 教程回避的工程问题:工具调用失败怎么办、参数谁来校验、如何防止 agent 无限执行或耗尽上下文。答案是把这些问题交给 agent harness——位于模型与环境之间的软件层。
教程用 TypeScript 构建一个不依赖特定厂商的小型 harness(以编码 agent 为例),循序渐进覆盖:
- 基础执行循环,并演示如何在不接真实模型的情况下测试
- 工具调用校验:带显式契约的注册表,区分不同类型的错误
- 工作区隔离:文件操作限制在工作区内,让模型选择命令而非发明命令
- 执行预算:回合数与工具调用数分别计数,传播取消信号与超时
- 上下文管理:限制工具输出与面向模型的历史,不把工具调用与其结果拆开
- 可观测性:在执行边界发事件,如实统计模型用量
- 确定性失败测试:先校验模型响应再信任,把被拒的批次挡在转录之外,只测失败路径而非只测 happy path
适合想真正理解 agent 工程细节、而不只是跑通 demo 的开发者。
「编程与Agent」频道最新
- 5 个 AI agent 只管着 2 封邮箱,用户吐槽智能体过剩 — liuyuxxd · 2026-10-22
- 开源 huashu-motion：让 Claude Code 一键直出商业级产品宣传片 — AlchainHust · 2026-10-22
- Thinking Machines 推出 StableReinforce,解决 off-policy RL 突然崩溃 — LiTianleli · 2026-10-22
- phoneuse 给 AI Agent 配专属云手机:真 Android/iPhone 级操作新范式 — Rasmic · 2026-10-22
- 15 人团队 Keenable 登顶 Vals 网页搜索榜，超越融资 3.5 亿美元的 Exa — EXM7777 · 2026-10-22
- Rork 推出每月 1800 美元 Max 套餐，狂刷 Opus 额度 — rudrank · 2026-10-22