Function calling в OpenAI API: рабочий пример

Пошаговый практический гайд по использованию function calling в OpenAI API с реальными примерами на 2025 год. Выполнение от начальной установки до безопасного запуска — около 40–70 минут.

Что вы изучите

• Что такое function calling в OpenAI API и зачем он нужен.
• Как правильно описать функцию через JSON Schema и параметры метода.
• Практический пример: cURL, Python (openai 1.12.0, 2025-09) и Node.js (openai 4.2.0, 2025-08).
• Как надёжно обрабатывать ответы, логировать и отлаживать ошибки.
• Минимальные требования для локальной разработки и советы по деплою.

Требования

• ОС: Ubuntu 22.04 LTS или macOS 13+. Поддержка Docker: Docker Engine 24.0 (релиз 2024) для контейнеризации.
• Языки: Python 3.11 (релиз 2022), Node.js 20.x (релиз 2023). Рекомендуемый пакет OpenAI: Python openai 1.12.0 (2025-09), Node openai 4.2.0 (2025-08).
• ОЗУ: минимум 4 ГБ для разработки, 8 ГБ рекомендовано для параллельных запросов. CPU: 2 логических ядра минимум.
• Сеть: HTTPS доступ к api.openai.com, порт 443. Локальный dev-порт для отладки: 8080.

Что такое function calling?

Function calling — это механизм OpenAI API, который позволяет модели возвращать структурированные вызовы функций в ответ на пользовательский запрос. Вместо длинного текста модель может вернуть имя функции и параметры в соответствии с заранее описанным JSON Schema; затем приложение вызывает соответствующую локальную функцию и использует её результат для продолжения диалога. Это повышает детерминированность и интегрируемость LLM в сервисы с жёсткими контрактами.

Как описать функцию?

Функция описывается через JSON-схему и метаданные в запросе. Описание включает имя функции, краткое описание, список аргументов с типами и ограничениями. Примерная длина схемы — десятки строк; общая рекомендация — компактно и явно. Ниже — пример описания для создания события календаря, используемый в 2025 году с model gpt-4o-mini-2025.

{
  "name": "create_calendar_event",
  "description": "Создать событие в календаре пользователя",
  "parameters": {
    "type": "object",
    "properties": {
      "title": {"type": "string", "description": "Короткое название события\