别被「上千行」吓到

很多人看 Agent 框架的源码，第一反应是「这也太复杂了」。catbuddy 的主要循环加上各种治理逻辑确实上千行。但我想告诉你一个让人安心的事实：

Agent Loop 的内核，真的只有十几行。说起来， 剩下那些行。全是在处理「理论上不该发生、天天发生」的边界情况。其实，

这一篇。我们先把那十几行的内核搭出来让它真的能跑、能连续调工具。理解了内核，后面所有的「治理逻辑」你才知道是加在哪、为什么加。

文件，接下来读一下 package.json 告诉我项目叫什么名字」。它能自己列目录、自己读文件、自己回答。

至于第一步先，能调工具的循环骨架

先把骨架立起来。 一个 Agent Loop 的内核就是——反复问模型，模型要工具就给它执行。直到它不要了

async function runAgent {
const messages =;while {
// ① 带着工具说明，问模型接下来干嘛
const res = await llm.chat;messages.push;// ② 模型不再要工具 → 它觉得活干完了退出
if {
return res.message.content;}
// ③ 模型要工具 → 逐个执行，把结果喂回去
for {
const result = await runTool;messages.push;}
// 回到 ①，带着新结果再问一次
}
}

就这么点。主要就是那个 while问 → 执行 → 把结果喂回去 → 再问。按理说，模型每次都能看到上一步的执行结果，于是它能基于结果决定接下来。这就是 Agent 会「自己推进」的全部秘密。

至于接下来。给它两把工具

const TOOLS =,},},];