hello-agents，Agent 设计原理拆解

01反共识：会调函数不等于 Agent

很多人给模型接个 function calling 就叫"Agent"。不是。那是"会调函数的聊天机器人"。

真 Agent 的标志是自主循环：它自己决定下一步做什么、调用什么工具、看结果后决定继续还是停止——不需要人每步指挥。会调函数只是"工具调用"，缺循环、记忆、控制，就不是自主的。

hello-agents 把 Agent 拆成 5 个组件，每个都有不可替代的作用：

• 模型：大脑，负责推理和决策。决定 Agent 的能力上限。
• 工具：手脚，让 Agent 能行动（搜索、代码、API）。决定能干什么。
• 记忆：上下文，短期（本轮对话）+ 长期（跨会话）。决定能记住多少。
• 循环：想-做-看的 ReAct 循环。决定是否自主。
• 控制：何时停、何时问人、何时回退。决定是否安全可控。

少任何一个都退化：没工具是聊天机器人，没循环是单轮问答，没记忆是金鱼脑，没控制是失控 Agent。

02Agent 拆解图：点组件看作用

点每个组件，看它在 Agent 里干什么、为什么不可少。

03设计 Agent 的三个关键决策

• 工具粒度：工具太粗（一个"操作数据库"工具）模型难选参，太细（每个表一个工具）工具数爆炸难路由。粒度按"一个完整动作"切，配工具描述让模型能选对。
• 记忆策略：短期记忆塞满会变笨，要摘要/淘汰旧上下文；长期记忆要可检索（向量库），不是全塞进去。记忆管理是 Agent 稳定的关键。
• 控制边界：定义何时停（达成目标/超步数）、何时问人（不确定/高风险）、何时回退（连续失败）。没有边界的 Agent 会无限循环或闯祸。

一个常见坑：只堆工具不设控制，Agent 调了一堆工具却不知道停，token 烧光还没结果。先定控制边界再堆工具，能停的 Agent 才是好 Agent。

04带走这套设计清单