Программа курса Урок 140 из 250 · Структурированные ответы и вызов функций/инструментов
Структурированные ответы и вызов функций/инструментов

Функция -> Схема инструмента (Интроспекция)

Tool calling (также известный как function calling) позволяет модели просить вашу программу запустить функцию: вы объявляете набор инструментов, модель отвечает названием инструмента и аргументами, и вы выполняете его. Но модель не видит ваш Python -> она видит только schema: описание имени и параметров каждого инструмента в формате JSON. Писать эти схемы вручную для каждой функции утомительно и они перестают соответствовать коду сразу после изменения сигнатуры. Решение это introspection: генерируйте схему прямо из функции.

Модуль inspect в Python читает сигнатуру функции во время выполнения. Схема, которую ожидают tool-calling API, выглядит так:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

Вы строите tool_schema(func), который выдает именно это. Две идеи делают всю работу:

  • Сопоставьте типы Python с типами JSON-schema. Прочитайте аннотацию каждого параметра и переведите: int -> "integer", float -> "number", str -> "string", bool -> "boolean". Все остальное по умолчанию сделайте "string".
  • Получите требуемое из значений по умолчанию. Параметр с без значения по умолчанию обязателен; параметр с значением по умолчанию необязателен. inspect.Parameter.empty это сигнал для "без значения по умолчанию".
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
    is_required = param.default is inspect.Parameter.empty
    json_type = ...   # from param.annotation

Используйте func.__name__ для названия инструмента. Соберите его так, чтобы две функции с разной аннотацией давали две явно разные схемы, параметр int отображался как "integer", а str как "string", параметр по умолчанию исключался из required, а параметр без значения по умолчанию в него попадал. Это контракт, на котором полагается каждая интеграция вызова инструментов.

Твоя очередь

Напишите tool_schema(func), который анализирует функцию с inspect.signature и возвращает {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Сопоставьте int->"integer", float->"number", str->"string", bool->"boolean" (по умолчанию "string") и добавьте параметр в required только если у него нет значения по умолчанию.

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

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

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