课程大纲 第 230 课,共 250 课 · 项目:会用工具的研究智能体
项目:会用工具的研究智能体

工具注册表 + 分派器

你读到过的每一个"AI 智能体",归根到底都落在一个平淡无奇的组件上:工具注册表。模型发出像 {"tool": "search", "args": {"query": "weather"}} 这样的东西,然后你的代码必须找到正确的 Python 函数,检查参数是否合理,运行它,再把结果交回去。这一层做错了,整个智能体在生产环境里离崩溃就只差一个格式错误的参数。项目的第一课构建的正是这一层,之后的每一课你都会复用这个想法。

你在为一个研究智能体构建分派器。它一开始需要两个工具:一个查找事实的 search(query),和一个做算术的 calc(op, a, b)。注册表把一个工具名映射到一对东西:函数,以及一个参数 schema(这个工具接受的参数名的集合)。分派是所有东西都要经过的关口。

class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

分派必须执行的规则(这就是这个练习的全部意义):

  • 未知的工具名 -> 抛出 KeyError。智能体要了一个不存在的东西。
  • args 字典的键必须与注册的 schema 完全一致。缺少一个参数或多出一个参数 -> 抛出 ValueError。正是这一点阻止了一个幻想出来的 {"q": ...}(错误的键)悄悄地什么也不做。
  • 有效的调用 -> 运行 fn(**args) 并返回它返回的东西。

为什么 schema 要用 set?因为这样验证就只是集合相等:set(args) == self.tools[name]["args"]。如果为假,就弄清楚是缺了键还是多了键,无论哪种都抛出 ValueError。用 fn(**args) 调用会把字典展开成关键字参数,所以由函数签名完成最后的绑定。

读到"构建了一个会用工具的智能体"的招聘经理,真正想问的是:你处理了不顺利的情况吗?能上线的智能体,是那个分派器会大声拒绝坏调用、而不是把一次运行搞乱的智能体。按 Run 注册两个工具,看好的调用成功,坏的调用抛出异常。

轮到你了

构建一个 Registry 类。register(name, fn, args) 保存函数和它的参数名 schema(用 set)。dispatch(name, args) 必须:对未知的工具名抛出 KeyError;如果 args 的键与 schema 不完全一致(缺少或多出),就抛出 ValueError;否则调用 fn(**args) 并返回结果。注册一个 search(query) 和一个 calc(op, a, b) 工具,让分派器有真东西可以路由。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。