Библиотека для работы с OpenAI API в 1С и OneScript (open-source)

Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Тем, кто уже знаком с ОПИ, данный раздел можно пропустить.

OpenAI - одна из первых и самых знаменитых компаний в сфере искусственного интеллекта. Наиболее известна она своими языковыми моделями, такими как GPT-3 и GPT-4, которые предоставляются через облачный API и используются для генерации текста, анализа данных, автоматизации задач и многого другого

Но для нас более важен тот факт, что OpenAI API изначально стал де-факто стандартом в интеграции с языковыми моделями искусственного интеллекта. Его формат запросов, методы и структура ответов легли в основу множества других решений - как облачных, так и локальных.

Сегодня есть куча сервисов и платформ, в той или иной мере обеспечивающих поддержку этого стандарта: как больших и общемировых, вроде Ollama, LocalAI, LM Studio, Jina AI, так и локальных, начиная с YandexGPT, заканчивая сервисами "все нейросети мира за 200 рублей в месяц", как то Vsegpt, BotHub и др.

Ну а теперь методы для работы с этим API есть и в Открытом пакете интеграций! Не все, конечно, а лишь часть из них: доступа к оригинальному OpenAI Platform нет, а сторонние сервисы предоставляют, как они говорят, "частичную", а на самом деле - минимальную и очень ленивую интерпретацию OpenAI API лишь с парой базовых методов

Но имеем то, что имеем: при разработке использовался LocalAI (открытое self-hosted решение), где набор функций был чуть больше, чем у других, и позволил реализовать следующие готовые методы:
 

• Методы обработки запросов
  • Получение ответа по списку сообщений
  • Генерация картинок
  • Получение представлений (embeddings)
• Методы управления ассистентами
  • Получение списка ассистентов
  • Создание ассистента
  • Получение ассистента
  • Удаление ассистента
• Методы работы с файлами
  • Получение списка файлов
  • Загрузка файлов на сервер
  • Получение информации о файле
  • Скачивание файла
  • Удаление файла
• Методы работы с аудио
  • Генерация речи
  • Создание транскрипции по аудиофайлу
• Работа с моделями
  • Получение списка моделей

Теперь все эти функции доступны и в 1С (а также OneScript и CLI). Несколько примеров кода их использования (более подробную информацию можно найти в онлайн документации):

    URL   = "https://api.athenaeum.digital:1122/";
    Токен = "sk-or-vv-c5884ebe9f13fb143194bb07ecb...";

    // Текстовые сообщения

    Сообщения = Новый Массив;
    Сообщения.Добавить(OPI_OpenAI.ПолучитьСтруктуруСообщения("user"     , "What is 1C:Enterprise?"));
    Сообщения.Добавить(OPI_OpenAI.ПолучитьСтруктуруСообщения("assistant", "1C:Enterprise is a full-stack, low-code platform"));
    Сообщения.Добавить(OPI_OpenAI.ПолучитьСтруктуруСообщения("user"     , "When the first version was released?"));

    Модель = "smolvlm-256m-instruct";

    Результат = OPI_OpenAI.ПолучитьОтвет(URL, Токен, Модель, Сообщения);

    // Картинки

    Модель     = "moondream2-20250414";
    Файл       = "C:\picture.png"; // URL, Путь или Двоичные данные
    ИмяФайла   = "pic.png";
    Назначение = "user_data";

    Сообщения = Новый Массив;

    ЗагрузкаКартинки = OPI_OpenAI.ЗагрузитьФайл(URL, Токен, ИмяФайла, Файл, Назначение);
    IDКартинки       = ЗагрузкаКартинки["id"];

    Описание = OPI_OpenAI.ПолучитьСтруктуруСообщенияКартинки("user", IDКартинки, "What is in this image?");

    Сообщения.Добавить(Описание);

    Результат = OPI_OpenAI.ПолучитьОтвет(URL, Токен, Модель, Сообщения);

    URL   = "https://api.athenaeum.digital:1122/";
    Токен = "sk-or-vv-c5884ebe9f13fb143194bb07ecb...";

    Текст  = "Attack ships on fire off the shoulder of Orion bright as magnesium";
    Модель = "tts-1";

    ДопПараметры = Новый Структура("response_format", "wav");

    Результат = OPI_OpenAI.СгенерироватьРечь(URL, Токен, Модель, Текст, , ДопПараметры);

    URL   = "https://bothub.chat/api/v2/openai/";
    Токен = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUzYTUwNWFiLTdhYmEtNDkyNy05YmQ0LTZlNDFlZGEyZGRmYyIsImlzRGV2Z...";

    Модель    = "dall-e-3";
    Описание  = OPI_OpenAI.ПолучитьСтруктуруОписанияКартинок("Yellow alpaca", 1, , "1024x1024");
    Результат = OPI_OpenAI.ПолучитьКартинки(URL, Токен, Модель, Описание);

