Программа курса Урок 230 из 250 · Проект: Исследовательский агент с использованием инструментов
Проект: Исследовательский агент с использованием инструментов

Реестр инструментов + Диспетчер

Любой «AI agent», о котором вы когда-либо читали, опирается на один неприметный компонент: tool registry. Модель выдает что-то вроде {"tool": "search", "args": {"query": "weather"}}, и your code должен найти правильную Python function, проверить, что аргументы корректны, запустить ее и вернуть результат. Если ошибиться в этом слое, весь агент может упасть в продакшене из-за одного неправильного аргумента. Этот первый урок проекта создает именно этот слой, и вы будете использовать эту идею в каждом последующем уроке.

Вы строите диспетчер для исследовательского агента. Ему нужны два инструмента для начала: search(query)который ищет фактcalc(op, a, b)и который делает арифметику. Реестр сопоставляет имя инструмента с парой: функцию и схему аргументов (набор имен аргументов, которые принимает инструмент). Диспетчер это ворота, через которые проходит всё.

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
        ...

Правила диспетчеризации должны обеспечивать(в этом и есть смысл упражнения):

  • unknown tool name -> raise KeyError. Агент запросил то, чего не существует.
  • Ключи args dict должны точно соответствовать зарегистрированной схеме. Если аргумент отсутствует или есть лишний -> raise ValueError. Это не дает галлюцинированному {"q": ...} (неверному ключу) просто ничего не делать.
  • валидный вызов -> запустить fn(**args) и вернуть то, что он возвращает.

Почему set для схемы? Потому что валидация тогда превращается в простое сравнение равенства: set(args) == self.tools[name]["args"]. Если это false, выясните, отсутствуют ли ключи или они лишние, и в любом случае выбросьте ValueError. Вызов с fn(**args) разворачивает dict в именованные аргументы, поэтому сигнатура функции выполняет финальную привязку.

Менеджер по найму

A, читающий "создал агента, использующего инструменты", на самом деле спрашивает: обработали ли вы негативный сценарий? Агент, который попадает в продакшн, это тот, чей dispatcher громко отказывается от плохих вызовов вместо того, чтобы портить выполнение. Нажмите Run, чтобы зарегистрировать два инструмента и увидеть, как хорошие вызовы проходят успешно, а плохие вызывают ошибки.

Твоя очередь

Создайте класс Registry. register(name, fn, args) хранит функцию и схему имен аргументов (используйте set). dispatch(name, args) должен: вызывать KeyError для неизвестного имени инструмента; вызывать ValueError если ключи args не совпадают со схемой точно (отсутствуют ИЛИ лишние); иначе вызывать fn(**args) и возвращать результат. Зарегистрируйте инструмент search(query) и инструмент calc(op, a, b) так, чтобы у диспетчера было что-то реальное для маршрутизации.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.