Реестр инструментов + Диспетчер
Любой «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. Агент запросил то, чего не существует. - Ключи
argsdict должны точно соответствовать зарегистрированной схеме. Если аргумент отсутствует или есть лишний -> raiseValueError. Это не дает галлюцинированному{"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) так, чтобы у диспетчера было что-то реальное для маршрутизации.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.