Кроме ввода совершенно новых функция для работы с OpenAI, получили обновления и несколько уже существующих до этого библиотек Открытого пакета интеграций:

• Библиотеки PostgreSQL, MySQL, SQLite: были реализованы методы добавления и удаления колонок существующих таблиц
• Библиотека PostgreSQL: формат получения даты из SELECT запросов был изменен на ISO 8601
• HTTP-клиент: была добавлена функция для установки таймаута соединение 

Это все, что я хотел рассказать про сегодняшнее обновление ОПИ, однако хочу украсть еще немного вашего времени и зацепить обновление другого, очень важного для Открытого пакета интеграций, проекта, который также претерпел ряд изменений...

Melezh

Melezh - это серверное приложение Открытого пакета интеграций, предоставляющее единый настраиваемый HTTP API для доступа к любым его библиотекам с возможностью установки значений по умолчанию, веб-консолью и встроенным логированием входящих запросов

Основная статья | GitHub | Документация

Кроме ОПИ также обновился и Melezh - недавно вышедший проект на основе Открытого пакета интеграций, о котором я рассказывал в предыдущей статье. В новой версии была добавлена возможность указания базового пути для более удобного проксирования на некорневом URL, возможность указания дополнительного каталога пользовательских расширений вне каталога самого Melezh, а также реализована новая панель для этих расширений в веб-интерфейсе

Как и все остальные библиотеки ОПИ, библиотека для работы с OpenAI доступна в Melezh с первого дня! Я буду очень рад, если вы попробуете использовать этот проект в своей работе (он кроссплатформенный, доступны установщики и пакеты для Winodws и Linux, а также Docker-образы). Мне он кажется достаточно классным, но пока ему катастрофически не хватает активных пользователей и обратной связи

Все это звучит довольно сумбурно, но, если анонс смог вас заинтересовать, то узнать больше можно в онлайн документации или основной статье о Melezh на Инфостарт, которые доступны по ссылкам выше. Ну, а пока это все! 

Спасибо за внимание!

 Если вам нравится ОПИ, то не забывайте поддерживать его на GitHub и Инфостарт!

Репозиторий ОПИ: github.com/Bayselonarrend/OpenIntegrations

Последний релиз: github.com/Bayselonarrend/OpenIntegrations/releases/latest

Другие статьи про Открытый пакет интеграций на Инфостарт:

• Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter

• Работа с Notion API | Обновление Открытого пакета интеграций

• Библиотека работы с Яндекс Диском (Open-source) 

• Открываем свою лавку на платформе VK Market

• Библиотека для работы с Google Calendar API (open-source) 

• Telegram в режиме форума: делаем чаты комфортными

• Открытый пакет интеграций для OneScript

• Библиотека для работы с Google Drive API (open-source)

• OInt CLI - приложение Открытого пакета интеграций для командной строки

• Библиотека для работы с Google Sheets (open-source)

• Библиотека для работы со Slack (open-source)

• Библиотека для работы с Airtable (open-source)

• Библиотека для работы с Bitrix24: живая лента, задачи, файлы и личные сообщения

 

 Мой GitHub:    https://gitub.com/Bayselonarrend 
 OpenYellow:    https://openyellow.org
 Лицензия MIT:  https://mit-license.org