Как настроить function calling в YandexGPT через tools и JSON Schema

"tools":[{
 "function":{
  "name":"weatherTool",
  "description":"Возвращает прогноз для указанного города",
  "parameters":{
   "type":"object",
   "properties":{
    "city":{"type":"string"},
    "days":{"type":"integer","minimum":1,"maximum":5},
    "units":{"type":"string","enum":["metric","imperial"]}
   },
   "required":["city"]
  }
 }
}]

• required определяет обязательные аргументы; minimum/maximum и enum ограничивают базовые значения.
• Наличие tools не заставляет модель вызывать функцию: она может сразу вернуть текст.
• ToolCallList является предложением вызова, не доказательством безопасности операции.
• Результат отправляется как ToolResultList, после чего модель формирует финальный ответ.

Порядок действий

1. Опишите функцию так, чтобы назначение не пересекалось с другими инструментами.
2. Разберите ToolCallList и проверьте JSON Schema на сервере.
3. Примените авторизацию, allowlist городов/объектов и таймаут.
4. Верните точный результат либо структурированную ошибку через ToolResultList.
5. Сравните финальный текст с фактическими данными инструмента.

Как проверить результат

Запросите 3 дня, затем 100 дней: второй аргумент должен быть отклонён диапазоном или backend. Попробуйте инструмент изменения с чужим объектом — авторизация обязана сработать после схемы.

Ограничения

По документации вызовы функций доступны не для всех моделей; официально перечислены поддерживаемые варианты, включая YandexGPT Pro в соответствующем API. Матрица может меняться.

Чего не делать

• Не запускайте произвольную команду из аргументов.
• Не считайте enum проверкой прав.
• Не скрывайте ошибку функции выдуманным успехом.

Частые вопросы