内置工具集 工具与循环

Agent 随身携带的默认工具。原则:纯函数工具优先(`get_time`、`add`、`search` 这类可预测、无副作用、天然幂等),有副作用的危险工具慎入并要配权限层;注册时可挂可用性过滤(没配 key 的工具不发给模型)。

它是什么

内置工具集是 Agent 随身携带的默认工具。原则一句话:纯函数工具优先,有副作用的工具慎入get_timeaddsearch 这类读操作输出可预测、无副作用、天然幂等,是工具集的地基;文件读写、Shell 执行这类功能强,但每个都带副作用与安全隐患,属于危险工具,要配权限层(第 18 章)。

可用性过滤

不是每个工具都该出现在模型面前。注册时可挂可用性过滤(check_fn):比如「没配 SEARCH_API_KEY 就别把搜索工具发给模型」——模型根本看不到它就不会调它。这个检查在 list() 里做,加工具的人不用关心。把没有 key 的工具发给模型,只会诱导模型调用一个必失败的工具。

结果治理

搜索工具可能一次返回 50KB 结果,直接回填会烧穿上下文窗口。工具层约定「结果过大先截断再回填」(truncation),是第 09 章上下文工程的第一道闸门——在入口处拦一刀,比事后收拾便宜得多。内置工具集的注册与过滤完整实现见第 08 章

相关词条

出现在这些章节