Аннотация

Аннотация: В статье рассматривается метод автоматического построения спецификаций, текстовой документации и кода программ-клиентов к недокументированным интерфейсам прикладного программирования (Application Programming Interface, API) на основе статического анализа кода серверной части вебприложений с применением больших языковых моделей (Large Language Models, LLM). Научная новизна работы состоит в формализации процесса трансляции абстрактного синтаксического дерева, построенного для кода серверного веб-приложения, в промежуточное представление (ПП) API с последующим обогащением ПП сгенерированными описаниями методов API с использованием подхода к обучению LLM по нескольким примерам (англ. few-shot). Предложенный метод позволяет автоматизировать генерацию документации и программного кода клиентов к API для веб-приложений, реализованных на высокоуровневых языках программирования со структурированными описаниями обработчиков методов API. Экспериментальная оценка метода была проведена с использованием трёх вебприложений с открытым исходным кодом, реализованных на языке Python, таких как: платформа «Цифровой ассистент преподавателя», предназначенная для автоматической генерации и проверки задач по программированию; API адресной книги, реализованный в соответствии с архитектурным стилем передачи состояния представления (Representational State Transfer, REST); API управления записями о свободном программном обеспечении (Free and Open Source Software, FOSS). Значение метрики среднего косинусного сходства результатов генерации текстовых описаний методов API с эталонными описаниями, сформированными экспертом, для удалённой LLM Nemotron-3-Nano-30B составило 0,92, для локальной LLM SmolLM2-1.7B – 0,76, что превышает результат, полученный при генерации описаний методов API на основе строковых шаблонов (0,34) на 0,58 и 0,42 соответственно. Полученные результаты показывают целесообразность использования предложенного метода для генерации спецификаций API, документации и программного кода клиентов к API при разработке интеграций с веб-приложениями, API которых являются недокументированными.