Гайд
Tool calling локально: схемы и валидация
Модель предлагает вызов, ваш код проверяет аргументы и только потом исполняет действие.
Дата30 сентября 2025 г.
ТемаАгенты
Уровеньсредний
Чтение13 мин
Инструмент — это контракт: имя, JSON Schema аргументов, описание, побочные эффекты. Чем яснее схема, тем меньше фантазий у модели.
Никогда не исполняйте сырой вызов без валидации. Проверяйте типы, пути файлов, разрешённые домены, лимиты длины. Локальность не отменяет риск rm -rf в домашней папке.
Возвращайте инструменту структурированный результат: код ошибки, краткий stdout, путь. Модель лучше планирует следующий шаг, когда ответ предсказуем.
Логируйте каждый вызов. Агентные баги почти всегда находятся в истории «что модель хотела» против «что среда сделала».