Функция -> Схема инструмента (Интроспекция)
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 только если у него нет значения по умолчанию.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.