Библиотека для интеграции с GigaChat

Активность выполняет аутентификацию в API GigaChat для получения временного токена доступа с защищенным хранением учетных данных.

Основные возможности:

• Получение OAuth-токена для доступа к API GigaChat
• Поддержка трех вариантов авторизации (персональная, B2B, корпоративная)
• Безопасное хранение Client Secret и Access Token в SecureString

Получить остаток токенов GigaChat

Активность предоставляет информацию о доступном балансе токенов для выбранной модели GigaChat через защищенное API-соединение.

Основные возможности:

• Получение актуального остатка токенов для конкретной модели
• Поддержка моделей: GigaChat-Pro, GigaChat-Max, GigaChat
• Безопасная передача Access Token через SecureString

Подсчитать количество токенов в запросе GigaChat

Активность выполняет точный расчет количества токенов для текстовых запросов к API GigaChat, что позволяет контролировать расход токенов и оптимизировать запросы.

Основные возможности:

• Подсчет токенов для списка текстовых строк
• Поддержка моделей: GigaChat-Pro, GigaChat-Max, GigaChat
• Возврат суммарного количества токенов и символов

Загрузить файл GigaChat

Активность выполняет загрузку файлов в хранилище GigaChat через API с использованием токена доступа. Возвращает идентификатор файла для генерации запросов и данные ответа сервиса.

Основные возможности:

• Загрузка текстовых документов и изображений (поддерживаемые форматы: .txt, .doc, .docx, .pdf, .epub, .ppt, .pptx, .png, .jpg, .tiff, .bmp).
• Автоматическое определение MIME-типа файла на основе расширения.
• Использование защищенного Access Token и Client ID для авторизации запроса.
• Ограничения по размеру: текстовые файлы — до 40 МБ, изображения — до 15 МБ.
• Возврат идентификатора файла (FileId) для интеграции с другими запросами API.
• Формирование полного ответа сервиса в формате JSON и обработка ошибок.

Получить список доступных файлов в GigaChat

Активность выполняет запрос к API GigaChat для получения информации о всех доступных файлах, загруженных пользователем. Возвращает структурированный JSON-ответ с метаданными файлов.

Основные возможности:

• Получение списка файлов, доступных для использования в API GigaChat.
• Авторизация через Bearer-токен (OAuth 2.0), защищенный форматом SecureString.
• Возврат полного JSON-ответа с деталями файлов (идентификаторы, названия, типы, размеры и т.д.).
• Обработка и возврат ошибок выполнения в читаемом формате.
• Возврат идентификатора файла (FileId) для интеграции с другими запросами API.
• Формирование полного ответа сервиса в формате JSON и обработка ошибок.

Удалить файл из GigaChat

Активность выполняет удаление файла из хранилища GigaChat по его идентификатору через API. Возвращает JSON-ответ с результатом операции и обработкой ошибок.

Основные возможности:

• Удаление файла по уникальному идентификатору (FileId).
• Авторизация через Bearer-токен (OAuth 2.0) и обязательный Client ID для верификации запроса.
• Формирование URL запроса с экранированием идентификатора файла (поддержка спецсимволов).
• Возврат структурированного JSON-ответа с деталями операции.
• Использование HTTP POST для выполнения операции удаления (в соответствии с API GigaChat).

Запрос на генерацию GigaChat

Активность выполняет запрос к модели GigaChat для генерации текстового ответа на основе пользовательских и системных промптов. Поддерживает интеграцию с загруженными файлами и настройку параметров генерации.

Основные возможности:

• Генерация контекстно-зависимых ответов с учетом системного промпта
• Поддержка вложений: использование файлов из хранилища GigaChat через AttachmentId (до 1 файла за запрос).
• Точная настройка параметров генерации (температура, max_tokens)
• Возврат детальной информации о расходе токенов
• Поддержка моделей: GigaChat-Pro, GigaChat-Max, GigaChat