Флора AI - Вклад [ru]

SBS. Руководство администратора

2026-01-15T15:58:31Z

VoroninE: /* Установка моделей */

===== '''Общее описание''' =====
Сервис предназначен для получения метаданных из естественной человеческой речи. Входным значением для сервиса являются wav-файлы. В ответ на входящий запрос сервис возвращает данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) – сервис получения метаданных.

===== '''Системные требования''' =====
Для нормальной работы сервиса необходимо CPU >= 2.20 GHz с поддержкой инструкций AVX2 или новее. Оперативной памяти необходимо не менее 4 Gb. Для работы на нагруженных сервисах рекомендуется использовать GPU NVIDIA с поддержкой CUDA и наличием CUDA ядер.

Быстродействие на '''CPU''': например, поиск спикера, 8 потоков Xeon(R) Gold 6148 CPU @ 2.40 GHz, 8 Гб ОЗУ, запрос поиска в базе спикера по аудио 10 сек, 100 запросов со сдвигом 0.01 с (100 запросов выполнено за 1 с), максимальное время ожидания 14 с. Одиночный запрос ~1 с.

Тот же запрос с '''GPU''' А16 (с одним из 4-х ядер), максимальное время ожидания '''1.6 с'''.

===== '''Установка/обновление SBS''' =====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/sbs&fileid=601 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление SBS осуществляется скриптом <code>chmod +x ./sbs-<версия>-<релиз>.sh && ./sbs-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./sbs-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/sbs</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить SBS <code>/opt/sbs/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/sbs/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/sbs/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/sbs/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/sbs/.userapi (это файл авторизации в API, нужен для обновления)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/sbs/.proxy (это файл конфигурации proxy, необходим для обновления, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable sbs.service && sudo systemctl start sbs.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status sbs.service</code>

Разрешите доступ к порту 6185 на нужном интерфейсе по протоколу tcp.

===== '''Конфигурирование параметров сервиса SBS'''=====
Настройка параметров сервиса spr производится в файле /opt/sbs/config.json

Описание параметров приведено в таблице. '''Применение любого из параметров требует перезапуска сервиса sbs.'''
{| class="wikitable"
|+
!Параметр
!По умолчанию
!Назначение
|-
|device
|cuda:0
|Вычислительное устройство (cpu/cuda:N, где N — номер графического ускорителя), в ОЗУ которого осуществляется загрузка моделей.
|-
|saveAudio
|true
|Ключ хранения аудио отрезков в базе.
'''Внимание!''' При смене модели векторизации sbs сбросит все вектора и попытается сформировать новые из сохраненного аудио. Если аудио не будет ( saveAudio="false"), все слепки будут фактически уничтожены.
|-
|modifyType
|audio
|Способ дообучения слепка
audio — если указан этот тип, то обновление слепка дозагрузкой аудио делается через объединение старого и загружаемого аудио. Если старого аудио нет, то вектор делается только по новому аудио. В базу сохраняется только новое аудио (если стоит флаг сохранения в базу).

average — в базу сохраняется только новое аудио (если стоит флаг). А новый вектор создается из усреднения старого вектора и вектора из нового аудио.
|-
|db_handler
|""
|[https://wiki.connect2ai.net/index.php/SBS._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%92%D0%BD%D0%B5%D1%88%D0%BD%D0%B8%D0%B9_%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80_%D1%88%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Внешний драйвер шифрования]
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Максимальное количество лог файлов
|-
|logs.maxSize
|5242880
|Максимальный размер одного лог файла
|-
|cluster.logfile
|logs/sync.log
|Файл логов синхронизации есть только на главном сервере кластера
|-
|cluster.statusFile
|logs/sync.status
|Статус задачи синхронизации есть только на главном сервере кластера
|-
|cluster.nodes
|[ ]
|Перечень подчиненных нод для синхронизации изменений заполняется только на главном сервере кластера
|-
|spr.url
|http://127.0.0.1:6183
|Путь к [[SPR. Руководство пользователя|сервису распознавания речи]] для получения текста
|-
|spr.model
|common
|Модель для распознавания текста
|-
|spr.conn_timeout
|10
|Таймаут на подключение к API SPR
|-
|spr.read_timeout
|30
|Таймаут на получения ответа от API SPR
|-
|reloader.period
|900
|Периодичность проверки изменения данных, для полной перезаливки векторной базы в ОЗУ
|}

===== '''Внешний драйвер шифрования'''=====

Файловая база данных хранит в составе слепки аудио, на основе которых рассчитываются вектора (если включен параметр saveAudio). В части сценариев аудио требуется шифровать. Для этого предусмотрен внешний драйвер шифрования. Чтобы использовать драйвер шифрования, необходимо создать программу (скрипт) шифрования, поместить его в каталог /opt/sbs/db_handlers/, а затем имя созданного файла прописать в параметр db_handler конфигурационного файла (/opt/sbs/config.json). Пример драйвера шифрования, который перекодирует слепки в файловой системе в base64, распространяется в составе дистрибутива и расположен в папке /opt/sbs/db_handlers/.

===== '''Установка моделей''' =====
В составе SBS используются модель для Audio-deepfake detection — то есть она отличает синтезированный (искусственный) голос от живого (естественного).

Модель располагается в папке /opt/sbs/pretrained/ .

Модели после установки SBS должны быть добавлены системным администратором.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы.

* База файловая, в папке data.
* lsync настроен через конфиг SBS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах список cluster.nodes: [] оставляем пустым.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером SBS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.sbs.cluster.trainer указываем мастер-сервер, в servers.sbs.cluster перечисляем все сервера кластера SBS, в том числе и мастер.

====='''Сбор данных об ошибках'''=====
Логи сервиса по умолчанию находятся в файле /opt/sbs/logs/log.txt

===== '''Удаление''' =====
Для удаления выполните команду: <code>/opt/sbs/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство администратора

2026-01-15T15:57:25Z

VoroninE: /* Установка моделей */

===== '''Общее описание''' =====
Сервис предназначен для получения метаданных из естественной человеческой речи. Входным значением для сервиса являются wav-файлы. В ответ на входящий запрос сервис возвращает данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) – сервис получения метаданных.

===== '''Системные требования''' =====
Для нормальной работы сервиса необходимо CPU >= 2.20 GHz с поддержкой инструкций AVX2 или новее. Оперативной памяти необходимо не менее 4 Gb. Для работы на нагруженных сервисах рекомендуется использовать GPU NVIDIA с поддержкой CUDA и наличием CUDA ядер.

Быстродействие на '''CPU''': например, поиск спикера, 8 потоков Xeon(R) Gold 6148 CPU @ 2.40 GHz, 8 Гб ОЗУ, запрос поиска в базе спикера по аудио 10 сек, 100 запросов со сдвигом 0.01 с (100 запросов выполнено за 1 с), максимальное время ожидания 14 с. Одиночный запрос ~1 с.

Тот же запрос с '''GPU''' А16 (с одним из 4-х ядер), максимальное время ожидания '''1.6 с'''.

===== '''Установка/обновление SBS''' =====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/sbs&fileid=601 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление SBS осуществляется скриптом <code>chmod +x ./sbs-<версия>-<релиз>.sh && ./sbs-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./sbs-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/sbs</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить SBS <code>/opt/sbs/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/sbs/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/sbs/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/sbs/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/sbs/.userapi (это файл авторизации в API, нужен для обновления)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/sbs/.proxy (это файл конфигурации proxy, необходим для обновления, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable sbs.service && sudo systemctl start sbs.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status sbs.service</code>

Разрешите доступ к порту 6185 на нужном интерфейсе по протоколу tcp.

===== '''Конфигурирование параметров сервиса SBS'''=====
Настройка параметров сервиса spr производится в файле /opt/sbs/config.json

Описание параметров приведено в таблице. '''Применение любого из параметров требует перезапуска сервиса sbs.'''
{| class="wikitable"
|+
!Параметр
!По умолчанию
!Назначение
|-
|device
|cuda:0
|Вычислительное устройство (cpu/cuda:N, где N — номер графического ускорителя), в ОЗУ которого осуществляется загрузка моделей.
|-
|saveAudio
|true
|Ключ хранения аудио отрезков в базе.
'''Внимание!''' При смене модели векторизации sbs сбросит все вектора и попытается сформировать новые из сохраненного аудио. Если аудио не будет ( saveAudio="false"), все слепки будут фактически уничтожены.
|-
|modifyType
|audio
|Способ дообучения слепка
audio — если указан этот тип, то обновление слепка дозагрузкой аудио делается через объединение старого и загружаемого аудио. Если старого аудио нет, то вектор делается только по новому аудио. В базу сохраняется только новое аудио (если стоит флаг сохранения в базу).

average — в базу сохраняется только новое аудио (если стоит флаг). А новый вектор создается из усреднения старого вектора и вектора из нового аудио.
|-
|db_handler
|""
|[https://wiki.connect2ai.net/index.php/SBS._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%92%D0%BD%D0%B5%D1%88%D0%BD%D0%B8%D0%B9_%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80_%D1%88%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Внешний драйвер шифрования]
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Максимальное количество лог файлов
|-
|logs.maxSize
|5242880
|Максимальный размер одного лог файла
|-
|cluster.logfile
|logs/sync.log
|Файл логов синхронизации есть только на главном сервере кластера
|-
|cluster.statusFile
|logs/sync.status
|Статус задачи синхронизации есть только на главном сервере кластера
|-
|cluster.nodes
|[ ]
|Перечень подчиненных нод для синхронизации изменений заполняется только на главном сервере кластера
|-
|spr.url
|http://127.0.0.1:6183
|Путь к [[SPR. Руководство пользователя|сервису распознавания речи]] для получения текста
|-
|spr.model
|common
|Модель для распознавания текста
|-
|spr.conn_timeout
|10
|Таймаут на подключение к API SPR
|-
|spr.read_timeout
|30
|Таймаут на получения ответа от API SPR
|-
|reloader.period
|900
|Периодичность проверки изменения данных, для полной перезаливки векторной базы в ОЗУ
|}

===== '''Внешний драйвер шифрования'''=====

Файловая база данных хранит в составе слепки аудио, на основе которых рассчитываются вектора (если включен параметр saveAudio). В части сценариев аудио требуется шифровать. Для этого предусмотрен внешний драйвер шифрования. Чтобы использовать драйвер шифрования, необходимо создать программу (скрипт) шифрования, поместить его в каталог /opt/sbs/db_handlers/, а затем имя созданного файла прописать в параметр db_handler конфигурационного файла (/opt/sbs/config.json). Пример драйвера шифрования, который перекодирует слепки в файловой системе в base64, распространяется в составе дистрибутива и расположен в папке /opt/sbs/db_handlers/.

===== '''Установка моделей''' =====
В составе SBS используются модель классификации deepfake.

Модель располагается в папке /opt/sbs/pretrained/ - для Audio-deepfake detection — то есть она отличает синтезированный (искусственный) голос от живого (естественного).

Модели после установки SBS должны быть добавлены системным администратором.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы.

* База файловая, в папке data.
* lsync настроен через конфиг SBS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах список cluster.nodes: [] оставляем пустым.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером SBS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.sbs.cluster.trainer указываем мастер-сервер, в servers.sbs.cluster перечисляем все сервера кластера SBS, в том числе и мастер.

====='''Сбор данных об ошибках'''=====
Логи сервиса по умолчанию находятся в файле /opt/sbs/logs/log.txt

===== '''Удаление''' =====
Для удаления выполните команду: <code>/opt/sbs/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство администратора

2026-01-15T15:56:58Z

VoroninE: /* Установка моделей */

===== '''Общее описание''' =====
Сервис предназначен для получения метаданных из естественной человеческой речи. Входным значением для сервиса являются wav-файлы. В ответ на входящий запрос сервис возвращает данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) – сервис получения метаданных.

===== '''Системные требования''' =====
Для нормальной работы сервиса необходимо CPU >= 2.20 GHz с поддержкой инструкций AVX2 или новее. Оперативной памяти необходимо не менее 4 Gb. Для работы на нагруженных сервисах рекомендуется использовать GPU NVIDIA с поддержкой CUDA и наличием CUDA ядер.

Быстродействие на '''CPU''': например, поиск спикера, 8 потоков Xeon(R) Gold 6148 CPU @ 2.40 GHz, 8 Гб ОЗУ, запрос поиска в базе спикера по аудио 10 сек, 100 запросов со сдвигом 0.01 с (100 запросов выполнено за 1 с), максимальное время ожидания 14 с. Одиночный запрос ~1 с.

Тот же запрос с '''GPU''' А16 (с одним из 4-х ядер), максимальное время ожидания '''1.6 с'''.

===== '''Установка/обновление SBS''' =====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/sbs&fileid=601 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление SBS осуществляется скриптом <code>chmod +x ./sbs-<версия>-<релиз>.sh && ./sbs-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./sbs-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/sbs</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить SBS <code>/opt/sbs/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/sbs/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/sbs/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/sbs/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/sbs/.userapi (это файл авторизации в API, нужен для обновления)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/sbs/.proxy (это файл конфигурации proxy, необходим для обновления, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable sbs.service && sudo systemctl start sbs.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status sbs.service</code>

Разрешите доступ к порту 6185 на нужном интерфейсе по протоколу tcp.

===== '''Конфигурирование параметров сервиса SBS'''=====
Настройка параметров сервиса spr производится в файле /opt/sbs/config.json

Описание параметров приведено в таблице. '''Применение любого из параметров требует перезапуска сервиса sbs.'''
{| class="wikitable"
|+
!Параметр
!По умолчанию
!Назначение
|-
|device
|cuda:0
|Вычислительное устройство (cpu/cuda:N, где N — номер графического ускорителя), в ОЗУ которого осуществляется загрузка моделей.
|-
|saveAudio
|true
|Ключ хранения аудио отрезков в базе.
'''Внимание!''' При смене модели векторизации sbs сбросит все вектора и попытается сформировать новые из сохраненного аудио. Если аудио не будет ( saveAudio="false"), все слепки будут фактически уничтожены.
|-
|modifyType
|audio
|Способ дообучения слепка
audio — если указан этот тип, то обновление слепка дозагрузкой аудио делается через объединение старого и загружаемого аудио. Если старого аудио нет, то вектор делается только по новому аудио. В базу сохраняется только новое аудио (если стоит флаг сохранения в базу).

average — в базу сохраняется только новое аудио (если стоит флаг). А новый вектор создается из усреднения старого вектора и вектора из нового аудио.
|-
|db_handler
|""
|[https://wiki.connect2ai.net/index.php/SBS._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%92%D0%BD%D0%B5%D1%88%D0%BD%D0%B8%D0%B9_%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80_%D1%88%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Внешний драйвер шифрования]
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Максимальное количество лог файлов
|-
|logs.maxSize
|5242880
|Максимальный размер одного лог файла
|-
|cluster.logfile
|logs/sync.log
|Файл логов синхронизации есть только на главном сервере кластера
|-
|cluster.statusFile
|logs/sync.status
|Статус задачи синхронизации есть только на главном сервере кластера
|-
|cluster.nodes
|[ ]
|Перечень подчиненных нод для синхронизации изменений заполняется только на главном сервере кластера
|-
|spr.url
|http://127.0.0.1:6183
|Путь к [[SPR. Руководство пользователя|сервису распознавания речи]] для получения текста
|-
|spr.model
|common
|Модель для распознавания текста
|-
|spr.conn_timeout
|10
|Таймаут на подключение к API SPR
|-
|spr.read_timeout
|30
|Таймаут на получения ответа от API SPR
|-
|reloader.period
|900
|Периодичность проверки изменения данных, для полной перезаливки векторной базы в ОЗУ
|}

===== '''Внешний драйвер шифрования'''=====

Файловая база данных хранит в составе слепки аудио, на основе которых рассчитываются вектора (если включен параметр saveAudio). В части сценариев аудио требуется шифровать. Для этого предусмотрен внешний драйвер шифрования. Чтобы использовать драйвер шифрования, необходимо создать программу (скрипт) шифрования, поместить его в каталог /opt/sbs/db_handlers/, а затем имя созданного файла прописать в параметр db_handler конфигурационного файла (/opt/sbs/config.json). Пример драйвера шифрования, который перекодирует слепки в файловой системе в base64, распространяется в составе дистрибутива и расположен в папке /opt/sbs/db_handlers/.

===== '''Установка моделей''' =====
В составе SBS используются модель классификации deepfake.

Модель deepfake располагается в папке /opt/sbs/pretrained/ - для Audio-deepfake detection — то есть она отличает синтезированный (искусственный) голос от живого (естественного).

Модели после установки SBS должны быть добавлены системным администратором.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы.

* База файловая, в папке data.
* lsync настроен через конфиг SBS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах список cluster.nodes: [] оставляем пустым.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером SBS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.sbs.cluster.trainer указываем мастер-сервер, в servers.sbs.cluster перечисляем все сервера кластера SBS, в том числе и мастер.

====='''Сбор данных об ошибках'''=====
Логи сервиса по умолчанию находятся в файле /opt/sbs/logs/log.txt

===== '''Удаление''' =====
Для удаления выполните команду: <code>/opt/sbs/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство администратора

2026-01-15T15:50:49Z

VoroninE:

===== '''Общее описание''' =====
Сервис предназначен для получения метаданных из естественной человеческой речи. Входным значением для сервиса являются wav-файлы. В ответ на входящий запрос сервис возвращает данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) – сервис получения метаданных.

===== '''Системные требования''' =====
Для нормальной работы сервиса необходимо CPU >= 2.20 GHz с поддержкой инструкций AVX2 или новее. Оперативной памяти необходимо не менее 4 Gb. Для работы на нагруженных сервисах рекомендуется использовать GPU NVIDIA с поддержкой CUDA и наличием CUDA ядер.

Быстродействие на '''CPU''': например, поиск спикера, 8 потоков Xeon(R) Gold 6148 CPU @ 2.40 GHz, 8 Гб ОЗУ, запрос поиска в базе спикера по аудио 10 сек, 100 запросов со сдвигом 0.01 с (100 запросов выполнено за 1 с), максимальное время ожидания 14 с. Одиночный запрос ~1 с.

Тот же запрос с '''GPU''' А16 (с одним из 4-х ядер), максимальное время ожидания '''1.6 с'''.

===== '''Установка/обновление SBS''' =====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/sbs&fileid=601 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление SBS осуществляется скриптом <code>chmod +x ./sbs-<версия>-<релиз>.sh && ./sbs-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./sbs-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/sbs</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить SBS <code>/opt/sbs/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/sbs/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/sbs/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/sbs/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/sbs/.userapi (это файл авторизации в API, нужен для обновления)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/sbs/.proxy (это файл конфигурации proxy, необходим для обновления, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable sbs.service && sudo systemctl start sbs.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status sbs.service</code>

Разрешите доступ к порту 6185 на нужном интерфейсе по протоколу tcp.

===== '''Конфигурирование параметров сервиса SBS'''=====
Настройка параметров сервиса spr производится в файле /opt/sbs/config.json

Описание параметров приведено в таблице. '''Применение любого из параметров требует перезапуска сервиса sbs.'''
{| class="wikitable"
|+
!Параметр
!По умолчанию
!Назначение
|-
|device
|cuda:0
|Вычислительное устройство (cpu/cuda:N, где N — номер графического ускорителя), в ОЗУ которого осуществляется загрузка моделей.
|-
|saveAudio
|true
|Ключ хранения аудио отрезков в базе.
'''Внимание!''' При смене модели векторизации sbs сбросит все вектора и попытается сформировать новые из сохраненного аудио. Если аудио не будет ( saveAudio="false"), все слепки будут фактически уничтожены.
|-
|modifyType
|audio
|Способ дообучения слепка
audio — если указан этот тип, то обновление слепка дозагрузкой аудио делается через объединение старого и загружаемого аудио. Если старого аудио нет, то вектор делается только по новому аудио. В базу сохраняется только новое аудио (если стоит флаг сохранения в базу).

average — в базу сохраняется только новое аудио (если стоит флаг). А новый вектор создается из усреднения старого вектора и вектора из нового аудио.
|-
|db_handler
|""
|[https://wiki.connect2ai.net/index.php/SBS._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%92%D0%BD%D0%B5%D1%88%D0%BD%D0%B8%D0%B9_%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80_%D1%88%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Внешний драйвер шифрования]
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Максимальное количество лог файлов
|-
|logs.maxSize
|5242880
|Максимальный размер одного лог файла
|-
|cluster.logfile
|logs/sync.log
|Файл логов синхронизации есть только на главном сервере кластера
|-
|cluster.statusFile
|logs/sync.status
|Статус задачи синхронизации есть только на главном сервере кластера
|-
|cluster.nodes
|[ ]
|Перечень подчиненных нод для синхронизации изменений заполняется только на главном сервере кластера
|-
|spr.url
|http://127.0.0.1:6183
|Путь к [[SPR. Руководство пользователя|сервису распознавания речи]] для получения текста
|-
|spr.model
|common
|Модель для распознавания текста
|-
|spr.conn_timeout
|10
|Таймаут на подключение к API SPR
|-
|spr.read_timeout
|30
|Таймаут на получения ответа от API SPR
|-
|reloader.period
|900
|Периодичность проверки изменения данных, для полной перезаливки векторной базы в ОЗУ
|}

===== '''Внешний драйвер шифрования'''=====

Файловая база данных хранит в составе слепки аудио, на основе которых рассчитываются вектора (если включен параметр saveAudio). В части сценариев аудио требуется шифровать. Для этого предусмотрен внешний драйвер шифрования. Чтобы использовать драйвер шифрования, необходимо создать программу (скрипт) шифрования, поместить его в каталог /opt/sbs/db_handlers/, а затем имя созданного файла прописать в параметр db_handler конфигурационного файла (/opt/sbs/config.json). Пример драйвера шифрования, который перекодирует слепки в файловой системе в base64, распространяется в составе дистрибутива и расположен в папке /opt/sbs/db_handlers/.

===== '''Установка моделей''' =====
В составе SBS используются модель классификации deepfake.

Модель deepfake располагается в папке /opt/sbs/pretrained/ - для классификации синтетических и реальных аудио данных. Модели после установки QAS должны быть добавлены системным администратором.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы.

* База файловая, в папке data.
* lsync настроен через конфиг SBS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах список cluster.nodes: [] оставляем пустым.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером SBS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.sbs.cluster.trainer указываем мастер-сервер, в servers.sbs.cluster перечисляем все сервера кластера SBS, в том числе и мастер.

====='''Сбор данных об ошибках'''=====
Логи сервиса по умолчанию находятся в файле /opt/sbs/logs/log.txt

===== '''Удаление''' =====
Для удаления выполните команду: <code>/opt/sbs/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство администратора

2026-01-15T15:50:27Z

VoroninE:

===== '''Общее описание''' =====
Сервис предназначен для получения метаданных из естественной человеческой речи. Входным значением для сервиса являются wav-файлы. В ответ на входящий запрос сервис возвращает данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) – сервис получения метаданных.

===== '''Системные требования''' =====
Для нормальной работы сервиса необходимо CPU >= 2.20 GHz с поддержкой инструкций AVX2 или новее. Оперативной памяти необходимо не менее 4 Gb. Для работы на нагруженных сервисах рекомендуется использовать GPU NVIDIA с поддержкой CUDA и наличием CUDA ядер.

Быстродействие на '''CPU''': например, поиск спикера, 8 потоков Xeon(R) Gold 6148 CPU @ 2.40 GHz, 8 Гб ОЗУ, запрос поиска в базе спикера по аудио 10 сек, 100 запросов со сдвигом 0.01 с (100 запросов выполнено за 1 с), максимальное время ожидания 14 с. Одиночный запрос ~1 с.

Тот же запрос с '''GPU''' А16 (с одним из 4-х ядер), максимальное время ожидания '''1.6 с'''.

===== '''Установка/обновление SBS''' =====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/sbs&fileid=601 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление SBS осуществляется скриптом <code>chmod +x ./sbs-<версия>-<релиз>.sh && ./sbs-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./sbs-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/sbs</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить SBS <code>/opt/sbs/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/sbs/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/sbs/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/sbs/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/sbs/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/sbs/.userapi (это файл авторизации в API, нужен для обновления)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/sbs/.proxy (это файл конфигурации proxy, необходим для обновления, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable sbs.service && sudo systemctl start sbs.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status sbs.service</code>

Разрешите доступ к порту 6185 на нужном интерфейсе по протоколу tcp.

===== '''Конфигурирование параметров сервиса SBS'''=====
Настройка параметров сервиса spr производится в файле /opt/sbs/config.json

Описание параметров приведено в таблице. '''Применение любого из параметров требует перезапуска сервиса sbs.'''
{| class="wikitable"
|+
!Параметр
!По умолчанию
!Назначение
|-
|device
|cuda:0
|Вычислительное устройство (cpu/cuda:N, где N — номер графического ускорителя), в ОЗУ которого осуществляется загрузка моделей.
|-
|saveAudio
|true
|Ключ хранения аудио отрезков в базе.
'''Внимание!''' При смене модели векторизации sbs сбросит все вектора и попытается сформировать новые из сохраненного аудио. Если аудио не будет ( saveAudio="false"), все слепки будут фактически уничтожены.
|-
|modifyType
|audio
|Способ дообучения слепка
audio — если указан этот тип, то обновление слепка дозагрузкой аудио делается через объединение старого и загружаемого аудио. Если старого аудио нет, то вектор делается только по новому аудио. В базу сохраняется только новое аудио (если стоит флаг сохранения в базу).

average — в базу сохраняется только новое аудио (если стоит флаг). А новый вектор создается из усреднения старого вектора и вектора из нового аудио.
|-
|db_handler
|""
|[https://wiki.connect2ai.net/index.php/SBS._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%92%D0%BD%D0%B5%D1%88%D0%BD%D0%B8%D0%B9_%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80_%D1%88%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F Внешний драйвер шифрования]
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Максимальное количество лог файлов
|-
|logs.maxSize
|5242880
|Максимальный размер одного лог файла
|-
|cluster.logfile
|logs/sync.log
|Файл логов синхронизации есть только на главном сервере кластера
|-
|cluster.statusFile
|logs/sync.status
|Статус задачи синхронизации есть только на главном сервере кластера
|-
|cluster.nodes
|[ ]
|Перечень подчиненных нод для синхронизации изменений заполняется только на главном сервере кластера
|-
|spr.url
|http://127.0.0.1:6183
|Путь к [[SPR. Руководство пользователя|сервису распознавания речи]] для получения текста
|-
|spr.model
|common
|Модель для распознавания текста
|-
|spr.conn_timeout
|10
|Таймаут на подключение к API SPR
|-
|spr.read_timeout
|30
|Таймаут на получения ответа от API SPR
|-
|reloader.period
|900
|Периодичность проверки изменения данных, для полной перезаливки векторной базы в ОЗУ
|}

===== '''Внешний драйвер шифрования'''=====

Файловая база данных хранит в составе слепки аудио, на основе которых рассчитываются вектора (если включен параметр saveAudio). В части сценариев аудио требуется шифровать. Для этого предусмотрен внешний драйвер шифрования. Чтобы использовать драйвер шифрования, необходимо создать программу (скрипт) шифрования, поместить его в каталог /opt/sbs/db_handlers/, а затем имя созданного файла прописать в параметр db_handler конфигурационного файла (/opt/sbs/config.json). Пример драйвера шифрования, который перекодирует слепки в файловой системе в base64, распространяется в составе дистрибутива и расположен в папке /opt/sbs/db_handlers/.

===== '''Установка моделей''' =====
В составе SBS используются модель классификации deepfake.

Модель deepfake располагается в папке /opt/sbs/pretrained/ - для классификации синтетических и реальных аудио данных. Модели после установки QAS должны быть добавлены системным администратором.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы.

* База файловая, в папке data.
* lsync настроен через конфиг SBS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах список cluster.nodes: [] оставляем пустым.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером SBS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.sbs.cluster.trainer указываем мастер-сервер, в servers.sbs.cluster перечисляем все сервера кластера SBS, в том числе и мастер.

====='''Сбор данных об ошибках'''=====
Логи сервиса по умолчанию находятся в файле /opt/sbs/logs/log.txt

===== '''Удаление''' =====
Для удаления выполните команду: <code>/opt/sbs/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство пользователя

2026-01-14T12:11:54Z

VoroninE:

===== '''Общее описание''' =====
Сервис Simple Biometry Server предназначен для извлечения именованных сущностей из текстовых фрагментов (фраз естественной речи). Принимает на вход текстовую строку и возвращает структурированные данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) — сервис извлечения метаданных.

Swagger UI — интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису SBS.

===== '''Описание методов API сервиса биометрии (SBS)''' =====
Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6185/tcp.

Авторизация запросов не требуется. HTTP-запросы должны содержать заголовок <code>"accept: application/json"</code>

Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке <nowiki>http://АДРЕС:6185</nowiki> будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.

<onlyinclude>
{| class="wikitable" style="width: 110%"
|+''Описание методов API''
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 50%" |
* '''wav''' — файл для анализа.
| colspan="2" style="width: 50%" |Пример:
<code>{</code>
<code>age: {</code>

<code>class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}</code>

<code>confidence: 0.99</code>

<code>},</code>

<code>emotion: {</code>

<code>class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR",</code>

<code><<"NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}</code>

<code>confidence: 0.99</code>

<code>},</code>

<code>gender: {</code>

<code>class: FEMALE, # { "MALE", "FEMALE" }</code>

<code>confidence: 0.99</code>

<code>},</code>

<code>multispeaker: {</code>

<code>class: YES, # { "YES", "NO" }</code>

<code>confidence: 0.99</code>

<code>},</code>

<code>synth: {</code>

<code>class: YES, # { "NO", "YES" }</code>

<code>confidence: 0.73</code>

<code>},</code>

|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:

<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для анализа
*'''threshold''' — порог совпадения спикера, от 0 до 1
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |Пример ответа:

<code>{ error: 0, speaker: Ivan, confidence: 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для поиска
*'''id''' — идентификатор говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет проверен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{ "error": 0, "confidence": 0.78 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{</code>

<code> "error": 0,</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"</code>

<code>}</code>
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 50%" |<code>{ error: INT, message: DESCRIPTION }</code>
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 50%" |'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>[</code>
<code> {</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",</code>

<code> "name": "наименование слепка"</code>

<code> }</code>

<code>]</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для обучения

*'''id''' '''—''' идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{</code>
<code> "error": 0,</code>

<code> "message": "Success"</code>

<code>}</code>
|}
</onlyinclude>

SBS. Руководство пользователя

2026-01-14T11:34:07Z

VoroninE:

===== '''Общее описание''' =====
Сервис Simple Biometry Server предназначен для извлечения именованных сущностей из текстовых фрагментов (фраз естественной речи). Принимает на вход текстовую строку и возвращает структурированные данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) — сервис извлечения метаданных.

Swagger UI — интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису SBS.

===== '''Описание методов API сервиса биометрии (SBS)''' =====
Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6185/tcp.

Авторизация запросов не требуется. HTTP-запросы должны содержать заголовок <code>"accept: application/json"</code>

Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке <nowiki>http://АДРЕС:6185</nowiki> будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.

<onlyinclude>
{| class="wikitable" style="width: 110%"
|+''Описание методов API''
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 50%" |
* '''wav''' — файл для анализа.
| colspan="2" style="width: 50%" |Пример:
<code>{</code>

<code> age: {</code>

<code> class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}</code>

<code> confidence: 0.99</code>

<code> },</code>

<code> emotion: {</code>

<code> class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR", </code>

<code> <<"NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}</code>

<code> confidence: 0.99</code>

<code> },</code>

<code> gender: {</code>

<code> class: FEMALE, # { "MALE", "FEMALE" }</code>

<code> confidence: 0.99</code>

<code> },</code>

<code> multispeaker : {</code>

<code> class: YES, # { "YES", "NO" }</code>

<code> confidence: 0.99</code>

<code> },

<code> synth : {

<code> class: YES, # { "NO", "YES" }

<code> confidence: 0.73

<code> },

|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:

<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для анализа
*'''threshold''' — порог совпадения спикера, от 0 до 1
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |Пример ответа:

<code>{ error: 0, speaker: Ivan, confidence: 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для поиска
*'''id''' — идентификатор говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет проверен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{ "error": 0, "confidence": 0.78 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{</code>

<code> "error": 0,</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"</code>

<code>}</code>
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 50%" |<code>{ error: INT, message: DESCRIPTION }</code>
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 50%" |'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>[</code>
<code> {</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",</code>

<code> "name": "наименование слепка"</code>

<code> }</code>

<code>]</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для обучения

*'''id''' '''—''' идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
*'''dataset''' - набор данных
| colspan="2" style="width: 50%" |<code>{</code>
<code> "error": 0,</code>

<code> "message": "Success"</code>

<code>}</code>
|}
</onlyinclude>

QAS. Руководство администратора

2025-11-01T11:57:26Z

VoroninE: fragments.filters

====='''Общее описание'''=====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.
====='''Термины и определения'''=====
Question Answering System (QAS) – сервис ответов на вопросы.

====='''Системные требования'''=====
Для нормальной работы сервиса без GPU необходимо не менее 8 CPU (минимальные требования для использования метода ask) >= 2.20 GHz с поддержкой инструкций AVX2 или новее:
*Intel Haswell
*Intel Broadwell
*Intel Skylake
*Intel Kaby Lake
*Intel Coffee Lake
*Intel Comet Lake
*Intel Rocket Lake
*Intel Alder Lake
*AMD Excavator
*AMD Zen (AMD Ryzen)
*AMD Zen 2 (AMD Ryzen)
*AMD Zen 3 (AMD Ryzen)
Работа на CPU при использовании метода ask крайне не рекомендуется. Оперативной памяти необходимо не менее 16Gb для работы без GPU.

====='''Установка/обновление сервиса'''=====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/qas&fileid=26891 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление QAS осуществляется скриптом <code>chmod +x ./qas-<версия>-<релиз>.sh && ./qas-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./qas-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s https://repo.connect2ai.net/api/qas --user '[user]:[pass]' 2>&1)"</code>.
* Обновить QAS <code>/opt/qas/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/qas/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/qas/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/qas/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Установить модели <code>/opt/qas/inmodel</code> в интерактивном режиме.
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/qas/.userapi (это файл авторизации в API, нужен для обновления и загрузки моделей)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/qas/.proxy (это файл конфигурации proxy, необходим для обновления и загрузки моделей, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable qas.service && sudo systemctl start qas.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status qas.service</code>

Разрешите доступ к порту 6187 на нужном интерфейсе по протоколу tcp.

===== '''Лицензия''' =====
Сервис не функционирует без действующей лицензии. Информация о лицензии хранится в файле:

<code>/opt/qas/license.json</code>

Файл лицензии должен соответствовать следующему формату:

<code>{"service": "qas", "expire": "2045-01-01", "licenses": , "key": ""}</code>

Для получения лицензии необходимо:

1. Запустить сервис <code>systemctl start qas</code> и извлечь UUID, указанный в файле <code>/opt/qas/logs/log.txt</code>

2. Передать полученный UUID руководителю проекта для оформления лицензии.

====='''Установка моделей'''=====

В составе QAS используются модели векторизации, и генеративные модели LLM.

Модели векторизации располагаются в папках:

* /opt/qas/pretrained/embeddings/questions - для работы с кэшем вопросов
* /opt/qas/pretrained/embeddings/docs - для работы с документами
* /opt/qas/pretrained/embeddings/rerank - для реранжирования документов

Расположение моделей LLM: /opt/qas/pretrained/gpt/<имя_модели>/. Например , встроенная модель LLM: /opt/qas/pretrained/gpt/default/. Модели после установки QAS должны быть добавлены системным администратором.

QAS допускает использование дополнительных моделей LLM. Каждая из таких моделей должна быть в отдельной папке каталога /opt/qas/pretrained/gpt/<имя_модели>/. Если модель формата GGUF, то достаточно поместить ее в свою папку в /opt/qas/pretrained/gpt/. В остальных случаях (в том числе и если необходимо обращаться к стороннему api) в папке модели должен быть файл handler.py с функцией handler(prompt='тут текст',params={параметры запроса, см. в руководстве пользователя в метода добавления шаблона запроса}), которая возвращает сгенерированный текст.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы:

* База файловая, в папке data.
* lsync настроен через конфиг QAS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах прописан в конфиге master, чтобы все операции добавления и изменения данных при автокешировании они производили через мастер. Параметр в конфиге questions.master, на мастере значение «<nowiki>http://127.0.0.1:6187»</nowiki>.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером QAS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.qas.trainer указываем мастер-сервер, в servers.qas.cluster перечисляем все сервера кластера QAS, в том числе и мастер.

===== '''Конфигурирование параметров сервиса''' =====
Настройка параметров сервиса qas производится в файле /opt/qas/config.json.

Описание параметров приведено в таблице.
{| class="wikitable"
|+
!style="width: 20%"|Параметр
!По умолчанию
!Назначение
|-
|reloader.period
|60
|Период обновления векторов базы вопросов и документов.
|-
|gpt.instances
|1
|Количество экземпляров встроенной нейросети
|-
|gpt.gpu_layers
|12
|Количество слоёв gpt нейросети, загружаемых в память видеокарты. Остальные слои загрузятся в оперативную память. Чтобы загрузить '''всю''' модель в ГПУ использовать значение "'''-1'''"
|-
|gpt.context
|32768
|Размер контекста встроенной нейросети.
|-
|logs.path
|logs/
|Папка для хранения логов. Примеры абсолютного пути: "/var/log/qas/".
|-
|logs.backups
|10
|Количество файлов ротации.
|-
|logs.maxSize
|5242880
|Максимальный размер файла в байтах, триггер для ротации.
|-
|cache.size
|2560000
|Максимальный размер кэша векторов
|-
|cache.update
|3600
|Период сохранения кэша на диск (секунды)
|-
|fragments.context
|16384
|Максимальная длина текста, которая будет подана в генератор для поиска ответа на вопрос.
|-
|fragments.threshold
|0.5
|Уровень достоверности при векторном поиске фрагментов в загруженных документах.
|-
|fragments.limit
|1
|Максимальное количество фрагментов, которые должны быть найдены в документах в порядке убывания доверия.
|-
|fragments.alpha
|0.5
|Параметр alpha — весовой коэффициент в формуле итоговой релевантности фрагмента, которая объединяет результаты двух моделей: векторизации и реранжирования.
Настройка параметра:

- Высокие значения (близкие к 1.0): Система в большей степени доверяет результатам модели векторизации.

- Низкие значения (близкие к 0.0): Система больше полагается на более точную, но ресурсоемкую модель реранжирования.
|-
|fragments.filters
|[
"^\\d+\\.$",

"^[^\\S\n]*[(\\{\\[«\"]?\\d+\\.[^\\S\\\n]*$",

"^[{}\\[\\]]$",

"^[a-z]{2,3}\\.?$",

"^(?:https?|ftp|www|com|org|net|io|co|edu|gov|html)$"

]
|Список регулярных выражений, который используются как фильтр мусора для векторизации. Все что вызывает положительно срабатывание не будет векторизовано.
|-
|questions.master
|"<nowiki>http://127.0.0.1:6187</nowiki>"
|Адрес мастер-сервера для работы в кластере. Необходим, чтобы добавленные вопросы распространились на серверы кластера.
|-
|questions.threshold
|0.9
|Минимальный уровень достоверности ответа для попадания в кеш.
|-
|cluster.logfile
|logs/sync.log
|Расположение лог-файла синхронизации (актуально для мастер-сервера).
|-
|cluster.logfile
|logs/sync.status
|Расположение файла статуса lsyncd (актуально для мастер-сервера)
|-
|cluster.nodes
|[ ]
|Ноды кластера, на которые с мастер-сервера будут распространяться изменения.
|}

===== '''Сбор данных об ошибках''' =====
Логи сервиса по умолчанию находятся в файле /opt/qas/logs/log.txt

====='''Удаление'''=====
Для удаления выполните команду: <code>/opt/qas/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

UPS. Описание API

2025-10-22T11:57:43Z

VoroninE: /* /qas: методы работы с сервисом qas */

===== '''Описание часто используемых параметров''' =====
{| class="wikitable"
|+
!Параметр
!Тип
!Описание
|-
|'''servicetype'''
|запрос
|Тип сервиса. Возможные значения: spr, smc, see, sbs, tts.
|-
|'''servertype'''
|запрос
|Тип группы серверов. Возможные значения: trainer (серверы обучения), cluster (рабочие серверы).
|-
|'''model'''
|запрос
|Название модели.
|-
|'''modeltype'''
|запрос
|Тип модели. Возможные значения: '''future''' — планируемая/черновик, '''current''' — текущая/рабочая, '''previous''' — архивная.
|-
|'''error'''
|ответ
|Флаг ошибки.
|-
|'''message'''
|ответ
|Информационное сообщение.
|}

===== '''"/external modules" методы внешних модулей''' =====

В этом разделе будут методы соответствующим образом оформленных [[UPS. Руководство администратора#Установка модулей для UPS|внешних модулей]]

===== '''/auth: методы авторизации''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/auth/access'''
! colspan="3" style="width: 85%" |Получение токенов доступа. Токен доступа определяет, какие из методов будут доступны конкретному пользователю. Формируется на основании роли. Дополнительный входной параметр во всех методах, кроме перечисленных в разделе «nopassword» конфигурационного файла. Время действия токена определяется параметром auth.accessLifeTime конфигурационного файла.
|-
|colspan="2" style="width: 50%" |
* '''username''' — логин

* '''password''' — пароль
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/add'''
! colspan="3" style="width: 85%" |Добавление dataset (набора данных). Dataset (набор данных) используется для ограничения доступа к данным. В ответе метод вернет id созданного набора данных.
|-
|colspan="2" style="width: 50%" |
* data — json строка вида: { "name": "название нового набора" }
|colspan="2" style="width: 50%" |{

"error": 0

"message": "success",

"dataset_id": "XXXXXXXXXXXXX"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/dataset/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление dataset (набора данных).
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/modify/{id}'''
! colspan="3" style="width: 85%" |Переименование dataset (набора данных). Метод меняет все параметры набора данных, но на данный момент времени у набора данных, кроме id, только один параметр — наименование.
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
* '''data''' — JSON c новыми параметрами
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/datasets'''
! colspan="3" style="width: 85%" |Получение списка наборов данных.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXXXXXXXXXX",

"name": "XXX"},

{"id": "0",

"name": "По умолчанию"}

]
|-
!style="color:blue;width: 15%" |'''GET/auth/refresh'''
! colspan="3" style="width: 85%" |Обновление токенов доступа. Время, в течение которого можно обновить доступ, регулируется параметром auth.refreshLifeTime конфигурационного файла. Служебный метод, используется в основном в веб-интерфейсе, чтобы не запрашивать лишний раз пароль.
|-
|colspan="2" style="width: 50%" |
* '''x-refresh-token''' — токен обновления доступа
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/rights'''
! colspan="3" style="width: 85%" |Получение списка прав доступа. Служебный метод — по токену получает название роли и все права доступа этой роли, а также общедоступные методы.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |<<<{ "РОЛЬ": [

 "GET:/......" ],

 "nopassword": [ "GET:/.......",

...............

<<<...............

 "POST:/......." ] }
|-
!style="color:green;width: 15%" |'''POST/auth/role/add'''
! colspan="3" style="width: 85%" |Создание роли. Служебный метод — используется веб-интерфейсом при создании роли.
|-
|colspan="2" style="width: 50%" |
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{

"error": 0, "message": "success", "role_id": "a7e68bb83169f864c2fc868401b5250c"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/role/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление роли.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/role/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение роли. Параметры как при создании роли. Роль будет переписана.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/roles'''
! colspan="3" style="width: 85%" |Получение списка ролей.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[{

"id": "XXXXXXXXXXX",

"name": "имя роли",

"rights": [ "набор прав через запятую" ]

},............]
|-
!style="color:green;width: 15%" |'''POST/auth/user/add'''
! colspan="3" style="width: 85%" |Создание нового пользователя. Метод вернет или id нового пользователя или описание ошибки
|-
|colspan="2" style="width: 50%" |
* '''data''' — json строка {

"username": "login_name", "fullname": "Отображаемое Имя","password": "XXXXX","role": "role_id",

"dataset": "default dataset id", "datasets": [ "dataset id", ................. ] }
|colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"user_id": "XXXXXXXXXXXXXXXX"}
|-
!style="color:red;width: 15%" |'''DELETE/auth/user/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' - идентификатор пользователя
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/user/get/{id}'''
! colspan="3" style="width: 85%" |Получение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2" ] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/info'''
! colspan="3" style="width: 85%" |Получение параметров пользователя по его токену доступа. Служебный метод - для предоставления прав текущему пользователю по его токену
|-
|colspan="2" style="width: 50%" |
* '''x-access-token'''
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/list'''
! colspan="3" style="width: 85%" |Получение списка пользователей с их параметрами. Тоже самое что и в методе GET /auth/user/info, только для всех пользователей
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] },

......

]
|-
!style="color:green;width: 15%" |'''POST/auth/user/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''data''' — параметры пользователя как при создании
* '''id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{ "error": 0,

"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/user/password'''
! colspan="3" style="width: 85%" |Смена пароля пользователя по его токену доступа.
|-
|colspan="2" style="width: 50%" |
* '''password'''
|colspan="2" style="width: 50%" |{ "error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/userlog'''
! colspan="3" style="width: 85%" |Получение действий пользователя за период времени по его токену
|-
|colspan="2" style="width: 50%" |
* '''from''' — начало периода в формате "%Y-%m-%d %H:%M"

* '''to''' — конец периода в формате "%Y-%m-%d %H:%M"
|colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "data": [

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 .........

}
|-
!style="color:blue;width: 15%" |'''GET/auth/version'''
! colspan="3" style="width: 85%" |Получение версии сервиса ups
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |{

 "version": "4.082 release"

}
|}

===== '''/lang: методы мультиязычности''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/lang/'''
! colspan="3" style="width: 85%" |Выводит информацию о переводе элементов интерфейса на текущий язык
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "see":"Сущности",

"smc":"Классификатор",

... }
|-
!style="color:blue;width: 15%" |'''GET/lang/wallpaper'''
! colspan="3" style="width: 85%" |Отдает случайный фон рабочего стола в виде jpeg из каталога «wallpapers» на сервере ups
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |image/jpeg
|}

===== '''/server: получение информации о серверах''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |GET/server/get/addresses/{servicetype}
! colspan="3" style="width: 85%" |Вывод информации о серверах, обслуживающих данный сервис, а также настроенных параметров обращения к данным серверам.
'''trainer''' — сервер обучения, '''cluster''' — рабочие серверы, '''connect''' — время на подключение, '''read''' — время на ответ,

'''failed''' — время пребывания в сбойных, '''install''' — время на установку модели, '''info''' — время на получение информации о модели,

'''counter''' — счетчик запросов, '''current''' — индекс последнего опрошенного cluster-сервера

'''fail''' — массив сбойных серверов со временем постановки в сбой.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "trainer": "<nowiki>http://127.0.0.1:6181</nowiki>",

 "cluster": [ "<nowiki>http://127.0.0.1:6181</nowiki>" ],

 "timers": { "connect": 0.5,

 "read": 1,

 "failed": 600,

 "install": 60,

 "info": 3 },

 "counter": 0,

 "current": 0,

 "fail": {"<nowiki>http://127.0.0.1:6181</nowiki>":1686295678} }
|-
!style="color:blue;width: 15%" |GET/server/get/models/{servicetype}/{servertype}
! colspan="3" style="width: 85%" |Вывод информации о моделях указанного сервиса на каждом сервере указанного типа. Вывод представляет собой массив URL-серверов, для каждого из которых указан список моделей.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса

* '''servertype''' — тип серверов
| colspan="2" style="width: 50%" |{ "<nowiki>http://127.0.0.1:6181</nowiki>": [

 "model1",

 ...

 "modelN"

 ], ... }
|}

===== '''/model: методы работы с моделями''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/model/add/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Создание пустой модели в указанном сервисе. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 30%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 70%" |{

"error":0,

"message":"success"

}
|-
!style="color:green;width: 15%" |'''POST/model/apply/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Применение установленной на рабочих серверах модели. После применения модель становится доступна для штатного режима работы. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:red;width: 15%" |'''DELETE/model/delete/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Полностью удаляет модель из системы и со всех управляемых серверов. Доступно для следующих сервисов: smc, see, spr.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/errors/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Запрос на получение списка ошибок модели после тестирования/обучения. Доступен для сервисов see и smc. Ответ содержит список вложенных списков. В каждом три значения: правильное значение, предсказанное моделью значение и начальные данные (фраза).
|-
| colspan="2" style="width: 50%" |
* '''type''' — тип ошибок в выводе
'''- train''' ошибки обучения

'''- test''' ошибки тестирования

'''- mark''' ошибки авторазметки
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[ [true, predicted, phrase],

... ]
|-
!style="color:blue;width: 15%" |'''GET/model/export/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Экспорт модели, модель скачивается в виде zip-архива.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл model.zip, где model — название модели
|-
! style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Удаление постобработчика из модели типа future. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель типа future. Обработчик становится активным сразу после успешной отправки. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из модели типа future.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Удаление постобработчика в указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель указанного типа. Становится активным сразу после успешной отправки.
|-
| colspan="2" style="width: 50%" |
* '''modeltype''' — тип модели
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:green;width: 15%" |'''POST/model/import/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Импортирует модель в черновик (modeltype=future)
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''zip-model''' — zip с файлами модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}'''
! colspan="3" style="width: 85%" |Получение информации о всех моделях указанного сервиса. Аналогичен методу GET /info/{servicetype}/{model}, но выводит информацию обо всех моделях.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "model1": {

 "previous": null,

 "current": null,

 "future": {

 "status": "empty",

 ...

 } }, ... }
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение информации о каждом типе (modeltype) указанной модели. Итоговый массив содержит переменные типа modeltype, в каждой из который содержится информация о модели.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{ "previous": null,

 "current": {

 "status": "trained",

 ... },

 "future": {

 "status": "trained",

 ... } }
|-
!style="color:green;width: 15%" |'''POST/model/install/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Установка импортированной или обученной модели на рабочих серверах.
Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/log/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Выводит лог обучения и тестирования модели. Доступно для следующих сервисов: '''smc''', '''see'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[

 "training",

 "preparing data",

 "tokenizing",

 ...

]
|-
!style="color:green;width: 15%" |'''POST/model/restore/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Откат модели. Делает текущую рабочую модель черновиком (future), рабочие серверы после выполнения данного метода продолжают уже с возвращенной моделью. Схематично действия над modeltype в результате выполнения данного метода можно представить так:
* '''current -> future'''
* '''previous -> current'''
* '''null -> previous'''
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|}

===== '''/corpus: работа с данными для обучения моделей''' =====
Методы данного класса предназначены только для сервисов smc и see

{| class="wikitable" style="width: 110%"
|+
!style="color: blue;width: 15%" |'''GET/corpus/automark/list'''
! colspan="3" style="width: 85%" |Перечень заданий автоматической маркировки корпусов.
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "tasks": [ {

 "id": "29d9da98-d6c1-4dc1-bbc9-111309816002",

 "taskname": "test_doc",

 "status": "finished" },

 { "id": "1a5e9bdc-9f98-49d2-84de-1a9bde8fc37c",

 "taskname": "sssss",

 "status": "finished" } ] }
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/result/{id}'''
! colspan="3" style="width: 85%" |Результат выполнения задания на автомаркировку корпуса. Если задание завершено в ответе придет маркированый корпус и время старта и финиша задания
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{
"error": 0,

"message": "success",

"started": "2024-10-09 18:05:51",

"finished": "2024-10-09 18:05:51",

"corpus": [[ [], [ ["тэг"],"фраза 1"]],

[ [], [["тэг"],"фраза 2"]] ]
}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/start'''
! colspan="3" style="width: 85%" |Начать автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''taskname''' — произвольное имя задания

* '''corpus''' — json строка с размечаемым корпусом[[ [класс1,... классН], текст ],

[ [класс1,... классН], текст ]]

* '''marks''' — json строка с набором меток [ [ метка, [синоним, синоним2 ... синоним Н], порог ],

[ метка, [синоним, синоним2 ... синоним Н], порог ]]

* '''appendMarks''' — "yes" - дополнить разметку, "no" -заменить разметку
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "уникальный id задания"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/status/{id}'''
! colspan="3" style="width: 85%" |Получить статус задания на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — уникальный id задания
| colspan="2" style="width: 50%" |{

 "error": "",

 "status": "finished",

 "started": "2024-10-09 13:49:46",

 "finished": "2024-10-09 13:49:46",

 "progress": 0

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/stop/{id}'''
! colspan="3" style="width: 85%" |Прервать задание на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: green;width: 15%" |'''POST/corpus/copy/{servicetype}'''
! colspan="3" style="width: 85%" |Копирование корпуса данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: red;width: 15%" |'''DELETE/corpus/delete/{servicetype}'''
! colspan="3" style="width: 85%" |Удаляет корпус с данными
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: blue;width: 15%" |'''GET/corpus/export/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает текстовый файл с корпусом, содержащий строки вида КЛАСС<TAB>ФРАЗА
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |Файл name.txt
|-
!style="color: blue;width: 15%" |'''GET/corpus/get/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает JSON с данными корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |<code>[</code>
<code> [ "тэг",</code>

<code> "фраза"</code>

<code> ],</code>

<code> ...</code>

<code>]</code>
|-
!style="color: green;width: 15%" |'''POST/corpus/import/{servicetype}'''
! colspan="3" style="width: 85%" |Метод для импорта корпуса данных. Возможен как из текстового файла со строками вида КЛАСС<TAB>ФРАЗА (доступно для smc и see), так и из логов работы системы (только для smc). Если на вход поступил файл csv, происходит импорт из файла, в противном случае — из логов.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''csv''' — файл данных
* '''startDate''' — дата начала выборки, YYYY-MM-DD
* '''stopDate''' — дата окончания выборки, YYYY-MM-DD
* '''model''' — имя модели, из логов которой будет произведен импорт
* '''limit''' — числовое ограничение строк импорта
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/list/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает список всех корпусов данных для указанного типа сервиса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |[ "корпус1",

"корпус2",

 ...]
|-
!style="color: green;width: 15%" |'''POST/corpus/put/{servicetype}'''
! colspan="3" style="width: 85%" |Перезаписывает корпус отправленным массивом данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''json''' — строка формата json с данными. Аналогична выводу метода GET /get/{servicetype}
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: green;width: 15%" |'''POST/corpus/rename/{servicetype}'''
! colspan="3" style="width: 85%" |Переименование корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|}

===== '''/marks: работа с наборами меток в smc''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/marks/add'''
! colspan="3" style="width: 85%" |Добавление набора менток
|-
| colspan="2" style="width: 50%" |
* '''json''' —список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''name''' — имя создаваемого набора
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "132310fa-98c7-4b12-896f-ff113827d077"

}
|-
!style="color:red;width: 15%" |'''DELETE/marks/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление набора меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }

|-
!style="color:blue;width: 15%" |'''GET/marks/export/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде строк
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

метка1 синоним1,синоним2,синоним3,синонимN 0.9

меткаN синоним11,синоним21,синоним31,синонимN1 0.9
|-
!style="color:blue;width: 15%" |'''GET/marks/get/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде json
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "data": [

 ["метка1", [ "синоним1", "синоним2", "синоним3", "синонимN" ],

 0.9

 ],

 ["меткаN", ["синоним11","синоним21", "синоним31","синонимN1"],

 0.9

 ] ] }
|-
!style="color:green;width: 15%" |'''POST/marks/import/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из файла. Набор будет переписан из файла
|-
| colspan="2" style="width: 50%" |
* '''csv''' — файл "метка"ТАБ"синонимы через запятую"ТАБ"достоверность(число от 0 до 1)"

* '''id''' — идентификатор набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/marks/list'''
! colspan="3" style="width: 85%" |Получение списка наборов меток
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "result": [ { "id": "416fbe08-19e9-453c-b140-37008a08a76c","name": "test" },

 {"id": "16e77fa2-7c4d-47f9-8644-6385876525d6","name": "Рыжик" },

 {"id": "132310fa-98c7-4b12-896f-ff113827d077", "name": "test" }

 ]}
|-
!style="color:green;width: 15%" |'''POST/marks/put/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из json строки. Набор будет переписан
|-
| colspan="2" style="width: 50%" |
* '''json''' — список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''id''' — идентификатор заменяемого набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:green;width: 15%" |'''POST/marks/rename/{id}'''
! colspan="3" style="width: 85%" |Присваивает новое наименование существующему набору меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
* '''name''' — новое имя набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|}

===== '''/spr: работа с сервисом SPR''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/spr/audio/{taskID}'''
! colspan="3" style="width: 85%" |Получение аудиофайла отложенного задания
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Wav файл
|-
!style="color:blue;width: 15%" |'''GET/spr/queue'''
! colspan="3" style="width: 85%" |Получение очереди отложенных заданий. Выводит очередь со статусами выполнения заданий. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" | { "id задания": {

 "created": "ХХХХ-ХХ-ХХ ХХ:ХХ:ХХ",

 "status": "waiting",

 "filename": "wav"}
|-
!style="color:red;width: 15%" |'''DELETE/spr/queue/{taskID}'''
! colspan="3" style="width: 85%" |Удаление задания из очереди
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/spr/result/{taskID}'''
! colspan="3" style="width: 85%" |получениеПезультатов распознавания отложенного задания. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой, '''not found''' — не найдена
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Вывод аналогичен выводу метода stt + добавлено поле status, которое содержит информацию о статусе отложенной задачи
|-
!style="color:green;width: 15%" |'''POST/spr/stt/{model}'''
! colspan="3" style="width: 85%" |Отправка файла на распознавание речи. Моно-файлы до 30 секунд распознаются без разбивки на фрагменты. Многоканальные файлы и файлы длиннее 30 секунд предварительно разбиваются на фрагменты по отсутствию речи. Настройка данных параметров описана в [[SPR. Руководство администратора.|руководстве администратора]] spr.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''wav''' — файл для распознавания
* '''speakers''' — опция поиска говорящих по базе SBS. Если 1, то дополнительно производится поиск говорящих и получение метаданных по каждому говорящему (используется сервис SBS с предварительно обученными слепками метаданных говорящих)
* '''punctuation''' — опция для расстановки знаков препинания. Если 1, то дополнительно вызывает метод punctuate в SMC и расставляет знаки препинания в распознанном тексте, значение по умолчанию берётся из файла конфигурации (для модели big пунктуация выполняется в любом случае).
* '''normalization''' — опция обратной нормализации текста, если 1, то выполняется обратная нормализация текста текста (для модели big выполняется в любом случае).
* '''vad''' — используемый VAD, по умолчанию webrtc
* '''toxicity''' — анализировать распознанный текст на токсичность через smc (GET/smc/toxicity).Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:"оскорбление": 0.13, "непристойность": 0, "угроза": 0, "вежливость": 0.53
* '''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.
* '''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.Аудио говорящего анализируется на возраст (child, adult, old).Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE). Пол (male, female).
* '''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества. При отправке значения -1 разделение на докладчиков будет отключено.
* '''async''' — отложенный запуск распознавания
* '''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
| colspan="2" style="width: 50%" |В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.
'''Для коротких файлов''':

<code>{</code>

<code> "model": "call",</code>

<code> "text": "текст фрагмента",</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "words": [</code>

<code>{ "word": "текст",</code>

<code> "start": 520,</code>

<code> "stop": 1240 },</code>

<code> { "word": "фрагмента",</code>

<code> "start": 1240,</code>

<code> "stop": 1920 }</code>

<code>]</code>

<code>}</code>

'''Для транскрибации больших файлов:'''

<code>{</code>

<code>"speakers": [</code>

<code> {</code>

<code>"id": null,</code>

<code> "duration": 18980,</code>

<code> "fragments": 3,</code>

<code> "age": "old", # только для voice_analyzer=1</code>

<code> "gender": "female" # только для voice_analyzer=1</code>

<code>}</code>

<code>],</code>

<code>"splitted": [</code>

<code> {</code>

<code>"start": "00:00:01.870",</code>

<code> "text": "текст.",</code>

<code> "words": [</code>

<code> {</code>

<code>"word": "текст.",</code>

<code> "start": 1870,</code>

<code> "stop": 2710,</code>

<code> "confidence": 0.95263671875</code>

<code>}</code>

<code>],</code>

<code> "stop": "00:00:05.510",</code>

<code> "channel": 0,</code>

<code> "duration": "00:00:03.640",</code>

<code> "start_ms": 1870,</code>

<code> "stop_ms": 5510,</code>

<code> "duration_ms": 3640,</code>

<code> "speaker": 4,</code>

<code> "speakerConfidence": 0.87,</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "toxicity": { # только для toxicity=1</code>

<code> "insult": 0,</code>

<code> "obscenity": 0,</code>

<code> "threat": 0,</code>

<code> "politeness": 0.99</code>

<code>},</code>

<code> "emotion": { "neutral": -0.3315 }, # только для emotion=1</code>

<code> "voice_analysis": { # только для voice_analyzer=1</code>

<code> "emotion": {</code>

<code> "class": "NEUTRAL",</code>

<code> "confidence": 0.7554781436920166 }</code>

<code>}</code>

<code>}</code>

<code>]</code>

<code>}</code>
|-
!style="color:blue;width: 15%" |'''GET/spr/waveform/{taskID}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания
| colspan="2" style="width: 50%" |{"error": 0,

"waveform": [

0.016,

 0.015,

 0.01 ] }
|}

===== '''/smc: работа с сервисом SMC''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GETsmc/classify/{model}'''
! colspan="3" style="width: 85%" |Классификация текстовой фразы. В случае если модель была создана из меток, в ответе groups и nearest будут пустыми, а ответ будет построен без учета confidenceThreshold из запроса.
В ответе:

* classes — список, для каждого класса которого отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.
* groups — название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т. е. чем полнее группа, тем выше ее позиция в списке).
* nearest — отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор модели
*'''text''' - текст, подлежащий классификации
*'''correction''' - уровень коррекции ошибок, от 0 до 3, по умолчанию 0
*'''confidenceThreshold''', % - минимальный порог доверия.
| colspan="2" style="width: 50%" |{ "corrected": "исправленный текст", # при наличии флага коррекции "classes": [

 { "class": "название класса",

 "confidence": 1 },

 { "class": "название класса 2",

 "confidence": 1 } ],

 "groups": [

 { "group": "название группы 1",

 "intersection": 2,

 "classes": [ "название класса", "название класса 2" ] } ],

 "nearest": [

 { "group": "название группы 2",

 "percent": 0.67,

 "need": "название класса которого не хватило 1" },

 { "group": ""название группы 3",

 "percent": 0.67,

 "need": "название класса которого не хватило 2" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/compress'''
! colspan="3" style="width: 85%" |Убирает из фразы слова не влияющие на ее смысл.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для сжатия

* '''threshold''' — уровень компрессии от 1 до 100. Чем меньше число тем меньше слов будет в итоговой фразе
| colspan="2" style="width: 50%" |{ "text": "сжатый текст"}
|-
!style="color:blue;width: 15%" |'''GET/smc/correct'''
! colspan="3" style="width: 85%" |Коррекция правописания. Изменяет неправильно написанные слова, меняя их на наиболее близкие правильные (из знакомых модели). Если модель коррекции не смогла предложить правильное написание текста, метод вернёт текст неизменным.
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст для коррекции
*'''correction''' - уровень коррекции, от 1 до 3. По умолчанию 1.
*'''model''' - если указано, то при коррекции дополнительно используется словарь модели
| colspan="2" style="width: 50%" |{ "text": "корректный текст" }
|-
!style="color:blue;width: 15%" |'''GET/smc/emotion'''
! colspan="3" style="width: 85%" |Анализ эмоций. На выходе один из вариантов: positive, negative, neutral.
|-
| colspan="2" style="width: 50%" |'''text''' — фраза для анализа эмоций
| colspan="2" style="width: 50%" |{ "emotion": "positive", "score": 0.9601 }
|-
! style="color:green;width: 15%" |'''POST/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Добавляет к модели группы из корпуса. Группы в модели будут перезаписаны
|-
| colspan="2" style="width: 50%" |
* '''id''' — наименование модели

* '''corpus''' — наименование корпуса- источника групп
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:blue;width: 15%" |'''GET/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Поиск групп по ранее полученным меткам. Ищет группы по набору меток. Результат — группы (если найдены) и ближайшие группы с указанием недостающих меток. Позволяет сохранять контекст в виде меток и дозапрашивать группы с учетом контекста.
|-
| colspan="2" style="width: 50%" |
* '''classes''' — набор меток через запятую

* '''model''' — имя модели
| colspan="2" style="width: 50%" |{"groups": [

 { "group": "Группа 1",

 "intersection": 3,

 "classes": [

 "метка1_о",

 "метка2_о",

 "метка3_о" ] },

 { "group": "Группа 2",

 "intersection": 2,

 "classes": [

 "метка1_о",

 "метка5_о" ] }],

"nearest": [

 { "group": "Группа до которой не хватило 1 метки",

 "percent": 0.75,

 "need": "недостающая метка_о" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/normalize'''
! colspan="3" style="width: 85%" |Обратная нормализация текста. Пример: двадцать пятого апреля в пятом часу — 25 апреля в 5-м часу.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{"text": "<строка после обратной нормализации>"}
|-
!style="color:blue;width: 15%" |'''GET/smc/punctuate'''
! colspan="3" style="width: 85%" |Расстановка знаков препинания
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{ "text": "string" }
|-
!style="color:green;width: 15%" |'''POST/smc/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели. Удаляет тестовую версию модели с сервера обучения, тем самым прерывает обучение.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:green;width: 15%" |'''POST/smc/test/{model}'''
! colspan="3" style="width: 85%" |Запуск тестирования модели smc. Метод асинхронный, статус тестирования можно запросить методом GET/info/{servicetype}/{model}
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — название корпуса с тестовыми данными
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/smc/toxicity'''
! colspan="3" style="width: 85%" |Определение токсичности высказывания. Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:
|-
| colspan="2" style="width: 50%" |
* '''text''' — текстовая строка с высказыванием
| colspan="2" style="width: 50%" |{ "insult": 0.13, # оскорбление

 "obscenity": 0, # брань

 "threat": 0, # угрозы

 "politeness": 0.53 вежливость}
|-
!style="color:green;width: 15%" |'''POST/smc/train/{model}'''
! colspan="3" style="width: 85%" |Добавление модели.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — имя текстового корпуса для обучения модели или имя набора меток
* '''isMarks''' — если «1», то вместо корпуса метод ожидает набор меток. Модель, созданная из меток, при этом не обучается, созданный файл модели используется для расчетов векторов «на лету» и выдачи результатов на основании сравнения векторов текста и синонимов из файла с метками.
| colspan="2" style="width: 50%" |{ error: INT, message: DESCRIPTION }
|}

===== '''/see: работа с сервисом SEE''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/see/entities/{model}'''
! colspan="3" style="width: 85%" |Поиск сущностей. Вернется массив со всеми моделями, в которых были найдены сущности (модели для поиска указываются в поле id). Каждая переменная с названием модели будет содержать список всех найденных сущностей.
|-
| colspan="2" style="width: 50%" |
* model — идентификатор[ы] модели. Может быть указано несколько через запятую, тогда запрос будет обработан всеми указанными моделями.
* text — текст для анализа.
* similarity — порог похожести найденной сущности на эталонные, %. По умолчанию 70.
| colspan="2" style="width: 50%" |{ ID-модели: [

{ '''position''': 0, # позиция слова начала фрагмента, определяющего сущность

'''confidence''': 1, #вероятность правильного определения сущности

text: текст сущности,

'''calculated''': vaktsinatsiya # поле, содержащее значение сущности, использованный при обучении модели }, {...}

] }
|-
!style="color:green;width: 15%" |'''POST/see/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color:green;width: 15%" |'''POST/see/train/{model}'''
! colspan="3" style="width: 85%" |Запуск обучения модели '''future'''
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели

* '''corpus''' — название корпуса с данными

* '''noise''' — уровень шума для генерации синтезированных данных для обучения модели, от 1 до 5, по умолчанию 0
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|}

===== '''/sbs: работа с сервисом SBS''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 20%" |
* '''wav''' — файл для анализа
| colspan="2" style="width: 80%" |Пример:

{ age: {

 class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}

 confidence: 0.99 },

emotion: {

 class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR", "NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}

 confidence: 0.99 },

gender: {

 class: FEMALE, # { "MALE", "FEMALE" }

 confidence: 0.99 } }
|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:
<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для анализа
*'''threshold''' — порог похожести при поиске, от 0 до 1.
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |Пример ответа:

{ error: 0, speaker: Ivan, confidence: 0.79 }
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{

 "error": 0,

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"

}
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 20%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 80%" |{ error: INT, message: DESCRIPTION }
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |[ {

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",

 "name": "наименование слепка"

 }]
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для обучения
*'''id''' — идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{ "error": 0,

 "message": "Success"}
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{ "error": 0, "confidence": 0.78 }
|}

====='''/tts: методы работы с сервисом tts'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/tts/dictionary/export'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |Простой текст — строки со словом и его интерпретацией с ударением.
|-
! style="color:blue;width: 15%" |'''GET/tts/dictionary/get'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений в виде json.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ [ "слово", "замена слова с удар+ением"],

[ "слово2", "замена слова2 с удар+ением"],

...]
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/import'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
*'''csv file''' — файл строк со словом и его интерпретацией с ударением.
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "сообщение о статусе результата"}
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/put'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений в виде json. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
* '''json''' — строка json следующего вида:

<code>[</code>

<code>[ "слово", "замена слова с удар+ением" ],</code>

<code>[ "слово2", "замена слова2 с удар+ением" ],</code>

<code>...</code>

<code>]</code>
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "сообщение о статусе результата"

}
|-
! style="color:green;width: 15%" |'''POST/tts/normalize'''
! colspan="3" style="width: 85%" |Нормализация текста — перевод цифр в слова и расстановка ударений (ударения только в нормализованной части фразы), например «в понедельник 10.10.2025» -> «в понедельник дес+ятого октябр+я две т+ысячи дв+адцать п+ятого г+ода».
|-
| colspan="2" style="width: 50%" |
*'''text''' — фраза для нормализации
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "text": "нормализованный текст" }
|-
! style="color:green;width: 15%" |'''POST/tts/revoice/{revoicer}'''
! colspan="3" style="width: 85%" |Модификация или искажение голоса
|-
| colspan="2" style="width: 50%" |
*'''wav''' — аудиофайл для обработки

*'''revoicer''' — модель модификации голоса
| colspan="2" style="width: 50%" |wav-файл с модифицированным (искаженным) голосом
|-
! style="color:blue;width: 15%" |'''GET/tts/revoicers'''
! colspan="3" style="width: 85%" |Перечень моделей модификации или искажения голоса. Модели поставляются только в составе дистрибутива. Модель distortion — искажение голоса, делает голос неузнаваемым и речь неразборчивой.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ "distortion" ]
|-
! style="color:green;width: 15%" |'''POST/tts/synthesize/{model}'''
! colspan="3" style="width: 85%" |Синтез звукового файла из текста/
|-
| colspan="2" style="width: 50%" |
*'''ID''' — имя модели
*'''text''' — текст синтезируемой фразы
*'''rate''' — скорость речи
*'''pitch''' — высота (тон)
*'''volume''' — громкость
*'''frequency''' — частота дискретизации (по умолчанию 22050 Гц)
*'''format''' - формат файла результата (wav, opus, ogg, mp3)
*'''link''' - если 1, то вернуть только ссылку на файл
| colspan="2" style="width: 50%" |файл с синтезированой фразой
|}

====='''/qas: методы работы с сервисом qas'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе. Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст вопроса, на основе которого будут искаться фрагменты.
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

- "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{

"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' - категория для которой генерируются ответы*'''mode''' - режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' - генерирует кэш через разные ответы на каждый вопрос по документации
*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' - {all | empty} обработать все вопросы или только не содержащие ответов
*'''category''' - если указан код категории, то генерация только для этой категории

*'''variants''' - количество ответов, от 1 до 9
*'''replace''' - заменить ответы на сгенерированные
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше. Статусы: '''started''', '''stopped''', если были ошибки, поле ответа '''error''' будет содержать код ошибки.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |Добавить категорию с указанным именем. В ответе — id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование канала
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" |Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,

 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" | Поиск ответа за пределами документов. На стадии разработки, не используется.
|-
| colspan="2" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
|Пример ответа на вопрос "как пройти в библиотеку"{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
* '''text -''' текст документа
* '''model''' - какую модель использовать для ответа, если кроме default используются другие модели
* '''template''' - ID шаблона запроса к LLM, необязательный параметр
* '''doc_id''' - необязательный параметр, ID документа
* '''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
|'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
|'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
|'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''doc_id''' - необязательный параметр, ID документа
* '''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе — id созданного документа или сообщение об ошибке.
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" | Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{

 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:

{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" |Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="2" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="2" |Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
! colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success", "models": ["default" ]}
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" |Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

*'''aliases''' — вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{

 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" | Получение вопроса вместе с ответами и синонимами вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,

 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" | Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов, ограничение списка по вопросам
*'''category''' — фильтр категорий

*'''answer''' — фильтр ответов, ограничение списка по ответам
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,

 "questions": [

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0},

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0}

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры так и отдельные
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.

{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="2" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
|{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="2" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :
массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" | Старт массовой обработки вопросов из файла
|-
| colspan="2" style="width: 50%" |
*'''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" |Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" |Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" |Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;<nowiki> status: 'started' | 'stopped';</nowiki>

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/mismatches'''
| colspan="2" |Статус получения результатов
|-
| colspan="2" |Входные параметры отсутствуют
|{"error": 0,"message": "success","mismatches": [{"question_id": "ID вопроса", "question": "вопрос", "category": "ID категории", "answer_id": "ID ответа", "answer": "ответ на вопрос {question}", "description": "результат поиска", "error" : string, "context": "фрагмент документа", "generatedText" : "Результат генерации" }, ... ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/start'''
| colspan="2" |Запуск генерации вопросов
|-
| colspan="2" |
*'''category''' - ID категории, по которой будет происходить генерация вопросов
*'''doc''' - ID документа, по которому будет происходить генерация вопросов
*'''generateAnswers''' - флаг для генерации ответов вместе с вопросами '''[yse|no]''', по умолчанию '''«no»'''
*'''model''' - имя модели GPT, если кроме default используются другие модели
* '''template''' - ID шаблона запроса к LLM для анализа генерации вопросов, необязательный параметр
|{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/status'''
| colspan="2" |Статус генерации вопросов
|-
| colspan="2" |Входные параметры отсутствуют
|{"error": string, <nowiki>"status": 'started' | 'stopped',</nowiki> "progress": 33.3 }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
* '''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,

 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

* '''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETEqas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
*'''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0, "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|[ "error": 0,
"message": "success",
"docs": [],
"answers": []
]
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте, mismatch - поиск несоответствий

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{ "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0, "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
|{ "error": 0, "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:
<code>{ "name": "новое имя" }</code>
*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.{"error": INT, "message": DESCRIPTION}
|}

====='''/ses: методы работы с роботом'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! colspan="3" |для некоторых путей, где используется {robot_id} - это обращение к версии черновика, чтобы обращаться к продовой версии - нужен постфикс "_prod", для бэкапа "_backup"
актуально для методов

- получения данных робота GET/ses/robot/get/{id}

- применение настроек робота GET/ses/robot/commit/{id}

- экспорт робота GET/ses/robot/export/{id}

- список скриптов GET/ses/robot/script/list/{robot}

- получение скрипта GET/ses/robot/script/get/{robot}/{id}

- список ЭД GET/ses/robot/data/list/{robot}

- получение ЭД GET/ses/robot/data/get/{robot}/{id}

- список КТ GET/ses/robot/endpoint/list/{robot}

- получение КТ GET/ses/robot/endpoint/get/{robot}/{id}

- метода ask (отладчика) POST/ses/ask/{robot_id}

- данные сессии (отладчика) GET/ses/session/{robot_id}/{session_id}
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/audio/{uuid}'''
! colspan="2" style="width: 85%" |Получение аудио-файла из архива диалогов
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |аудио-файл с расширением opus
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/dialog/{uuid}'''
! colspan="2" style="width: 85%" |Получение диалога из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |{ "error": 0, "message": "success",

 "dialog": [{"id": "...", "robot": "...", "channel": "...",

 "unknown": true/false, "closed": true/false, "endpoint": "...",

 "answered": true/false, "models": [...], "variables": {}, "current": {

 "id": "...", "qas": "", "category": "...", "entry": [...],

 "nearest": "...", "missingRunData": [...], "waitingRunData": "...",

 "answered": true/false, "lastreply": "..."},

 "request": {"datetime": "...", "message": "", "data": [...]},

 "reply": {"answers": [{"messages": [...], "voice": "...",

 "interruptible": true/false, "file": null}],

<nowiki> "datetime": "...", "answered": true/false}}]}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/list'''
! colspan="2" style="width: 85%" |Получение списка диалогов из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
*'''startdate''' - начало временного интервала в формате date %Y-%m-%d %H:%M
*'''enddate''' - конец временного интервала в формате date %Y-%m-%d %H:%M
*'''phone''' - номер телефона
*'''variable''' - переменная в формате variable=value
*'''robot''' - идентификатор робота (id)
*'''text''' - фрагмент текста в любом сообщении
*'''data''' - id элемента данных
*'''channel''' - название канала (коннектора)
| style="width: 50%" |[{"uuid": "...", "datetime": "...","phone": "", "channel": [...], "robot": ["..."]}]
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/waveform/{uuid}'''
! colspan="2" style="width: 85%" |Служебный метод для визуализации полученного из архива диалогов аудио-файла, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |[0.016,

0.015,

0.01]
|-
! style="color:green;width: 15%" |'''POST/ses/ask/{robot_id}'''
! colspan="2" style="width: 85%" |Получение ответа на запрос пользователя. Метод для отладки робота
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст запроса

*'''channel''' - id канала

*'''connector''' - имя коннектора

*'''session''' - uuid сессии, если это не первый запрос в сессии

*'''tts''' - вернуть результат синтеза (1- вернуть, 0 - не выполнять синтез)

*'''variables''' - словарик с переменными {"переменная1":"значение","переменнаяN":"значение"}

*'''handler''' - python скрипт для изменения ответов метода под требования внешних систем, подробнее в следующем разделе. в поле имя файла без расширения.

*'''restartClosed''' - перезагрузить сессию при её закрытии с новым id (1 - перезагрузить, 0 - не перезагружать)

*'''audio''' - аудиофайл с запросом, текст запроса будет получен распознаванием audio

*'''document''' - документ для последующей обработки

*'''robot_id''' - id робота

*'''endpoint''' - id точки, в которую передать управление диалогом (необязательный параметр, используется для исходящих оповещений)
| style="width: 50%" |{ "error": 0, "question": "Вопрос",

 "answer": [

 { "messages": [

 "ответ" ],

 "voice": "",

 "interruptible": true/false,

"file": "" } ],

 "session": "",

"uuid": "" }
|-
! style="color:green;width: 15%" |'''POST/ses/robot/add'''
! colspan="2" style="width: 85%" |Создание нового робота. На выходе id созданного робота или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя нового робота
| style="width: 50%" |{ "error": 0, "id": "2fd2f909-2069-4b20-a725-3a598c83f886"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/apply/{id}'''
! colspan="2" style="width: 85%" | Применение робота. Переводит черновик робота в статус prod. Если до этого был prod вариант — становится backup.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/cleardraft/{id}'''
! colspan="2" style="width: 85%" |Обнуление черновика рабочей версией робота

|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/commit/{id}'''
! colspan="2" style="width: 85%" |Применение текущих изменений настроек робота. Применимо ко всем версиям (черновик, рабочая, резервная копия)
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/data/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": { "id": "id ЭД", "name": "Имя ЭД", "comment": "",

 "type": "...", "rtype": "report", "model": "Имя модели",

 "param": "Ответ", "script": "", "weight": 3,

 "slaveData": [], "getOnlyAsNearest": true/false,

 "injectToMessage": true/false, "longWaiting": true/false,

 "dataWaiting": [], "actions": { "alone": {

<nowiki> "default": [{"action": "say", "type": "random", "text": ["....."]}]}},</nowiki>

<nowiki> "exceptions": {}}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка элементов данных
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[ { "id": "3ebfe38b-95bf-4927-a662-17f6e5da22ea",
 "name": "pve", "type": "smc", "rtype": "report",

 "weight": 3, "hasNearestAction": false } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение элемента данных. Формат '''data''' как на выходе метода '''GET/ses/robot/data/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
*'''id''' — идентификатор элемента данных
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление всех версий робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/add/{robot}'''
! colspan="2" style="width: 85%" | Создание конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами конечной точки

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "id": "8576593b-b0d8-4b03-a623-74f3132356ea"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/endpoint/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление конечной точки.
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек конечной точки
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "data": { "id": "...", "name": "...", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка конечных точек робота
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[{ "error": 0, "data": { "id": "...", "name": "точка 1", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "....", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор элемента данных
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/export/{id}'''
! colspan="2" style="width: 85%" |Выгрузка робота в архив
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |zip файл с именем = идентификатор робота
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/files/download/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''id''' - идентификатор файла
| style="width: 50%" |файл
|-
! style="color:green;width: 15%" |'''POST/ses/robot/files/upload/{robot}'''
! colspan="2" style="width: 85%" |Отправка файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''file''' - файл
| style="width: 50%" |{"error": 0, "message": "success", "id": "Id файла"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/get/{id}'''
! colspan="2" style="width: 85%" | Выгрузка основных настроек робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": {

 "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78",

 "name": "test", "description": "", "voice": "",

 "session": { "lifetime": 600 },

 "models": {}, "servicedata": {},

 "exceptions": {}, "actions": {},

 "holidays": [], "timeintervals": {

 "name": { "weekdays": [ 1, 2, 3, 4, 5, 6, 7 ],

 "dates": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31],

"months": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ],

<nowiki>"days": "all", "intervals": [ [ 0, 1440 ] ] }}}}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/import/{id}'''
! colspan="2" style="width: 85%" |Загрузка архива робота в черновик существующего робота
|-
| colspan="2" style="width: 50%" |
*'''zip —''' файл с архивом робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/list'''
! colspan="2" style="width: 85%" |Получение списка роботов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |[ { "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78", "name": "test",

 "hasProd": true,

 "hasBackup": true } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение основных настроек робота. Формат '''data''' как в ответе метода '''GET/ses/robot/get/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с новыми настройками робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/restore/{id}'''
! colspan="2" style="width: 85%" |Откат рабочей версии из бэкапа. Резервная копия становится рабочей, и удаляется, а черновик остается без изменений
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление нового скрипта. Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами скрипта
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/script/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление скрипта
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение текста скрипита
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "data": {

 "id": "6a9f91b6-9634-4079-ac2b-60a944922c61",

"type": "Тип скрипта",

 "name": "Наименование скрипта",

 "code": "Текст скрипта" }

}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка скриптов
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |[ { "id": "9b9d83b7-d5c3-49e6-9bd4-a123a9047939", "name": "наименование1",

 "type": "Тип скрипта"},

 { "id": "48b508ba-a32b-4ada-bcc3-66ce26d81c6a",

 "name": "наименование2",

 "type": "Тип скрипта"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение скрипта.Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор скрипта
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/test/{robot}/{id}'''
! colspan="2" style="width: 85%" |Тестирование скрипта. Формат '''data''' как в ответе метода '''GET/ses/session/{robot_id}/{session_id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка с параметрами сессии
*'''id''' - идентификатор скрипта
*'''robot''' - идентификатор робота
| style="width: 50%" |<nowiki>{"error": 0, "message": "success", "result": {.....}, "variables": {}}</nowiki>
|-
! style="color:blue;width: 15%" |'''POST/ses/robot/userdata/data/add/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление записи в пользовательский справочник.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "id": "id записи"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/data/delete/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" |Удаление записи из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/data/list/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Получение данных из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |[{ "колонка 1": "значение 1", "колонка n": "значение n", "id": "id записи"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}'''
! colspan="2" style="width: 85%" | Массовое изменение данных в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" |Изменение одной записи пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/put/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление данных с заменой в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code> Поле "id" опционально, при его добавлении данные в строке будут заменены.
*'''replace''' - замена всех данных в справочнике новыми данными. Возможные значения: yes/no. По-умолчанию - yes.
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"id": "id справочника", "name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code> Поле "id" опционально.
*'''robot''' - идентификатор робота (id)
| style="width: 50%" |{"error": 0, "id": "id справочника"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/structure/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/structure/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка пользовательских справочников.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
| style="width: 50%" |<nowiki>[{"id": "id справочника", "name": "справочник", "fields": {"колонка1": "значение по умолчанию"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Модификация структуры пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code>
*'''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/session/{robot_id}/{session_id}'''
! colspan="2" style="width: 85%" |Выдает параметры сессии. Для отображения на боковой панели тестирования в UPS. Основные блоки результата:
|-
| colspan="2" style="width: 50%" |
*'''robot_id''' — id робота

*'''session_id''' — id незакрытой сессии
| style="width: 50%" |{ "started": "", "modified": "",

 "robot": "",

 "session": "",

 "channel": "",

 "connector": "",

 "unknown": true/false,

 "current": {"id": "", "qas": "", "answered": true/false, "category": "",

 "nearest": "", "entry": [.....], "missingRunData": [],

 "passedRunData": [.....], "waitingRunData": null,

 "border": int, "preborder": int, "lastreply": ""},

 "models": [.....],

 "scripts": [.....],

<nowiki> "data": [{"request": {.....}, "reply": {.....}}],</nowiki>

 "timers": [],

 "variables": {},

 "error": "",

 "events": {.....},

 "closed": "" }
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/config'''
! colspan="3" style="width: 85%" |Выдает параметры виджета для web канала по запросу js скрипта
|-
| colspan="2" style="width: 50%" |
*'''token''' — уникальный код виджета, создается при внедрении
| colspan="2" style="width: 50%" |Состав конфига канала, для передачи виджету. Подробней в [https://wiki.connect2ai.net/index.php/SES._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%B2%D0%B8%D0%B4%D0%B6%D0%B5%D1%82%D0%B0_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B0%D0%B9%D1%82%D0%B0 Руководстве администратора]
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/js'''
! colspan="3" style="width: 85%" |Выдает код js скрипта виджета для web-канала
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |Код скрипта
|}

====='''/res: методы работы с сервисом отчетов'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! style="color:blue;width: 15%" |'''GET/res/dashboards'''
! colspan="3" style="width: 85%" |Получить список рабочих столов kibana с наборами отчетов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |{ "error": 0, "message": "success",

 "dashboards": {

"Наименование1": "https://........",

<nowiki>"Наименование2": "https://........." }}</nowiki>
|}

====='''/transcription: методы работы со стенографией'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/transcription/audio/{id}'''
! colspan="3" style="width: 85%" | Получить аудиофайл по id стенограммы. Идентификатор нужной стенограммы можно получить методом
"GET /transcription/list"
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |wav файл сохраненной стенограммы
|-
! style="color:green;width: 15%" |'''POST/transcription/create'''
! colspan="3" style="width: 85%" |Создание стенограммы из завершенного задания в очереди распознавания. В ответ придет id созданной стенограммы
|-
| colspan="2" style="width: 50%" |
*'''taskID''' — идентификатор задания из очереди

*'''name''' — имя создаваемой стенограммы
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"id": "74721a3b-9055-4650-9afb-de4d103cafc7"}
|-
! style="color:red;width: 15%" |'''DELETE/transcription/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление стенограммы
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/get/{id}'''
! colspan="3" style="width: 85%" |Получение стенограммы. Используется для отображения стенограммы в веб интерфейсе
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |стенограмма в json формате
|-
! style="color:blue;width: 15%" |'''GET/transcription/list'''
! colspan="3" style="width: 85%" |Получение списка сохраненных стенограмм
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ { "id": "926e8d25-4275-4a78-906b-a1109cdacbea",

"name": "название",

"model": "big",

"created": "2024-03-29 12:37:42",

"modified": "2024-04-24 16:09:09",

"user": "0",

"dataset": "0" }, .... ]
|-
! style="color:green;width: 15%" |'''POST/transcription/save/{id}'''
! colspan="3" style="width: 85%" |Сохранение стенограмы. Используется для сохранения изменений по нажатию кнопки «Сохранить».
|-
| colspan="2" style="width: 50%" |
*'''data''' — стенограмма в json формате

*'''id''' стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/waveform/{id}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, ответ содержит пики сигнала
|-
| colspan="2" style="width: 50%" |
*'''id''' стенограммы
| colspan="2" style="width: 50%" |{ "error": 0,

"waveform": [

 0.016,

 ..........

 ..........

 0.015,

 0.01 ] }
|}

QAS. Руководство пользователя

2025-10-22T11:52:07Z

VoroninE:

==== '''В Общее описание''' ====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.

==== '''Термины и определения''' ====
Question Answering System (QAS) – сервис ответов на вопросы.

==== '''Описание методов API''' ====
Сервис QAS доступен по протоколу HTTP 1.1 через порт 6187/tcp. Авторизация не требуется, но все запросы должны содержать заголовок «accept: application/json». Ответ сервиса возвращается в формате JSON. Если произошла ошибка, возвращается переменная «error=1» и описание ошибки в переменной «message». Для удобства тестирования и использования методов сервиса по адресу <nowiki>http://АДРЕС:6187</nowiki> доступен интерфейс Swagger, который позволяет просматривать и тестировать все доступные методы из таблицы ниже.

{| class="wikitable" style="width: 110%"
|+''Методы API''
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов qas</big>'''
|-
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе.
Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст вопроса, на основе которого будут искаться фрагменты.
* '''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
* '''channel''' — id канала
* '''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

* '''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
* '''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea''' — определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{
"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:green;width: 15%" |'''POST/qas/autocache'''
! colspan="2" style="width: 85%" |Добавление вопросно-ответной пары в кэш.
В случае указания id answer будет принудительно добавлен в вопрос с указанным id. Если же указан question, то система сначала попытается найти похожий вопрос и добавить ответ в него, если же вопрос не будет найден, то система создаст новый с указанной формулировкой. При установке флага emptyQuestion будет добавлен только вопрос (без ответа).
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса
*'''category''' — категория
*'''channel''' — канал
*'''answer''' — ответ
*'''emptyQuestion''' — yes или no, флаг добавления вопроса без указания ответа
*'''checked''' — yes или no, флаг добавления вопроса как «проверенного»
*'''id''' — код существующего вопроса
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' — категория для которой генерируются ответы, если указан код категории, то генерация только для этой категории

*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' — {all | empty} обработать все вопросы или только не содержащие ответов

*'''variants''' — количество ответов, от 1 до 9
*'''replace''' — заменить ответы на сгенерированные
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' — какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' — ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше.

статусы: '''started''', '''stopped''', если были ошибки поле ответа

'''error''' будет содержать код ошибки
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33 }
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" style="width: 85%" |Произвольный запрос в LLM.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Пример ответа на вопрос "как пройти в библиотеку"

{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
| colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success",
 "models": ["default" ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :

массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" |Старт массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |
* '''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке

| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" | Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" | Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" | Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/mismatches'''
| colspan="2" |Статус получения результатов
|-
| colspan="2" |Входные параметры отсутствуют
|{"error": 0,"message": "success","mismatches": [{ "question_id": "ID вопроса",
"question": "вопрос",
"category": "ID категории",
"answer_id": "ID ответа",
"answer": "ответ на вопрос {question}",
"description": "результат поиска",
"error" : string,
"context": "фрагмент документа",
"generatedText" : "Результат генерации"
}, ... ]
}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/start'''
| colspan="2" |Запуск генерации вопросов
|-
| colspan="2" |
*'''category''' - ID категории, по которой будет происходить генерация вопросов
*'''doc''' - ID документа, по которому будет происходить генерация вопросов
*'''generateAnswers''' - флаг для генерации ответов вместе с вопросами '''[yse|no]''', по умолчанию '''«no»'''
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа генерации вопросов, необязательный параметр
|{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/status'''
| colspan="2" |Статус генерации вопросов
|-
| colspan="2" |Входные параметры отсутствуют
|{
"error": string,
"status": 'started' | 'stopped',
"progress": 33.3
}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,
 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
*'''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0,

 "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|{"error": 0,
"message": "success",

"docs": [],

"answers": []

}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов channel</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |'''name''' — наименование канала
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" |Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,
 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов category</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |обавить категорию с указанным именем. В ответе - id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" | Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов doc</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе - id созданного документа или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{
 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:
{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" |Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="3" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="3" |Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов question</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" |Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

*'''aliases''' - вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' — JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов.
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" |Получение вопроса вместе с ответами и синонимами вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,
 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" |Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов
*'''category''' — фильтр категорий

*'''answer''' — фильтр ответов
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,
 "questions": [

 { "id": "77b42c9b-2075-4a5f-b6d9-a284bba7cf43",

 "question": "вопрос",

 "category": "9580b3b7-34cb-4d0e-ba75-d17313ead16d" },

 { "id": "d1836e5e-010e-4f3a-b306-813c3acb7efb",

 "question": "n-й второй вопрос",

 "category": "7d8a3415-cb09-4dad-a169-478ba15ade47" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="3" style="width: 85%" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="3" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''answers''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов summarization_template</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов prompt</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте, mismatch - поиск несоответствий

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0,

 "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
|{ "error": 0,

 "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:

<code>{ "name": "новое имя" }</code>

*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|}

QAS. Руководство пользователя

2025-10-22T11:47:16Z

VoroninE:

==== '''В Общее описание''' ====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.

==== '''Термины и определения''' ====
Question Answering System (QAS) – сервис ответов на вопросы.

==== '''Описание методов API''' ====
Сервис QAS доступен по протоколу HTTP 1.1 через порт 6187/tcp. Авторизация не требуется, но все запросы должны содержать заголовок «accept: application/json». Ответ сервиса возвращается в формате JSON. Если произошла ошибка, возвращается переменная «error=1» и описание ошибки в переменной «message». Для удобства тестирования и использования методов сервиса по адресу <nowiki>http://АДРЕС:6187</nowiki> доступен интерфейс Swagger, который позволяет просматривать и тестировать все доступные методы из таблицы ниже.

{| class="wikitable" style="width: 110%"
|+''Методы API''
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов qas</big>'''
|-
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе.
Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст вопроса, на основе которого будут искаться фрагменты.
* '''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
* '''channel''' — id канала
* '''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

* '''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
* '''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea''' — определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{
"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:green;width: 15%" |'''POST/qas/autocache'''
! colspan="2" style="width: 85%" |Добавление вопросно-ответной пары в кэш.
В случае указания id answer будет принудительно добавлен в вопрос с указанным id. Если же указан question, то система сначала попытается найти похожий вопрос и добавить ответ в него, если же вопрос не будет найден, то система создаст новый с указанной формулировкой. При установке флага emptyQuestion будет добавлен только вопрос (без ответа).
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса
*'''category''' — категория
*'''channel''' — канал
*'''answer''' — ответ
*'''emptyQuestion''' — yes или no, флаг добавления вопроса без указания ответа
*'''checked''' — yes или no, флаг добавления вопроса как «проверенного»
*'''id''' — код существующего вопроса
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' — категория для которой генерируются ответы, если указан код категории, то генерация только для этой категории

*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' — {all | empty} обработать все вопросы или только не содержащие ответов

*'''variants''' — количество ответов, от 1 до 9
*'''replace''' — заменить ответы на сгенерированные
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' — какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' — ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше.

статусы: '''started''', '''stopped''', если были ошибки поле ответа

'''error''' будет содержать код ошибки
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33 }
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" style="width: 85%" |Произвольный запрос в LLM.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Пример ответа на вопрос "как пройти в библиотеку"

{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
| colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success",
 "models": ["default" ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :

массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" |Старт массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |
* '''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке

| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" | Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" | Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" | Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
|'''GET/qas/mismatchsearcher/mismatches'''
| colspan="2" |Статус получения результатов
|-
| colspan="2" |Входные параметры отсутствуют
|{"error": 0,"message": "success","mismatches": [{ "question_id": "ID вопроса",
"question": "вопрос",
"category": "ID категории",
"answer_id": "ID ответа",
"answer": "ответ на вопрос {question}",
"description": "результат поиска",
"error" : string,
"context": "фрагмент документа",
"generatedText" : "Результат генерации"
}, ... ]
}
|-
|'''GET/qas/questionmaker/start'''
| colspan="2" |Запуск генерации вопросов
|-
| colspan="2" |
* '''category''' - ID категории, по которой будет происходить генерация вопросов
* '''doc''' - ID документа, по которому будет происходить генерация вопросов
* '''generateAnswers''' - флаг для генерации ответов вместе с вопросами '''[yse|no]''', по умолчанию '''«no»'''
* '''model''' - имя модели GPT, если кроме default используются другие модели
* '''template''' - ID шаблона запроса к LLM для анализа генерации вопросов, необязательный параметр
|{ "error": 0, "message": "success" }
|-
|'''GET/qas/questionmaker/status'''
| colspan="2" |Статус генерации вопросов
|-
| colspan="2" |Входные параметры отсутствуют
|{
"error": string,
"status": 'started' | 'stopped',
"progress": 33.3
}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,
 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
* '''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0,

 "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|{"error": 0,
"message": "success",

"docs": [],

"answers": []

}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов channel</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |'''name''' — наименование канала
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" | Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,
 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов category</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |обавить категорию с указанным именем. В ответе - id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов doc</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе - id созданного документа или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор документа
| style="width: 50%" |{
 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:
{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" | Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="3" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

* '''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="3" | Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов question</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" | Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

* '''aliases''' - вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' — JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов.
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" |Получение вопроса вместе с ответами и синонимами вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,
 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" |Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов
*'''category''' — фильтр категорий

*'''answer''' — фильтр ответов
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,
 "questions": [

 { "id": "77b42c9b-2075-4a5f-b6d9-a284bba7cf43",

 "question": "вопрос",

 "category": "9580b3b7-34cb-4d0e-ba75-d17313ead16d" },

 { "id": "d1836e5e-010e-4f3a-b306-813c3acb7efb",

 "question": "n-й второй вопрос",

 "category": "7d8a3415-cb09-4dad-a169-478ba15ade47" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="3" style="width: 85%" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="3" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''answers''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов summarization_template</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов prompt</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте, mismatch - поиск несоответствий

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0,

 "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
|{ "error": 0,

 "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:

<code>{ "name": "новое имя" }</code>

*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|}

QAS. Руководство пользователя

2025-10-22T10:24:40Z

VoroninE:

==== '''В Общее описание''' ====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.

==== '''Термины и определения''' ====
Question Answering System (QAS) – сервис ответов на вопросы.

==== '''Описание методов API''' ====
Сервис QAS доступен по протоколу HTTP 1.1 через порт 6187/tcp. Авторизация не требуется, но все запросы должны содержать заголовок «accept: application/json». Ответ сервиса возвращается в формате JSON. Если произошла ошибка, возвращается переменная «error=1» и описание ошибки в переменной «message». Для удобства тестирования и использования методов сервиса по адресу <nowiki>http://АДРЕС:6187</nowiki> доступен интерфейс Swagger, который позволяет просматривать и тестировать все доступные методы из таблицы ниже.

{| class="wikitable" style="width: 110%"
|+''Методы API''
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов qas</big>'''
|-
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе.
Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст вопроса, на основе которого будут искаться фрагменты.
* '''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
* '''channel''' — id канала
* '''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

* '''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
* '''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea''' — определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{
"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:green;width: 15%" |'''POST/qas/autocache'''
! colspan="2" style="width: 85%" |Добавление вопросно-ответной пары в кэш.
В случае указания id answer будет принудительно добавлен в вопрос с указанным id. Если же указан question, то система сначала попытается найти похожий вопрос и добавить ответ в него, если же вопрос не будет найден, то система создаст новый с указанной формулировкой. При установке флага emptyQuestion будет добавлен только вопрос (без ответа).
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса
*'''category''' — категория
*'''channel''' — канал
*'''answer''' — ответ
*'''emptyQuestion''' — yes или no, флаг добавления вопроса без указания ответа
*'''checked''' — yes или no, флаг добавления вопроса как «проверенного»
*'''id''' — код существующего вопроса
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' — категория для которой генерируются ответы, если указан код категории, то генерация только для этой категории

*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' — {all | empty} обработать все вопросы или только не содержащие ответов

*'''variants''' — количество ответов, от 1 до 9
*'''replace''' — заменить ответы на сгенерированные
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' — какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' — ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше.

статусы: '''started''', '''stopped''', если были ошибки поле ответа

'''error''' будет содержать код ошибки
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33 }
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" style="width: 85%" |Произвольный запрос в LLM.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Пример ответа на вопрос "как пройти в библиотеку"

{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
| colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success",
 "models": ["default" ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :

массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" |Старт массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |
* '''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке

| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" | Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" | Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" | Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,
 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
* '''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0,

 "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|{"error": 0,
"message": "success",

"docs": [],

"answers": []

}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов channel</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |'''name''' — наименование канала
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" | Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,
 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов category</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |обавить категорию с указанным именем. В ответе - id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов doc</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе - id созданного документа или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор документа
| style="width: 50%" |{
 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:
{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" | Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="3" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

* '''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="3" | Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов question</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" | Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

* '''aliases''' - вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' — JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов.
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" |Получение вопроса вместе с ответами и синонимами вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,
 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" |Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов
*'''category''' — фильтр категорий

*'''answer''' — фильтр ответов
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,
 "questions": [

 { "id": "77b42c9b-2075-4a5f-b6d9-a284bba7cf43",

 "question": "вопрос",

 "category": "9580b3b7-34cb-4d0e-ba75-d17313ead16d" },

 { "id": "d1836e5e-010e-4f3a-b306-813c3acb7efb",

 "question": "n-й второй вопрос",

 "category": "7d8a3415-cb09-4dad-a169-478ba15ade47" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="3" style="width: 85%" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="3" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''answers''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов summarization_template</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов prompt</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0,

 "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
|{ "error": 0,

 "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:

<code>{ "name": "новое имя" }</code>

*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|}

UPS. Описание API

2025-10-22T10:24:17Z

VoroninE: /* /qas: методы работы с сервисом qas */

===== '''Описание часто используемых параметров''' =====
{| class="wikitable"
|+
!Параметр
!Тип
!Описание
|-
|'''servicetype'''
|запрос
|Тип сервиса. Возможные значения: spr, smc, see, sbs, tts.
|-
|'''servertype'''
|запрос
|Тип группы серверов. Возможные значения: trainer (серверы обучения), cluster (рабочие серверы).
|-
|'''model'''
|запрос
|Название модели.
|-
|'''modeltype'''
|запрос
|Тип модели. Возможные значения: '''future''' — планируемая/черновик, '''current''' — текущая/рабочая, '''previous''' — архивная.
|-
|'''error'''
|ответ
|Флаг ошибки.
|-
|'''message'''
|ответ
|Информационное сообщение.
|}

===== '''"/external modules" методы внешних модулей''' =====

В этом разделе будут методы соответствующим образом оформленных [[UPS. Руководство администратора#Установка модулей для UPS|внешних модулей]]

===== '''/auth: методы авторизации''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/auth/access'''
! colspan="3" style="width: 85%" |Получение токенов доступа. Токен доступа определяет, какие из методов будут доступны конкретному пользователю. Формируется на основании роли. Дополнительный входной параметр во всех методах, кроме перечисленных в разделе «nopassword» конфигурационного файла. Время действия токена определяется параметром auth.accessLifeTime конфигурационного файла.
|-
|colspan="2" style="width: 50%" |
* '''username''' — логин

* '''password''' — пароль
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/add'''
! colspan="3" style="width: 85%" |Добавление dataset (набора данных). Dataset (набор данных) используется для ограничения доступа к данным. В ответе метод вернет id созданного набора данных.
|-
|colspan="2" style="width: 50%" |
* data — json строка вида: { "name": "название нового набора" }
|colspan="2" style="width: 50%" |{

"error": 0

"message": "success",

"dataset_id": "XXXXXXXXXXXXX"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/dataset/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление dataset (набора данных).
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/modify/{id}'''
! colspan="3" style="width: 85%" |Переименование dataset (набора данных). Метод меняет все параметры набора данных, но на данный момент времени у набора данных, кроме id, только один параметр — наименование.
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
* '''data''' — JSON c новыми параметрами
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/datasets'''
! colspan="3" style="width: 85%" |Получение списка наборов данных.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXXXXXXXXXX",

"name": "XXX"},

{"id": "0",

"name": "По умолчанию"}

]
|-
!style="color:blue;width: 15%" |'''GET/auth/refresh'''
! colspan="3" style="width: 85%" |Обновление токенов доступа. Время, в течение которого можно обновить доступ, регулируется параметром auth.refreshLifeTime конфигурационного файла. Служебный метод, используется в основном в веб-интерфейсе, чтобы не запрашивать лишний раз пароль.
|-
|colspan="2" style="width: 50%" |
* '''x-refresh-token''' — токен обновления доступа
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/rights'''
! colspan="3" style="width: 85%" |Получение списка прав доступа. Служебный метод — по токену получает название роли и все права доступа этой роли, а также общедоступные методы.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |<<<{ "РОЛЬ": [

 "GET:/......" ],

 "nopassword": [ "GET:/.......",

...............

<<<...............

 "POST:/......." ] }
|-
!style="color:green;width: 15%" |'''POST/auth/role/add'''
! colspan="3" style="width: 85%" |Создание роли. Служебный метод — используется веб-интерфейсом при создании роли.
|-
|colspan="2" style="width: 50%" |
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{

"error": 0, "message": "success", "role_id": "a7e68bb83169f864c2fc868401b5250c"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/role/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление роли.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/role/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение роли. Параметры как при создании роли. Роль будет переписана.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/roles'''
! colspan="3" style="width: 85%" |Получение списка ролей.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[{

"id": "XXXXXXXXXXX",

"name": "имя роли",

"rights": [ "набор прав через запятую" ]

},............]
|-
!style="color:green;width: 15%" |'''POST/auth/user/add'''
! colspan="3" style="width: 85%" |Создание нового пользователя. Метод вернет или id нового пользователя или описание ошибки
|-
|colspan="2" style="width: 50%" |
* '''data''' — json строка {

"username": "login_name", "fullname": "Отображаемое Имя","password": "XXXXX","role": "role_id",

"dataset": "default dataset id", "datasets": [ "dataset id", ................. ] }
|colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"user_id": "XXXXXXXXXXXXXXXX"}
|-
!style="color:red;width: 15%" |'''DELETE/auth/user/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' - идентификатор пользователя
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/user/get/{id}'''
! colspan="3" style="width: 85%" |Получение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2" ] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/info'''
! colspan="3" style="width: 85%" |Получение параметров пользователя по его токену доступа. Служебный метод - для предоставления прав текущему пользователю по его токену
|-
|colspan="2" style="width: 50%" |
* '''x-access-token'''
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/list'''
! colspan="3" style="width: 85%" |Получение списка пользователей с их параметрами. Тоже самое что и в методе GET /auth/user/info, только для всех пользователей
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] },

......

]
|-
!style="color:green;width: 15%" |'''POST/auth/user/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''data''' — параметры пользователя как при создании
* '''id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{ "error": 0,

"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/user/password'''
! colspan="3" style="width: 85%" |Смена пароля пользователя по его токену доступа.
|-
|colspan="2" style="width: 50%" |
* '''password'''
|colspan="2" style="width: 50%" |{ "error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/userlog'''
! colspan="3" style="width: 85%" |Получение действий пользователя за период времени по его токену
|-
|colspan="2" style="width: 50%" |
* '''from''' — начало периода в формате "%Y-%m-%d %H:%M"

* '''to''' — конец периода в формате "%Y-%m-%d %H:%M"
|colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "data": [

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 .........

}
|-
!style="color:blue;width: 15%" |'''GET/auth/version'''
! colspan="3" style="width: 85%" |Получение версии сервиса ups
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |{

 "version": "4.082 release"

}
|}

===== '''/lang: методы мультиязычности''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/lang/'''
! colspan="3" style="width: 85%" |Выводит информацию о переводе элементов интерфейса на текущий язык
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "see":"Сущности",

"smc":"Классификатор",

... }
|-
!style="color:blue;width: 15%" |'''GET/lang/wallpaper'''
! colspan="3" style="width: 85%" |Отдает случайный фон рабочего стола в виде jpeg из каталога «wallpapers» на сервере ups
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |image/jpeg
|}

===== '''/server: получение информации о серверах''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |GET/server/get/addresses/{servicetype}
! colspan="3" style="width: 85%" |Вывод информации о серверах, обслуживающих данный сервис, а также настроенных параметров обращения к данным серверам.
'''trainer''' — сервер обучения, '''cluster''' — рабочие серверы, '''connect''' — время на подключение, '''read''' — время на ответ,

'''failed''' — время пребывания в сбойных, '''install''' — время на установку модели, '''info''' — время на получение информации о модели,

'''counter''' — счетчик запросов, '''current''' — индекс последнего опрошенного cluster-сервера

'''fail''' — массив сбойных серверов со временем постановки в сбой.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "trainer": "<nowiki>http://127.0.0.1:6181</nowiki>",

 "cluster": [ "<nowiki>http://127.0.0.1:6181</nowiki>" ],

 "timers": { "connect": 0.5,

 "read": 1,

 "failed": 600,

 "install": 60,

 "info": 3 },

 "counter": 0,

 "current": 0,

 "fail": {"<nowiki>http://127.0.0.1:6181</nowiki>":1686295678} }
|-
!style="color:blue;width: 15%" |GET/server/get/models/{servicetype}/{servertype}
! colspan="3" style="width: 85%" |Вывод информации о моделях указанного сервиса на каждом сервере указанного типа. Вывод представляет собой массив URL-серверов, для каждого из которых указан список моделей.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса

* '''servertype''' — тип серверов
| colspan="2" style="width: 50%" |{ "<nowiki>http://127.0.0.1:6181</nowiki>": [

 "model1",

 ...

 "modelN"

 ], ... }
|}

===== '''/model: методы работы с моделями''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/model/add/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Создание пустой модели в указанном сервисе. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 30%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 70%" |{

"error":0,

"message":"success"

}
|-
!style="color:green;width: 15%" |'''POST/model/apply/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Применение установленной на рабочих серверах модели. После применения модель становится доступна для штатного режима работы. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:red;width: 15%" |'''DELETE/model/delete/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Полностью удаляет модель из системы и со всех управляемых серверов. Доступно для следующих сервисов: smc, see, spr.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/errors/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Запрос на получение списка ошибок модели после тестирования/обучения. Доступен для сервисов see и smc. Ответ содержит список вложенных списков. В каждом три значения: правильное значение, предсказанное моделью значение и начальные данные (фраза).
|-
| colspan="2" style="width: 50%" |
* '''type''' — тип ошибок в выводе
'''- train''' ошибки обучения

'''- test''' ошибки тестирования

'''- mark''' ошибки авторазметки
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[ [true, predicted, phrase],

... ]
|-
!style="color:blue;width: 15%" |'''GET/model/export/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Экспорт модели, модель скачивается в виде zip-архива.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл model.zip, где model — название модели
|-
! style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Удаление постобработчика из модели типа future. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель типа future. Обработчик становится активным сразу после успешной отправки. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из модели типа future.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Удаление постобработчика в указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель указанного типа. Становится активным сразу после успешной отправки.
|-
| colspan="2" style="width: 50%" |
* '''modeltype''' — тип модели
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:green;width: 15%" |'''POST/model/import/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Импортирует модель в черновик (modeltype=future)
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''zip-model''' — zip с файлами модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}'''
! colspan="3" style="width: 85%" |Получение информации о всех моделях указанного сервиса. Аналогичен методу GET /info/{servicetype}/{model}, но выводит информацию обо всех моделях.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "model1": {

 "previous": null,

 "current": null,

 "future": {

 "status": "empty",

 ...

 } }, ... }
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение информации о каждом типе (modeltype) указанной модели. Итоговый массив содержит переменные типа modeltype, в каждой из который содержится информация о модели.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{ "previous": null,

 "current": {

 "status": "trained",

 ... },

 "future": {

 "status": "trained",

 ... } }
|-
!style="color:green;width: 15%" |'''POST/model/install/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Установка импортированной или обученной модели на рабочих серверах.
Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/log/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Выводит лог обучения и тестирования модели. Доступно для следующих сервисов: '''smc''', '''see'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[

 "training",

 "preparing data",

 "tokenizing",

 ...

]
|-
!style="color:green;width: 15%" |'''POST/model/restore/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Откат модели. Делает текущую рабочую модель черновиком (future), рабочие серверы после выполнения данного метода продолжают уже с возвращенной моделью. Схематично действия над modeltype в результате выполнения данного метода можно представить так:
* '''current -> future'''
* '''previous -> current'''
* '''null -> previous'''
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|}

===== '''/corpus: работа с данными для обучения моделей''' =====
Методы данного класса предназначены только для сервисов smc и see

{| class="wikitable" style="width: 110%"
|+
!style="color: blue;width: 15%" |'''GET/corpus/automark/list'''
! colspan="3" style="width: 85%" |Перечень заданий автоматической маркировки корпусов.
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "tasks": [ {

 "id": "29d9da98-d6c1-4dc1-bbc9-111309816002",

 "taskname": "test_doc",

 "status": "finished" },

 { "id": "1a5e9bdc-9f98-49d2-84de-1a9bde8fc37c",

 "taskname": "sssss",

 "status": "finished" } ] }
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/result/{id}'''
! colspan="3" style="width: 85%" |Результат выполнения задания на автомаркировку корпуса. Если задание завершено в ответе придет маркированый корпус и время старта и финиша задания
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{
"error": 0,

"message": "success",

"started": "2024-10-09 18:05:51",

"finished": "2024-10-09 18:05:51",

"corpus": [[ [], [ ["тэг"],"фраза 1"]],

[ [], [["тэг"],"фраза 2"]] ]
}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/start'''
! colspan="3" style="width: 85%" |Начать автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''taskname''' — произвольное имя задания

* '''corpus''' — json строка с размечаемым корпусом[[ [класс1,... классН], текст ],

[ [класс1,... классН], текст ]]

* '''marks''' — json строка с набором меток [ [ метка, [синоним, синоним2 ... синоним Н], порог ],

[ метка, [синоним, синоним2 ... синоним Н], порог ]]

* '''appendMarks''' — "yes" - дополнить разметку, "no" -заменить разметку
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "уникальный id задания"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/status/{id}'''
! colspan="3" style="width: 85%" |Получить статус задания на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — уникальный id задания
| colspan="2" style="width: 50%" |{

 "error": "",

 "status": "finished",

 "started": "2024-10-09 13:49:46",

 "finished": "2024-10-09 13:49:46",

 "progress": 0

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/stop/{id}'''
! colspan="3" style="width: 85%" |Прервать задание на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: green;width: 15%" |'''POST/corpus/copy/{servicetype}'''
! colspan="3" style="width: 85%" |Копирование корпуса данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: red;width: 15%" |'''DELETE/corpus/delete/{servicetype}'''
! colspan="3" style="width: 85%" |Удаляет корпус с данными
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: blue;width: 15%" |'''GET/corpus/export/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает текстовый файл с корпусом, содержащий строки вида КЛАСС<TAB>ФРАЗА
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |Файл name.txt
|-
!style="color: blue;width: 15%" |'''GET/corpus/get/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает JSON с данными корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |<code>[</code>
<code> [ "тэг",</code>

<code> "фраза"</code>

<code> ],</code>

<code> ...</code>

<code>]</code>
|-
!style="color: green;width: 15%" |'''POST/corpus/import/{servicetype}'''
! colspan="3" style="width: 85%" |Метод для импорта корпуса данных. Возможен как из текстового файла со строками вида КЛАСС<TAB>ФРАЗА (доступно для smc и see), так и из логов работы системы (только для smc). Если на вход поступил файл csv, происходит импорт из файла, в противном случае — из логов.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''csv''' — файл данных
* '''startDate''' — дата начала выборки, YYYY-MM-DD
* '''stopDate''' — дата окончания выборки, YYYY-MM-DD
* '''model''' — имя модели, из логов которой будет произведен импорт
* '''limit''' — числовое ограничение строк импорта
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/list/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает список всех корпусов данных для указанного типа сервиса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |[ "корпус1",

"корпус2",

 ...]
|-
!style="color: green;width: 15%" |'''POST/corpus/put/{servicetype}'''
! colspan="3" style="width: 85%" |Перезаписывает корпус отправленным массивом данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''json''' — строка формата json с данными. Аналогична выводу метода GET /get/{servicetype}
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: green;width: 15%" |'''POST/corpus/rename/{servicetype}'''
! colspan="3" style="width: 85%" |Переименование корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|}

===== '''/marks: работа с наборами меток в smc''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/marks/add'''
! colspan="3" style="width: 85%" |Добавление набора менток
|-
| colspan="2" style="width: 50%" |
* '''json''' —список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''name''' — имя создаваемого набора
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "132310fa-98c7-4b12-896f-ff113827d077"

}
|-
!style="color:red;width: 15%" |'''DELETE/marks/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление набора меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }

|-
!style="color:blue;width: 15%" |'''GET/marks/export/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде строк
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

метка1 синоним1,синоним2,синоним3,синонимN 0.9

меткаN синоним11,синоним21,синоним31,синонимN1 0.9
|-
!style="color:blue;width: 15%" |'''GET/marks/get/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде json
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "data": [

 ["метка1", [ "синоним1", "синоним2", "синоним3", "синонимN" ],

 0.9

 ],

 ["меткаN", ["синоним11","синоним21", "синоним31","синонимN1"],

 0.9

 ] ] }
|-
!style="color:green;width: 15%" |'''POST/marks/import/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из файла. Набор будет переписан из файла
|-
| colspan="2" style="width: 50%" |
* '''csv''' — файл "метка"ТАБ"синонимы через запятую"ТАБ"достоверность(число от 0 до 1)"

* '''id''' — идентификатор набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/marks/list'''
! colspan="3" style="width: 85%" |Получение списка наборов меток
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "result": [ { "id": "416fbe08-19e9-453c-b140-37008a08a76c","name": "test" },

 {"id": "16e77fa2-7c4d-47f9-8644-6385876525d6","name": "Рыжик" },

 {"id": "132310fa-98c7-4b12-896f-ff113827d077", "name": "test" }

 ]}
|-
!style="color:green;width: 15%" |'''POST/marks/put/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из json строки. Набор будет переписан
|-
| colspan="2" style="width: 50%" |
* '''json''' — список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''id''' — идентификатор заменяемого набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:green;width: 15%" |'''POST/marks/rename/{id}'''
! colspan="3" style="width: 85%" |Присваивает новое наименование существующему набору меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
* '''name''' — новое имя набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|}

===== '''/spr: работа с сервисом SPR''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/spr/audio/{taskID}'''
! colspan="3" style="width: 85%" |Получение аудиофайла отложенного задания
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Wav файл
|-
!style="color:blue;width: 15%" |'''GET/spr/queue'''
! colspan="3" style="width: 85%" |Получение очереди отложенных заданий. Выводит очередь со статусами выполнения заданий. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" | { "id задания": {

 "created": "ХХХХ-ХХ-ХХ ХХ:ХХ:ХХ",

 "status": "waiting",

 "filename": "wav"}
|-
!style="color:red;width: 15%" |'''DELETE/spr/queue/{taskID}'''
! colspan="3" style="width: 85%" |Удаление задания из очереди
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/spr/result/{taskID}'''
! colspan="3" style="width: 85%" |получениеПезультатов распознавания отложенного задания. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой, '''not found''' — не найдена
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Вывод аналогичен выводу метода stt + добавлено поле status, которое содержит информацию о статусе отложенной задачи
|-
!style="color:green;width: 15%" |'''POST/spr/stt/{model}'''
! colspan="3" style="width: 85%" |Отправка файла на распознавание речи. Моно-файлы до 30 секунд распознаются без разбивки на фрагменты. Многоканальные файлы и файлы длиннее 30 секунд предварительно разбиваются на фрагменты по отсутствию речи. Настройка данных параметров описана в [[SPR. Руководство администратора.|руководстве администратора]] spr.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''wav''' — файл для распознавания
* '''speakers''' — опция поиска говорящих по базе SBS. Если 1, то дополнительно производится поиск говорящих и получение метаданных по каждому говорящему (используется сервис SBS с предварительно обученными слепками метаданных говорящих)
* '''punctuation''' — опция для расстановки знаков препинания. Если 1, то дополнительно вызывает метод punctuate в SMC и расставляет знаки препинания в распознанном тексте, значение по умолчанию берётся из файла конфигурации (для модели big пунктуация выполняется в любом случае).
* '''normalization''' — опция обратной нормализации текста, если 1, то выполняется обратная нормализация текста текста (для модели big выполняется в любом случае).
* '''vad''' — используемый VAD, по умолчанию webrtc
* '''toxicity''' — анализировать распознанный текст на токсичность через smc (GET/smc/toxicity).Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:"оскорбление": 0.13, "непристойность": 0, "угроза": 0, "вежливость": 0.53
* '''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.
* '''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.Аудио говорящего анализируется на возраст (child, adult, old).Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE). Пол (male, female).
* '''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества. При отправке значения -1 разделение на докладчиков будет отключено.
* '''async''' — отложенный запуск распознавания
* '''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
| colspan="2" style="width: 50%" |В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.
'''Для коротких файлов''':

<code>{</code>

<code> "model": "call",</code>

<code> "text": "текст фрагмента",</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "words": [</code>

<code>{ "word": "текст",</code>

<code> "start": 520,</code>

<code> "stop": 1240 },</code>

<code> { "word": "фрагмента",</code>

<code> "start": 1240,</code>

<code> "stop": 1920 }</code>

<code>]</code>

<code>}</code>

'''Для транскрибации больших файлов:'''

<code>{</code>

<code>"speakers": [</code>

<code> {</code>

<code>"id": null,</code>

<code> "duration": 18980,</code>

<code> "fragments": 3,</code>

<code> "age": "old", # только для voice_analyzer=1</code>

<code> "gender": "female" # только для voice_analyzer=1</code>

<code>}</code>

<code>],</code>

<code>"splitted": [</code>

<code> {</code>

<code>"start": "00:00:01.870",</code>

<code> "text": "текст.",</code>

<code> "words": [</code>

<code> {</code>

<code>"word": "текст.",</code>

<code> "start": 1870,</code>

<code> "stop": 2710,</code>

<code> "confidence": 0.95263671875</code>

<code>}</code>

<code>],</code>

<code> "stop": "00:00:05.510",</code>

<code> "channel": 0,</code>

<code> "duration": "00:00:03.640",</code>

<code> "start_ms": 1870,</code>

<code> "stop_ms": 5510,</code>

<code> "duration_ms": 3640,</code>

<code> "speaker": 4,</code>

<code> "speakerConfidence": 0.87,</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "toxicity": { # только для toxicity=1</code>

<code> "insult": 0,</code>

<code> "obscenity": 0,</code>

<code> "threat": 0,</code>

<code> "politeness": 0.99</code>

<code>},</code>

<code> "emotion": { "neutral": -0.3315 }, # только для emotion=1</code>

<code> "voice_analysis": { # только для voice_analyzer=1</code>

<code> "emotion": {</code>

<code> "class": "NEUTRAL",</code>

<code> "confidence": 0.7554781436920166 }</code>

<code>}</code>

<code>}</code>

<code>]</code>

<code>}</code>
|-
!style="color:blue;width: 15%" |'''GET/spr/waveform/{taskID}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания
| colspan="2" style="width: 50%" |{"error": 0,

"waveform": [

0.016,

 0.015,

 0.01 ] }
|}

===== '''/smc: работа с сервисом SMC''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GETsmc/classify/{model}'''
! colspan="3" style="width: 85%" |Классификация текстовой фразы. В случае если модель была создана из меток, в ответе groups и nearest будут пустыми, а ответ будет построен без учета confidenceThreshold из запроса.
В ответе:

* classes — список, для каждого класса которого отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.
* groups — название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т. е. чем полнее группа, тем выше ее позиция в списке).
* nearest — отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор модели
*'''text''' - текст, подлежащий классификации
*'''correction''' - уровень коррекции ошибок, от 0 до 3, по умолчанию 0
*'''confidenceThreshold''', % - минимальный порог доверия.
| colspan="2" style="width: 50%" |{ "corrected": "исправленный текст", # при наличии флага коррекции "classes": [

 { "class": "название класса",

 "confidence": 1 },

 { "class": "название класса 2",

 "confidence": 1 } ],

 "groups": [

 { "group": "название группы 1",

 "intersection": 2,

 "classes": [ "название класса", "название класса 2" ] } ],

 "nearest": [

 { "group": "название группы 2",

 "percent": 0.67,

 "need": "название класса которого не хватило 1" },

 { "group": ""название группы 3",

 "percent": 0.67,

 "need": "название класса которого не хватило 2" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/compress'''
! colspan="3" style="width: 85%" |Убирает из фразы слова не влияющие на ее смысл.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для сжатия

* '''threshold''' — уровень компрессии от 1 до 100. Чем меньше число тем меньше слов будет в итоговой фразе
| colspan="2" style="width: 50%" |{ "text": "сжатый текст"}
|-
!style="color:blue;width: 15%" |'''GET/smc/correct'''
! colspan="3" style="width: 85%" |Коррекция правописания. Изменяет неправильно написанные слова, меняя их на наиболее близкие правильные (из знакомых модели). Если модель коррекции не смогла предложить правильное написание текста, метод вернёт текст неизменным.
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст для коррекции
*'''correction''' - уровень коррекции, от 1 до 3. По умолчанию 1.
*'''model''' - если указано, то при коррекции дополнительно используется словарь модели
| colspan="2" style="width: 50%" |{ "text": "корректный текст" }
|-
!style="color:blue;width: 15%" |'''GET/smc/emotion'''
! colspan="3" style="width: 85%" |Анализ эмоций. На выходе один из вариантов: positive, negative, neutral.
|-
| colspan="2" style="width: 50%" |'''text''' — фраза для анализа эмоций
| colspan="2" style="width: 50%" |{ "emotion": "positive", "score": 0.9601 }
|-
! style="color:green;width: 15%" |'''POST/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Добавляет к модели группы из корпуса. Группы в модели будут перезаписаны
|-
| colspan="2" style="width: 50%" |
* '''id''' — наименование модели

* '''corpus''' — наименование корпуса- источника групп
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:blue;width: 15%" |'''GET/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Поиск групп по ранее полученным меткам. Ищет группы по набору меток. Результат — группы (если найдены) и ближайшие группы с указанием недостающих меток. Позволяет сохранять контекст в виде меток и дозапрашивать группы с учетом контекста.
|-
| colspan="2" style="width: 50%" |
* '''classes''' — набор меток через запятую

* '''model''' — имя модели
| colspan="2" style="width: 50%" |{"groups": [

 { "group": "Группа 1",

 "intersection": 3,

 "classes": [

 "метка1_о",

 "метка2_о",

 "метка3_о" ] },

 { "group": "Группа 2",

 "intersection": 2,

 "classes": [

 "метка1_о",

 "метка5_о" ] }],

"nearest": [

 { "group": "Группа до которой не хватило 1 метки",

 "percent": 0.75,

 "need": "недостающая метка_о" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/normalize'''
! colspan="3" style="width: 85%" |Обратная нормализация текста. Пример: двадцать пятого апреля в пятом часу — 25 апреля в 5-м часу.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{"text": "<строка после обратной нормализации>"}
|-
!style="color:blue;width: 15%" |'''GET/smc/punctuate'''
! colspan="3" style="width: 85%" |Расстановка знаков препинания
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{ "text": "string" }
|-
!style="color:green;width: 15%" |'''POST/smc/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели. Удаляет тестовую версию модели с сервера обучения, тем самым прерывает обучение.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:green;width: 15%" |'''POST/smc/test/{model}'''
! colspan="3" style="width: 85%" |Запуск тестирования модели smc. Метод асинхронный, статус тестирования можно запросить методом GET/info/{servicetype}/{model}
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — название корпуса с тестовыми данными
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/smc/toxicity'''
! colspan="3" style="width: 85%" |Определение токсичности высказывания. Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:
|-
| colspan="2" style="width: 50%" |
* '''text''' — текстовая строка с высказыванием
| colspan="2" style="width: 50%" |{ "insult": 0.13, # оскорбление

 "obscenity": 0, # брань

 "threat": 0, # угрозы

 "politeness": 0.53 вежливость}
|-
!style="color:green;width: 15%" |'''POST/smc/train/{model}'''
! colspan="3" style="width: 85%" |Добавление модели.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — имя текстового корпуса для обучения модели или имя набора меток
* '''isMarks''' — если «1», то вместо корпуса метод ожидает набор меток. Модель, созданная из меток, при этом не обучается, созданный файл модели используется для расчетов векторов «на лету» и выдачи результатов на основании сравнения векторов текста и синонимов из файла с метками.
| colspan="2" style="width: 50%" |{ error: INT, message: DESCRIPTION }
|}

===== '''/see: работа с сервисом SEE''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/see/entities/{model}'''
! colspan="3" style="width: 85%" |Поиск сущностей. Вернется массив со всеми моделями, в которых были найдены сущности (модели для поиска указываются в поле id). Каждая переменная с названием модели будет содержать список всех найденных сущностей.
|-
| colspan="2" style="width: 50%" |
* model — идентификатор[ы] модели. Может быть указано несколько через запятую, тогда запрос будет обработан всеми указанными моделями.
* text — текст для анализа.
* similarity — порог похожести найденной сущности на эталонные, %. По умолчанию 70.
| colspan="2" style="width: 50%" |{ ID-модели: [

{ '''position''': 0, # позиция слова начала фрагмента, определяющего сущность

'''confidence''': 1, #вероятность правильного определения сущности

text: текст сущности,

'''calculated''': vaktsinatsiya # поле, содержащее значение сущности, использованный при обучении модели }, {...}

] }
|-
!style="color:green;width: 15%" |'''POST/see/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color:green;width: 15%" |'''POST/see/train/{model}'''
! colspan="3" style="width: 85%" |Запуск обучения модели '''future'''
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели

* '''corpus''' — название корпуса с данными

* '''noise''' — уровень шума для генерации синтезированных данных для обучения модели, от 1 до 5, по умолчанию 0
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|}

===== '''/sbs: работа с сервисом SBS''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 20%" |
* '''wav''' — файл для анализа
| colspan="2" style="width: 80%" |Пример:

{ age: {

 class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}

 confidence: 0.99 },

emotion: {

 class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR", "NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}

 confidence: 0.99 },

gender: {

 class: FEMALE, # { "MALE", "FEMALE" }

 confidence: 0.99 } }
|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:
<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для анализа
*'''threshold''' — порог похожести при поиске, от 0 до 1.
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |Пример ответа:

{ error: 0, speaker: Ivan, confidence: 0.79 }
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{

 "error": 0,

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"

}
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 20%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 80%" |{ error: INT, message: DESCRIPTION }
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |[ {

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",

 "name": "наименование слепка"

 }]
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для обучения
*'''id''' — идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{ "error": 0,

 "message": "Success"}
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 80%" |{ "error": 0, "confidence": 0.78 }
|}

====='''/tts: методы работы с сервисом tts'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/tts/dictionary/export'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |Простой текст — строки со словом и его интерпретацией с ударением.
|-
! style="color:blue;width: 15%" |'''GET/tts/dictionary/get'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений в виде json.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ [ "слово", "замена слова с удар+ением"],

[ "слово2", "замена слова2 с удар+ением"],

...]
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/import'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
*'''csv file''' — файл строк со словом и его интерпретацией с ударением.
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "сообщение о статусе результата"}
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/put'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений в виде json. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
* '''json''' — строка json следующего вида:

<code>[</code>

<code>[ "слово", "замена слова с удар+ением" ],</code>

<code>[ "слово2", "замена слова2 с удар+ением" ],</code>

<code>...</code>

<code>]</code>
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "сообщение о статусе результата"

}
|-
! style="color:green;width: 15%" |'''POST/tts/normalize'''
! colspan="3" style="width: 85%" |Нормализация текста — перевод цифр в слова и расстановка ударений (ударения только в нормализованной части фразы), например «в понедельник 10.10.2025» -> «в понедельник дес+ятого октябр+я две т+ысячи дв+адцать п+ятого г+ода».
|-
| colspan="2" style="width: 50%" |
*'''text''' — фраза для нормализации
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "text": "нормализованный текст" }
|-
! style="color:green;width: 15%" |'''POST/tts/revoice/{revoicer}'''
! colspan="3" style="width: 85%" |Модификация или искажение голоса
|-
| colspan="2" style="width: 50%" |
*'''wav''' — аудиофайл для обработки

*'''revoicer''' — модель модификации голоса
| colspan="2" style="width: 50%" |wav-файл с модифицированным (искаженным) голосом
|-
! style="color:blue;width: 15%" |'''GET/tts/revoicers'''
! colspan="3" style="width: 85%" |Перечень моделей модификации или искажения голоса. Модели поставляются только в составе дистрибутива. Модель distortion — искажение голоса, делает голос неузнаваемым и речь неразборчивой.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ "distortion" ]
|-
! style="color:green;width: 15%" |'''POST/tts/synthesize/{model}'''
! colspan="3" style="width: 85%" |Синтез звукового файла из текста/
|-
| colspan="2" style="width: 50%" |
*'''ID''' — имя модели
*'''text''' — текст синтезируемой фразы
*'''rate''' — скорость речи
*'''pitch''' — высота (тон)
*'''volume''' — громкость
*'''frequency''' — частота дискретизации (по умолчанию 22050 Гц)
*'''format''' - формат файла результата (wav, opus, ogg, mp3)
*'''link''' - если 1, то вернуть только ссылку на файл
| colspan="2" style="width: 50%" |файл с синтезированой фразой
|}

====='''/qas: методы работы с сервисом qas'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе. Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст вопроса, на основе которого будут искаться фрагменты.
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

- "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{

"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' - категория для которой генерируются ответы*'''mode''' - режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' - генерирует кэш через разные ответы на каждый вопрос по документации
*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' - {all | empty} обработать все вопросы или только не содержащие ответов
*'''category''' - если указан код категории, то генерация только для этой категории

*'''variants''' - количество ответов, от 1 до 9
*'''replace''' - заменить ответы на сгенерированные
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше. Статусы: '''started''', '''stopped''', если были ошибки, поле ответа '''error''' будет содержать код ошибки.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |Добавить категорию с указанным именем. В ответе — id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование канала
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" |Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,

 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" | Поиск ответа за пределами документов. На стадии разработки, не используется.
|-
| colspan="2" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
|Пример ответа на вопрос "как пройти в библиотеку"{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
* '''text -''' текст документа
* '''model''' - какую модель использовать для ответа, если кроме default используются другие модели
* '''template''' - ID шаблона запроса к LLM, необязательный параметр
* '''doc_id''' - необязательный параметр, ID документа
* '''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
|'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
|'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
|'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''doc_id''' - необязательный параметр, ID документа
* '''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе — id созданного документа или сообщение об ошибке.
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" | Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{

 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:

{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" |Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="2" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="2" |Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
! colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success", "models": ["default" ]}
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" |Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

*'''aliases''' — вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{

 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" | Получение вопроса вместе с ответами и синонимами вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,

 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" | Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов, ограничение списка по вопросам
*'''category''' — фильтр категорий

*'''answer''' — фильтр ответов, ограничение списка по ответам
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,

 "questions": [

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0},

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0}

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры так и отдельные
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.

{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="2" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
|{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="2" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :
массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" | Старт массовой обработки вопросов из файла
|-
| colspan="2" style="width: 50%" |
*'''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" |Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" |Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" |Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;<nowiki> status: 'started' | 'stopped';</nowiki>

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,

 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETEqas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
*'''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0, "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|[ "error": 0,
"message": "success",
"docs": [],
"answers": []
]
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{ "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
* '''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0, "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
| { "error": 0, "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:
<code>{ "name": "новое имя" }</code>
*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.{"error": INT, "message": DESCRIPTION}
|}

====='''/ses: методы работы с роботом'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! colspan="3" |для некоторых путей, где используется {robot_id} - это обращение к версии черновика, чтобы обращаться к продовой версии - нужен постфикс "_prod", для бэкапа "_backup"
актуально для методов

- получения данных робота GET/ses/robot/get/{id}

- применение настроек робота GET/ses/robot/commit/{id}

- экспорт робота GET/ses/robot/export/{id}

- список скриптов GET/ses/robot/script/list/{robot}

- получение скрипта GET/ses/robot/script/get/{robot}/{id}

- список ЭД GET/ses/robot/data/list/{robot}

- получение ЭД GET/ses/robot/data/get/{robot}/{id}

- список КТ GET/ses/robot/endpoint/list/{robot}

- получение КТ GET/ses/robot/endpoint/get/{robot}/{id}

- метода ask (отладчика) POST/ses/ask/{robot_id}

- данные сессии (отладчика) GET/ses/session/{robot_id}/{session_id}
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/audio/{uuid}'''
! colspan="2" style="width: 85%" |Получение аудио-файла из архива диалогов
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |аудио-файл с расширением opus
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/dialog/{uuid}'''
! colspan="2" style="width: 85%" |Получение диалога из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |{ "error": 0, "message": "success",

 "dialog": [{"id": "...", "robot": "...", "channel": "...",

 "unknown": true/false, "closed": true/false, "endpoint": "...",

 "answered": true/false, "models": [...], "variables": {}, "current": {

 "id": "...", "qas": "", "category": "...", "entry": [...],

 "nearest": "...", "missingRunData": [...], "waitingRunData": "...",

 "answered": true/false, "lastreply": "..."},

 "request": {"datetime": "...", "message": "", "data": [...]},

 "reply": {"answers": [{"messages": [...], "voice": "...",

 "interruptible": true/false, "file": null}],

<nowiki> "datetime": "...", "answered": true/false}}]}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/list'''
! colspan="2" style="width: 85%" |Получение списка диалогов из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
*'''startdate''' - начало временного интервала в формате date %Y-%m-%d %H:%M
*'''enddate''' - конец временного интервала в формате date %Y-%m-%d %H:%M
*'''phone''' - номер телефона
*'''variable''' - переменная в формате variable=value
*'''robot''' - идентификатор робота (id)
*'''text''' - фрагмент текста в любом сообщении
*'''data''' - id элемента данных
*'''channel''' - название канала (коннектора)
| style="width: 50%" |[{"uuid": "...", "datetime": "...","phone": "", "channel": [...], "robot": ["..."]}]
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/waveform/{uuid}'''
! colspan="2" style="width: 85%" |Служебный метод для визуализации полученного из архива диалогов аудио-файла, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |[0.016,

0.015,

0.01]
|-
! style="color:green;width: 15%" |'''POST/ses/ask/{robot_id}'''
! colspan="2" style="width: 85%" |Получение ответа на запрос пользователя. Метод для отладки робота
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст запроса

*'''channel''' - id канала

*'''connector''' - имя коннектора

*'''session''' - uuid сессии, если это не первый запрос в сессии

*'''tts''' - вернуть результат синтеза (1- вернуть, 0 - не выполнять синтез)

*'''variables''' - словарик с переменными {"переменная1":"значение","переменнаяN":"значение"}

*'''handler''' - python скрипт для изменения ответов метода под требования внешних систем, подробнее в следующем разделе. в поле имя файла без расширения.

*'''restartClosed''' - перезагрузить сессию при её закрытии с новым id (1 - перезагрузить, 0 - не перезагружать)

*'''audio''' - аудиофайл с запросом, текст запроса будет получен распознаванием audio

*'''document''' - документ для последующей обработки

*'''robot_id''' - id робота

*'''endpoint''' - id точки, в которую передать управление диалогом (необязательный параметр, используется для исходящих оповещений)
| style="width: 50%" |{ "error": 0, "question": "Вопрос",

 "answer": [

 { "messages": [

 "ответ" ],

 "voice": "",

 "interruptible": true/false,

"file": "" } ],

 "session": "",

"uuid": "" }
|-
! style="color:green;width: 15%" |'''POST/ses/robot/add'''
! colspan="2" style="width: 85%" |Создание нового робота. На выходе id созданного робота или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя нового робота
| style="width: 50%" |{ "error": 0, "id": "2fd2f909-2069-4b20-a725-3a598c83f886"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/apply/{id}'''
! colspan="2" style="width: 85%" |Применение робота. Переводит черновик робота в статус prod. Если до этого был prod вариант — становится backup.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/cleardraft/{id}'''
! colspan="2" style="width: 85%" |Обнуление черновика рабочей версией робота

|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/commit/{id}'''
! colspan="2" style="width: 85%" |Применение текущих изменений настроек робота. Применимо ко всем версиям (черновик, рабочая, резервная копия)
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/data/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": { "id": "id ЭД", "name": "Имя ЭД", "comment": "",

 "type": "...", "rtype": "report", "model": "Имя модели",

 "param": "Ответ", "script": "", "weight": 3,

 "slaveData": [], "getOnlyAsNearest": true/false,

 "injectToMessage": true/false, "longWaiting": true/false,

 "dataWaiting": [], "actions": { "alone": {

<nowiki> "default": [{"action": "say", "type": "random", "text": ["....."]}]}},</nowiki>

<nowiki> "exceptions": {}}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка элементов данных
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[ { "id": "3ebfe38b-95bf-4927-a662-17f6e5da22ea",
 "name": "pve", "type": "smc", "rtype": "report",

 "weight": 3, "hasNearestAction": false } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение элемента данных. Формат '''data''' как на выходе метода '''GET/ses/robot/data/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
*'''id''' — идентификатор элемента данных
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/delete/{id}'''
! colspan="2" style="width: 85%" | Удаление всех версий робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/add/{robot}'''
! colspan="2" style="width: 85%" | Создание конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами конечной точки

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "id": "8576593b-b0d8-4b03-a623-74f3132356ea"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/endpoint/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление конечной точки.
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек конечной точки
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "data": { "id": "...", "name": "...", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка конечных точек робота
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[{ "error": 0, "data": { "id": "...", "name": "точка 1", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "....", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор элемента данных
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/export/{id}'''
! colspan="2" style="width: 85%" |Выгрузка робота в архив
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |zip файл с именем = идентификатор робота
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/files/download/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''id''' - идентификатор файла
| style="width: 50%" |файл
|-
! style="color:green;width: 15%" |'''POST/ses/robot/files/upload/{robot}'''
! colspan="2" style="width: 85%" | Отправка файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''file''' - файл
| style="width: 50%" |{"error": 0, "message": "success", "id": "Id файла"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка основных настроек робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": {

 "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78",

 "name": "test", "description": "", "voice": "",

 "session": { "lifetime": 600 },

 "models": {}, "servicedata": {},

 "exceptions": {}, "actions": {},

 "holidays": [], "timeintervals": {

 "name": { "weekdays": [ 1, 2, 3, 4, 5, 6, 7 ],

 "dates": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31],

"months": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ],

<nowiki>"days": "all", "intervals": [ [ 0, 1440 ] ] }}}}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/import/{id}'''
! colspan="2" style="width: 85%" |Загрузка архива робота в черновик существующего робота
|-
| colspan="2" style="width: 50%" |
*'''zip —''' файл с архивом робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/list'''
! colspan="2" style="width: 85%" |Получение списка роботов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |[ { "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78", "name": "test",

 "hasProd": true,

 "hasBackup": true } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение основных настроек робота. Формат '''data''' как в ответе метода '''GET/ses/robot/get/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с новыми настройками робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/restore/{id}'''
! colspan="2" style="width: 85%" |Откат рабочей версии из бэкапа. Резервная копия становится рабочей, и удаляется, а черновик остается без изменений
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/add/{robot}'''
! colspan="2" style="width: 85%" | Добавление нового скрипта. Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами скрипта
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/script/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление скрипта
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение текста скрипита
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "data": {

 "id": "6a9f91b6-9634-4079-ac2b-60a944922c61",

"type": "Тип скрипта",

 "name": "Наименование скрипта",

 "code": "Текст скрипта" }

}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка скриптов
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |[ { "id": "9b9d83b7-d5c3-49e6-9bd4-a123a9047939", "name": "наименование1",

 "type": "Тип скрипта"},

 { "id": "48b508ba-a32b-4ada-bcc3-66ce26d81c6a",

 "name": "наименование2",

 "type": "Тип скрипта"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение скрипта.Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор скрипта
* '''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/test/{robot}/{id}'''
! colspan="2" style="width: 85%" |Тестирование скрипта. Формат '''data''' как в ответе метода '''GET/ses/session/{robot_id}/{session_id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка с параметрами сессии
*'''id''' - идентификатор скрипта
*'''robot''' - идентификатор робота
| style="width: 50%" |<nowiki>{"error": 0, "message": "success", "result": {.....}, "variables": {}}</nowiki>
|-
! style="color:blue;width: 15%" |'''POST/ses/robot/userdata/data/add/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление записи в пользовательский справочник.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "id": "id записи"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/data/delete/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" | Удаление записи из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/data/list/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Получение данных из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |[{ "колонка 1": "значение 1", "колонка n": "значение n", "id": "id записи"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Массовое изменение данных в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" |Изменение одной записи пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" | '''POST/ses/robot/userdata/data/put/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление данных с заменой в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code> Поле "id" опционально, при его добавлении данные в строке будут заменены.
*'''replace''' - замена всех данных в справочнике новыми данными. Возможные значения: yes/no. По-умолчанию - yes.
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"id": "id справочника", "name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code> Поле "id" опционально.
*'''robot''' - идентификатор робота (id)
| style="width: 50%" | {"error": 0, "id": "id справочника"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/structure/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
* '''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/structure/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка пользовательских справочников.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
| style="width: 50%" |<nowiki>[{"id": "id справочника", "name": "справочник", "fields": {"колонка1": "значение по умолчанию"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Модификация структуры пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code>
*'''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/session/{robot_id}/{session_id}'''
! colspan="2" style="width: 85%" |Выдает параметры сессии. Для отображения на боковой панели тестирования в UPS. Основные блоки результата:
|-
| colspan="2" style="width: 50%" |
*'''robot_id''' — id робота

*'''session_id''' — id незакрытой сессии
| style="width: 50%" |{ "started": "", "modified": "",

 "robot": "",

 "session": "",

 "channel": "",

 "connector": "",

 "unknown": true/false,

 "current": {"id": "", "qas": "", "answered": true/false, "category": "",

 "nearest": "", "entry": [.....], "missingRunData": [],

 "passedRunData": [.....], "waitingRunData": null,

 "border": int, "preborder": int, "lastreply": ""},

 "models": [.....],

 "scripts": [.....],

<nowiki> "data": [{"request": {.....}, "reply": {.....}}],</nowiki>

 "timers": [],

 "variables": {},

 "error": "",

 "events": {.....},

 "closed": "" }
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/config'''
! colspan="3" style="width: 85%" |Выдает параметры виджета для web канала по запросу js скрипта
|-
| colspan="2" style="width: 50%" |
*'''token''' — уникальный код виджета, создается при внедрении
| colspan="2" style="width: 50%" |Состав конфига канала, для передачи виджету. Подробней в [https://wiki.connect2ai.net/index.php/SES._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%B2%D0%B8%D0%B4%D0%B6%D0%B5%D1%82%D0%B0_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B0%D0%B9%D1%82%D0%B0 Руководстве администратора]
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/js'''
! colspan="3" style="width: 85%" |Выдает код js скрипта виджета для web-канала
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |Код скрипта
|}

====='''/res: методы работы с сервисом отчетов'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! style="color:blue;width: 15%" |'''GET/res/dashboards'''
! colspan="3" style="width: 85%" |Получить список рабочих столов kibana с наборами отчетов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |{ "error": 0, "message": "success",

 "dashboards": {

"Наименование1": "https://........",

<nowiki>"Наименование2": "https://........." }}</nowiki>
|}

====='''/transcription: методы работы со стенографией'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/transcription/audio/{id}'''
! colspan="3" style="width: 85%" |Получить аудиофайл по id стенограммы. Идентификатор нужной стенограммы можно получить методом
"GET /transcription/list"
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |wav файл сохраненной стенограммы
|-
! style="color:green;width: 15%" |'''POST/transcription/create'''
! colspan="3" style="width: 85%" |Создание стенограммы из завершенного задания в очереди распознавания. В ответ придет id созданной стенограммы
|-
| colspan="2" style="width: 50%" |
*'''taskID''' — идентификатор задания из очереди

*'''name''' — имя создаваемой стенограммы
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"id": "74721a3b-9055-4650-9afb-de4d103cafc7"}
|-
! style="color:red;width: 15%" |'''DELETE/transcription/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление стенограммы
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/get/{id}'''
! colspan="3" style="width: 85%" |Получение стенограммы. Используется для отображения стенограммы в веб интерфейсе
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |стенограмма в json формате
|-
! style="color:blue;width: 15%" |'''GET/transcription/list'''
! colspan="3" style="width: 85%" |Получение списка сохраненных стенограмм
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ { "id": "926e8d25-4275-4a78-906b-a1109cdacbea",

"name": "название",

"model": "big",

"created": "2024-03-29 12:37:42",

"modified": "2024-04-24 16:09:09",

"user": "0",

"dataset": "0" }, .... ]
|-
! style="color:green;width: 15%" |'''POST/transcription/save/{id}'''
! colspan="3" style="width: 85%" |Сохранение стенограмы. Используется для сохранения изменений по нажатию кнопки «Сохранить».
|-
| colspan="2" style="width: 50%" |
*'''data''' — стенограмма в json формате

*'''id''' стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/waveform/{id}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, ответ содержит пики сигнала
|-
| colspan="2" style="width: 50%" |
*'''id''' стенограммы
| colspan="2" style="width: 50%" |{ "error": 0,

"waveform": [

 0.016,

 ..........

 ..........

 0.015,

 0.01 ] }
|}

QAS. Руководство пользователя

2025-10-22T09:54:52Z

VoroninE: изменения методов

==== '''В Общее описание''' ====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.

==== '''Термины и определения''' ====
Question Answering System (QAS) – сервис ответов на вопросы.

==== '''Описание методов API''' ====
Сервис QAS доступен по протоколу HTTP 1.1 через порт 6187/tcp. Авторизация не требуется, но все запросы должны содержать заголовок «accept: application/json». Ответ сервиса возвращается в формате JSON. Если произошла ошибка, возвращается переменная «error=1» и описание ошибки в переменной «message». Для удобства тестирования и использования методов сервиса по адресу <nowiki>http://АДРЕС:6187</nowiki> доступен интерфейс Swagger, который позволяет просматривать и тестировать все доступные методы из таблицы ниже.

{| class="wikitable" style="width: 110%"
|+''Методы API''
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов qas</big>'''
|-
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе.
Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст вопроса, на основе которого будут искаться фрагменты.
* '''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
* '''channel''' — id канала
* '''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

* '''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
* '''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''similarityArea''' — определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{
"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:green;width: 15%" |'''POST/qas/autocache'''
! colspan="2" style="width: 85%" |Добавление вопросно-ответной пары в кэш.
В случае указания id answer будет принудительно добавлен в вопрос с указанным id. Если же указан question, то система сначала попытается найти похожий вопрос и добавить ответ в него, если же вопрос не будет найден, то система создаст новый с указанной формулировкой. При установке флага emptyQuestion будет добавлен только вопрос (без ответа).
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса
*'''category''' — категория
*'''channel''' — канал
*'''answer''' — ответ
*'''emptyQuestion''' — yes или no, флаг добавления вопроса без указания ответа
*'''checked''' — yes или no, флаг добавления вопроса как «проверенного»
*'''id''' — код существующего вопроса
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' — категория для которой генерируются ответы, если указан код категории, то генерация только для этой категории

*'''mode''' — режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' — генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' — {all | empty} обработать все вопросы или только не содержащие ответов

*'''variants''' — количество ответов, от 1 до 9
*'''replace''' — заменить ответы на сгенерированные
*'''maxDocs''' — максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' — какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' — ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше.

статусы: '''started''', '''stopped''', если были ошибки поле ответа

'''error''' будет содержать код ошибки
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33 }
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" style="width: 85%" |Произвольный запрос в LLM.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Пример ответа на вопрос "как пройти в библиотеку"

{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc/start'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/stop'''
| colspan="2" |Остановка очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''user_id''' - ID пользователя
|{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/status'''
| colspan="2" |Статус очистки документа для конкретного пользователя
|-
| colspan="2" |
* '''user_id''' - ID пользователя
|{
"error": 0,

"status": stopped | started,

"progress": 33.3,

"message": string,

"place": number, #место в очереди

"queue": True | False #состояния - в очереди или в процессе очистки

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cleandoc/result'''
| colspan="2" |Результат очистки документа для конкретного пользователя
|-
| colspan="2" |
*'''doc_id''' - необязательный параметр, ID документа
*'''user_id''' - ID пользователя
|{"error": 0,"status": "stopped","text": "очищенный текст","doc_id": "ID документа"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
| colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success",
 "models": ["default" ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :

массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" |Старт массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |
* '''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке

| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" | Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" | Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM для анализа на несоответствия, необязательный параметр
*'''asktemplate''' - ID шаблона запроса к LLM для генерации ответов по документу, необязательный параметр
*'''answers''' - тип вопросов, по которым осуществляется поиск несоответствий, необязательный параметр, по умолчанию «all»
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" | Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при поиске ответа на вопрос, по умолчанию 1
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,
 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
* '''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0,

 "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
*'''answers''' - тип вопросов, по которым осуществляется поиск для внесения правок, необязательный параметр, по умолчанию «all»
|{"error": 0,
"message": "success",

"docs": [],

"answers": []

}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов channel</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |'''name''' — наименование канала
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" | Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,
 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов category</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |обавить категорию с указанным именем. В ответе - id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов doc</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе - id созданного документа или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор документа
| style="width: 50%" |{
 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:
{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" | Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="3" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

* '''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="3" | Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов question</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" | Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

* '''aliases''' - вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' — JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов.
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" |Получение вопроса вместе с ответами и синонимами вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,
 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" |Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов
*category — фильтр категорий

*'''answer''' — фильтр ответов
*'''created''' — фильтр по дате создания, оставляет вопросы, созданные '''не ранее''' указанной даты
*'''createdBefore''' — фильтр по дате создания, оставляет вопросы, созданные '''не позже''' указанной даты
*'''modified''' — фильтр по дате изменения, оставляет вопросы, '''изменённые в точности''' в указанную дату
*'''onlyNew''' - фильтр, оставляющий только новые (необработанные) вопросы
| style="width: 50%" |{ "error": 0,
 "questions": [

 { "id": "77b42c9b-2075-4a5f-b6d9-a284bba7cf43",

 "question": "вопрос",

 "category": "9580b3b7-34cb-4d0e-ba75-d17313ead16d" },

 { "id": "d1836e5e-010e-4f3a-b306-813c3acb7efb",

 "question": "n-й второй вопрос",

 "category": "7d8a3415-cb09-4dad-a169-478ba15ade47" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="3" style="width: 85%" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="3" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''answers''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов summarization_template</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов prompt</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0,

 "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
|{ "error": 0,

 "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:

<code>{ "name": "новое имя" }</code>

*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|}

QAS. Руководство администратора

2025-10-22T06:07:16Z

VoroninE: добавлена alpha в qas

====='''Общее описание'''=====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.
====='''Термины и определения'''=====
Question Answering System (QAS) – сервис ответов на вопросы.

====='''Системные требования'''=====
Для нормальной работы сервиса без GPU необходимо не менее 8 CPU (минимальные требования для использования метода ask) >= 2.20 GHz с поддержкой инструкций AVX2 или новее:
*Intel Haswell
*Intel Broadwell
*Intel Skylake
*Intel Kaby Lake
*Intel Coffee Lake
*Intel Comet Lake
*Intel Rocket Lake
*Intel Alder Lake
*AMD Excavator
*AMD Zen (AMD Ryzen)
*AMD Zen 2 (AMD Ryzen)
*AMD Zen 3 (AMD Ryzen)
Работа на CPU при использовании метода ask крайне не рекомендуется. Оперативной памяти необходимо не менее 16Gb для работы без GPU.

====='''Установка/обновление сервиса'''=====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/qas&fileid=26891 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление QAS осуществляется скриптом <code>chmod +x ./qas-<версия>-<релиз>.sh && ./qas-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./qas-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s https://repo.connect2ai.net/api/qas --user '[user]:[pass]' 2>&1)"</code>.
* Обновить QAS <code>/opt/qas/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/qas/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/qas/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/qas/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Установить модели <code>/opt/qas/inmodel</code> в интерактивном режиме.
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/qas/.userapi (это файл авторизации в API, нужен для обновления и загрузки моделей)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/qas/.proxy (это файл конфигурации proxy, необходим для обновления и загрузки моделей, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable qas.service && sudo systemctl start qas.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status qas.service</code>

Разрешите доступ к порту 6187 на нужном интерфейсе по протоколу tcp.

===== '''Лицензия''' =====
Сервис не функционирует без действующей лицензии. Информация о лицензии хранится в файле:

<code>/opt/qas/license.json</code>

Файл лицензии должен соответствовать следующему формату:

<code>{"service": "qas", "expire": "2045-01-01", "licenses": , "key": ""}</code>

Для получения лицензии необходимо:

1. Запустить сервис <code>systemctl start qas</code> и извлечь UUID, указанный в файле <code>/opt/qas/logs/log.txt</code>

2. Передать полученный UUID руководителю проекта для оформления лицензии.

====='''Установка моделей'''=====

В составе QAS используются модели векторизации, и генеративные модели LLM.

Модели векторизации располагаются в папках:

* /opt/qas/pretrained/embeddings/questions - для работы с кэшем вопросов
* /opt/qas/pretrained/embeddings/docs - для работы с документами
* /opt/qas/pretrained/embeddings/rerank - для реранжирования документов

Расположение моделей LLM: /opt/qas/pretrained/gpt/<имя_модели>/. Например , встроенная модель LLM: /opt/qas/pretrained/gpt/default/. Модели после установки QAS должны быть добавлены системным администратором.

QAS допускает использование дополнительных моделей LLM. Каждая из таких моделей должна быть в отдельной папке каталога /opt/qas/pretrained/gpt/<имя_модели>/. Если модель формата GGUF, то достаточно поместить ее в свою папку в /opt/qas/pretrained/gpt/. В остальных случаях (в том числе и если необходимо обращаться к стороннему api) в папке модели должен быть файл handler.py с функцией handler(prompt='тут текст',params={параметры запроса, см. в руководстве пользователя в метода добавления шаблона запроса}), которая возвращает сгенерированный текст.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы:

* База файловая, в папке data.
* lsync настроен через конфиг QAS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах прописан в конфиге master, чтобы все операции добавления и изменения данных при автокешировании они производили через мастер. Параметр в конфиге questions.master, на мастере значение «<nowiki>http://127.0.0.1:6187»</nowiki>.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером QAS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.qas.trainer указываем мастер-сервер, в servers.qas.cluster перечисляем все сервера кластера QAS, в том числе и мастер.

===== '''Конфигурирование параметров сервиса''' =====
Настройка параметров сервиса qas производится в файле /opt/qas/config.json.

Описание параметров приведено в таблице.
{| class="wikitable"
|+
!style="width: 20%"|Параметр
!По умолчанию
!Назначение
|-
|reloader.period
|60
|Период обновления векторов базы вопросов и документов.
|-
|gpt.instances
|1
|Количество экземпляров встроенной нейросети
|-
|gpt.gpu_layers
|12
|Количество слоёв встроенной нейросети.
|-
|gpt.context
|32768
|Размер контекста встроенной нейросети.
|-
|logs.path
|logs/
|Папка для хранения логов. Примеры абсолютного пути: "/var/log/qas/".
|-
|logs.backups
|10
|Количество файлов ротации.
|-
|logs.maxSize
|5242880
|Максимальный размер файла в байтах, триггер для ротации.
|-
|cache.size
|2560000
|Максимальный размер кэша векторов
|-
|cache.update
|3600
|Период сохранения кэша на диск (секунды)
|-
|fragments.context
|16384
|Максимальная длина текста, которая будет подана в генератор для поиска ответа на вопрос.
|-
|fragments.threshold
|0.5
|Уровень достоверности при векторном поиске фрагментов в загруженных документах.
|-
|fragments.limit
|1
|Максимальное количество фрагментов, которые должны быть найдены в документах в порядке убывания доверия.
|-
|fragments.alpha
|0.5
|Уровень доверия к модели векторизации
|-
|questions.master
|"<nowiki>http://127.0.0.1:6187</nowiki>"
|Адрес мастер-сервера для работы в кластере. Необходим, чтобы добавленные вопросы распространились на серверы кластера.
|-
|questions.threshold
|0.9
|Минимальный уровень достоверности ответа для попадания в кеш.
|-
|cluster.logfile
|logs/sync.log
|Расположение лог-файла синхронизации (актуально для мастер-сервера).
|-
|cluster.logfile
|logs/sync.status
|Расположение файла статуса lsyncd (актуально для мастер-сервера)
|-
|cluster.nodes
|[ ]
|Ноды кластера, на которые с мастер-сервера будут распространяться изменения.
|}

===== '''Сбор данных об ошибках''' =====
Логи сервиса по умолчанию находятся в файле /opt/qas/logs/log.txt

====='''Удаление'''=====
Для удаления выполните команду: <code>/opt/qas/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

QAS. Руководство администратора

2025-10-21T15:20:25Z

VoroninE: добавлена модель реранжирования

====='''Общее описание'''=====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.
====='''Термины и определения'''=====
Question Answering System (QAS) – сервис ответов на вопросы.

====='''Системные требования'''=====
Для нормальной работы сервиса без GPU необходимо не менее 8 CPU (минимальные требования для использования метода ask) >= 2.20 GHz с поддержкой инструкций AVX2 или новее:
*Intel Haswell
*Intel Broadwell
*Intel Skylake
*Intel Kaby Lake
*Intel Coffee Lake
*Intel Comet Lake
*Intel Rocket Lake
*Intel Alder Lake
*AMD Excavator
*AMD Zen (AMD Ryzen)
*AMD Zen 2 (AMD Ryzen)
*AMD Zen 3 (AMD Ryzen)
Работа на CPU при использовании метода ask крайне не рекомендуется. Оперативной памяти необходимо не менее 16Gb для работы без GPU.

====='''Установка/обновление сервиса'''=====
[https://cloud.connect2ai.net/index.php/apps/files/?dir=/qas&fileid=26891 Дистрибутив] распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление QAS осуществляется скриптом <code>chmod +x ./qas-<версия>-<релиз>.sh && ./qas-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./qas-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s https://repo.connect2ai.net/api/qas --user '[user]:[pass]' 2>&1)"</code>.
* Обновить QAS <code>/opt/qas/inupdate</code> в интерактивном режиме. Или запустить с ключом:
** <code>/opt/qas/inupdate -b</code> – обновить до последней beta версии;
** <code>/opt/qas/inupdate -r</code> – обновить до последней release версии;
** <code>/opt/qas/inupdate -n</code> – обновить до последней версии (неважно beta или release).
* Установить модели <code>/opt/qas/inmodel</code> в интерактивном режиме.
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/qas/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''https://repo.connect2ai.net/api'''. <code>[user]:[pass]</code> – это тот же логин и пароль, что и от [https://cloud.connect2ai.net '''Nextcloud'''.]
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/qas/.userapi (это файл авторизации в API, нужен для обновления и загрузки моделей)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/qas/.proxy (это файл конфигурации proxy, необходим для обновления и загрузки моделей, при отсутствующем прямом подключении к интернету)

При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable qas.service && sudo systemctl start qas.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status qas.service</code>

Разрешите доступ к порту 6187 на нужном интерфейсе по протоколу tcp.

===== '''Лицензия''' =====
Сервис не функционирует без действующей лицензии. Информация о лицензии хранится в файле:

<code>/opt/qas/license.json</code>

Файл лицензии должен соответствовать следующему формату:

<code>{"service": "qas", "expire": "2045-01-01", "licenses": , "key": ""}</code>

Для получения лицензии необходимо:

1. Запустить сервис <code>systemctl start qas</code> и извлечь UUID, указанный в файле <code>/opt/qas/logs/log.txt</code>

2. Передать полученный UUID руководителю проекта для оформления лицензии.

====='''Установка моделей'''=====

В составе QAS используются модели векторизации, и генеративные модели LLM.

Модели векторизации располагаются в папках:

* /opt/qas/pretrained/embeddings/questions - для работы с кэшем вопросов
* /opt/qas/pretrained/embeddings/docs - для работы с документами
* /opt/qas/pretrained/embeddings/rerank - для реранжирования документов

Расположение моделей LLM: /opt/qas/pretrained/gpt/<имя_модели>/. Например , встроенная модель LLM: /opt/qas/pretrained/gpt/default/. Модели после установки QAS должны быть добавлены системным администратором.

QAS допускает использование дополнительных моделей LLM. Каждая из таких моделей должна быть в отдельной папке каталога /opt/qas/pretrained/gpt/<имя_модели>/. Если модель формата GGUF, то достаточно поместить ее в свою папку в /opt/qas/pretrained/gpt/. В остальных случаях (в том числе и если необходимо обращаться к стороннему api) в папке модели должен быть файл handler.py с функцией handler(prompt='тут текст',params={параметры запроса, см. в руководстве пользователя в метода добавления шаблона запроса}), которая возвращает сгенерированный текст.

====='''Работа в составе кластера'''=====

Для высоконагруженных систем сервис можно расположить на нескольких нодах (виртуальных машинах). В этом случае, чтобы не потерять документы и изменения, полученные на одной из нод, выделяется один основной сервис и вспомогательные сервисы:

* База файловая, в папке data.
* lsync настроен через конфиг QAS для репликации базы на все указанные серверы в списке cluster.nodes: [], указываем все слейв-сервера.
* На всех слейвах прописан в конфиге master, чтобы все операции добавления и изменения данных при автокешировании они производили через мастер. Параметр в конфиге questions.master, на мастере значение «<nowiki>http://127.0.0.1:6187»</nowiki>.
* Векторная база на каждом сервере своя, она следит за своей папкой data и обновляет в оперативке по этой папке данные у себя.
* UPS при изменении данных работает только с мастером QAS, а при запросе данных — со всеми серверами cluster, распределяя нагрузку.
* В конфигурации UPS: в servers.qas.trainer указываем мастер-сервер, в servers.qas.cluster перечисляем все сервера кластера QAS, в том числе и мастер.

===== '''Конфигурирование параметров сервиса''' =====
Настройка параметров сервиса qas производится в файле /opt/qas/config.json.

Описание параметров приведено в таблице.
{| class="wikitable"
|+
!style="width: 20%"|Параметр
!По умолчанию
!Назначение
|-
|reloader.period
|60
|Период обновления векторов базы вопросов и документов.
|-
|gpt.instances
|1
|Количество экземпляров встроенной нейросети
|-
|gpt.gpu_layers
|12
|Количество слоёв встроенной нейросети.
|-
|gpt.context
|32768
|Размер контекста встроенной нейросети.
|-
|logs.path
|logs/
|Папка для хранения логов. Примеры абсолютного пути: "/var/log/qas/".
|-
|logs.backups
|10
|Количество файлов ротации.
|-
|logs.maxSize
|5242880
|Максимальный размер файла в байтах, триггер для ротации.
|-
|cache.size
|2560000
|Максимальный размер кэша векторов
|-
|cache.update
|3600
|Период сохранения кэша на диск (секунды)
|-
|fragments.context
|8192
|Максимальная длина текста, которая будет подана в генератор для поиска ответа на вопрос.
|-
|fragments.threshold
|0.6
|Уровень достоверности при векторном поиске фрагментов в загруженных документах.
|-
|fragments.limit
|1
|Максимальное количество фрагментов, которые должны быть найдены в документах в порядке убывания доверия.
|-
|questions.master
|"<nowiki>http://127.0.0.1:6187</nowiki>"
|Адрес мастер-сервера для работы в кластере. Необходим, чтобы добавленные вопросы распространились на серверы кластера.
|-
|questions.threshold
|0.9
|Минимальный уровень достоверности ответа для попадания в кеш.
|-
|cluster.logfile
|logs/sync.log
|Расположение лог-файла синхронизации (актуально для мастер-сервера).
|-
|cluster.logfile
|logs/sync.status
|Расположение файла статуса lsyncd (актуально для мастер-сервера)
|-
|cluster.nodes
|[ ]
|Ноды кластера, на которые с мастер-сервера будут распространяться изменения.
|}

===== '''Сбор данных об ошибках''' =====
Логи сервиса по умолчанию находятся в файле /opt/qas/logs/log.txt

====='''Удаление'''=====
Для удаления выполните команду: <code>/opt/qas/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.

SBS. Руководство пользователя

2025-08-27T08:46:21Z

VoroninE: параметр мультиспикеров в sbs

===== '''Общее описание''' =====
Сервис Simple Biometry Server предназначен для извлечения именованных сущностей из текстовых фрагментов (фраз естественной речи). Принимает на вход текстовую строку и возвращает структурированные данные в формате JSON.

===== '''Термины и определения''' =====
Simple Biometry Server (SBS) — сервис извлечения метаданных.

Swagger UI — интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису SBS.

===== '''Описание методов API сервиса биометрии (SBS)''' =====
Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6185/tcp.

Авторизация запросов не требуется. HTTP-запросы должны содержать заголовок <code>"accept: application/json"</code>

Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке <nowiki>http://АДРЕС:6185</nowiki> будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 50%" |
* '''wav''' — файл для анализа.
| colspan="2" style="width: 50%" |Пример:
<code>{</code>

<<age: {
class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}
confidence: 0.99
},
emotion: {
class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR",

<<"NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}
confidence: 0.99
},
gender: {
class: FEMALE, # { "MALE", "FEMALE" }
confidence: 0.99
},

multispeaker : {

class: YES, # { "YES", "NO" }

confidence: 0.99

}

<code>}</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:

<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 50%" |
* '''wav''' — файл для анализа
*'''threshold''' — порог совпадения спикера, от 0 до 1
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 50%" |Пример ответа:

<code>{ error: 0, speaker: Ivan, confidence: 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для поиска
*'''id''' — идентификатор говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет проверен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 50%" | <code>{ "error": 0, "confidence": 0.78 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 50%" |<code>{</code>

<code> "error": 0,</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"</code>

<code>}</code>
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 50%" |<code>{ error: INT, message: DESCRIPTION }</code>
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |<code>[</code>
<code> {</code>

<code> "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",</code>

<code> "name": "наименование слепка"</code>

<code> }</code>

<code>]</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 50%" |
*'''wav''' — файл для обучения

*'''id''' '''—''' идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от '''text.'''
*'''textSimilarity''' - порог похожести текста и распознанного аудио
| colspan="2" style="width: 50%" |<code>{</code>
<code> "error": 0,</code>

<code> "message": "Success"</code>

<code>}</code>
|}

UPS. Описание API

2025-07-28T12:49:51Z

VoroninE: добавление similarityArea в ups

===== '''Описание часто используемых параметров''' =====
{| class="wikitable"
|+
!Параметр
!Тип
!Описание
|-
|'''servicetype'''
|запрос
|Тип сервиса. Возможные значения: spr, smc, see, sbs, tts.
|-
|'''servertype'''
|запрос
|Тип группы серверов. Возможные значения: trainer (серверы обучения), cluster (рабочие серверы).
|-
|'''model'''
|запрос
|Название модели.
|-
|'''modeltype'''
|запрос
|Тип модели. Возможные значения: '''future''' — планируемая/черновик, '''current''' — текущая/рабочая, '''previous''' — архивная.
|-
|'''error'''
|ответ
|Флаг ошибки.
|-
|'''message'''
|ответ
|Информационное сообщение.
|}

===== '''"/external modules" методы внешних модулей''' =====

В этом разделе будут методы соответствующим образом оформленных [[UPS. Руководство администратора#Установка модулей для UPS|внешних модулей]]

===== '''/auth: методы авторизации''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/auth/access'''
! colspan="3" style="width: 85%" |Получение токенов доступа. Токен доступа определяет, какие из методов будут доступны конкретному пользователю. Формируется на основании роли. Дополнительный входной параметр во всех методах, кроме перечисленных в разделе «nopassword» конфигурационного файла. Время действия токена определяется параметром auth.accessLifeTime конфигурационного файла.
|-
|colspan="2" style="width: 50%" |
* '''username''' — логин

* '''password''' — пароль
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/add'''
! colspan="3" style="width: 85%" |Добавление dataset (набора данных). Dataset (набор данных) используется для ограничения доступа к данным. В ответе метод вернет id созданного набора данных.
|-
|colspan="2" style="width: 50%" |
* data — json строка вида: { "name": "название нового набора" }
|colspan="2" style="width: 50%" |{

"error": 0

"message": "success",

"dataset_id": "XXXXXXXXXXXXX"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/dataset/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление dataset (набора данных).
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:green;width: 15%" |'''POST/auth/dataset/modify/{id}'''
! colspan="3" style="width: 85%" |Переименование dataset (набора данных). Метод меняет все параметры набора данных, но на данный момент времени у набора данных, кроме id, только один параметр — наименование.
|-
|colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора данных
* '''data''' — JSON c новыми параметрами
|colspan="2" style="width: 50%" |{

"error": 0,

"message": "success"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/datasets'''
! colspan="3" style="width: 85%" |Получение списка наборов данных.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXXXXXXXXXX",

"name": "XXX"},

{"id": "0",

"name": "По умолчанию"}

]
|-
!style="color:blue;width: 15%" |'''GET/auth/refresh'''
! colspan="3" style="width: 85%" |Обновление токенов доступа. Время, в течение которого можно обновить доступ, регулируется параметром auth.refreshLifeTime конфигурационного файла. Служебный метод, используется в основном в веб-интерфейсе, чтобы не запрашивать лишний раз пароль.
|-
|colspan="2" style="width: 50%" |
* '''x-refresh-token''' — токен обновления доступа
|colspan="2" style="width: 50%" |{

"x-access-token": "XXXXXXXXXXXXXXXXXXXX",

"x-refresh-token": "XXXXXXXXXXXXXXXXXXXX"

}
|-
!style="color:blue;width: 15%" |'''GET/auth/rights'''
! colspan="3" style="width: 85%" |Получение списка прав доступа. Служебный метод — по токену получает название роли и все права доступа этой роли, а также общедоступные методы.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |<<<{ "РОЛЬ": [

 "GET:/......" ],

 "nopassword": [ "GET:/.......",

...............

<<<...............

 "POST:/......." ] }
|-
!style="color:green;width: 15%" |'''POST/auth/role/add'''
! colspan="3" style="width: 85%" |Создание роли. Служебный метод — используется веб-интерфейсом при создании роли.
|-
|colspan="2" style="width: 50%" |
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{

"error": 0, "message": "success", "role_id": "a7e68bb83169f864c2fc868401b5250c"

}
|-
!style="color:red;width: 15%" |'''DELETE/auth/role/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление роли.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/role/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение роли. Параметры как при создании роли. Роль будет переписана.
|-
|colspan="2" style="width: 50%" |
* '''id''' роли
* '''data''' — JSON с параметрами роли:{

"name": "проверка создания",

"rights": [ "набор прав через запятую" ]

}
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/roles'''
! colspan="3" style="width: 85%" |Получение списка ролей.
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[{

"id": "XXXXXXXXXXX",

"name": "имя роли",

"rights": [ "набор прав через запятую" ]

},............]
|-
!style="color:green;width: 15%" |'''POST/auth/user/add'''
! colspan="3" style="width: 85%" |Создание нового пользователя. Метод вернет или id нового пользователя или описание ошибки
|-
|colspan="2" style="width: 50%" |
* '''data''' — json строка {

"username": "login_name", "fullname": "Отображаемое Имя","password": "XXXXX","role": "role_id",

"dataset": "default dataset id", "datasets": [ "dataset id", ................. ] }
|colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"user_id": "XXXXXXXXXXXXXXXX"}
|-
!style="color:red;width: 15%" |'''DELETE/auth/user/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' - идентификатор пользователя
|colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/auth/user/get/{id}'''
! colspan="3" style="width: 85%" |Получение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''user_id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2" ] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/info'''
! colspan="3" style="width: 85%" |Получение параметров пользователя по его токену доступа. Служебный метод - для предоставления прав текущему пользователю по его токену
|-
|colspan="2" style="width: 50%" |
* '''x-access-token'''
|colspan="2" style="width: 50%" |{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] }
|-
!style="color:blue;width: 15%" |'''GET/auth/user/list'''
! colspan="3" style="width: 85%" |Получение списка пользователей с их параметрами. Тоже самое что и в методе GET /auth/user/info, только для всех пользователей
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |[

{"id": "XXXXXXXXXX",

"username": "loginname",

"fullname": "Full Name",

"role": "0",

"dataset": "0",

"datasets": [ "0", "2dc34d3454243522e5407d3a170815a2"] }, "rights": [..........] },

......

]
|-
!style="color:green;width: 15%" |'''POST/auth/user/modify/{id}'''
! colspan="3" style="width: 85%" |Изменение параметров пользователя
|-
|colspan="2" style="width: 50%" |
* '''data''' — параметры пользователя как при создании
* '''id''' — идентификатор пользователя
|colspan="2" style="width: 50%" |{ "error": 0,

"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/user/password'''
! colspan="3" style="width: 85%" |Смена пароля пользователя по его токену доступа.
|-
|colspan="2" style="width: 50%" |
* '''password'''
|colspan="2" style="width: 50%" |{ "error": 0,"message": "success"}
|-
!style="color:green;width: 15%" |'''POST/auth/userlog'''
! colspan="3" style="width: 85%" |Получение действий пользователя за период времени по его токену
|-
|colspan="2" style="width: 50%" |
* '''from''' — начало периода в формате "%Y-%m-%d %H:%M"

* '''to''' — конец периода в формате "%Y-%m-%d %H:%M"
|colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "data": [

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 [

 "время",

 "id",

 "метод",

 {измененные данные в формате метода}

 ],

 .........

}
|-
!style="color:blue;width: 15%" |'''GET/auth/version'''
! colspan="3" style="width: 85%" |Получение версии сервиса ups
|-
|colspan="2" style="width: 50%" |Нет входных параметров
|colspan="2" style="width: 50%" |{

 "version": "4.082 release"

}
|}

===== '''/lang: методы мультиязычности''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/lang/'''
! colspan="3" style="width: 85%" |Выводит информацию о переводе элементов интерфейса на текущий язык
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "see":"Сущности",

"smc":"Классификатор",

... }
|-
!style="color:blue;width: 15%" |'''GET/lang/wallpaper'''
! colspan="3" style="width: 85%" |Отдает случайный фон рабочего стола в виде jpeg из каталога «wallpapers» на сервере ups
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |image/jpeg
|}

===== '''/server: получение информации о серверах''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |GET/server/get/addresses/{servicetype}
! colspan="3" style="width: 85%" |Вывод информации о серверах, обслуживающих данный сервис, а также настроенных параметров обращения к данным серверам.
'''trainer''' — сервер обучения, '''cluster''' — рабочие серверы, '''connect''' — время на подключение, '''read''' — время на ответ,

'''failed''' — время пребывания в сбойных, '''install''' — время на установку модели, '''info''' — время на получение информации о модели,

'''counter''' — счетчик запросов, '''current''' — индекс последнего опрошенного cluster-сервера

'''fail''' — массив сбойных серверов со временем постановки в сбой.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "trainer": "<nowiki>http://127.0.0.1:6181</nowiki>",

 "cluster": [ "<nowiki>http://127.0.0.1:6181</nowiki>" ],

 "timers": { "connect": 0.5,

 "read": 1,

 "failed": 600,

 "install": 60,

 "info": 3 },

 "counter": 0,

 "current": 0,

 "fail": {"<nowiki>http://127.0.0.1:6181</nowiki>":1686295678} }
|-
!style="color:blue;width: 15%" |GET/server/get/models/{servicetype}/{servertype}
! colspan="3" style="width: 85%" |Вывод информации о моделях указанного сервиса на каждом сервере указанного типа. Вывод представляет собой массив URL-серверов, для каждого из которых указан список моделей.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса

* '''servertype''' — тип серверов
| colspan="2" style="width: 50%" |{ "<nowiki>http://127.0.0.1:6181</nowiki>": [

 "model1",

 ...

 "modelN"

 ], ... }
|}

===== '''/model: методы работы с моделями''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/model/add/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Создание пустой модели в указанном сервисе. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 30%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 70%" |{

"error":0,

"message":"success"

}
|-
!style="color:green;width: 15%" |'''POST/model/apply/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Применение установленной на рабочих серверах модели. После применения модель становится доступна для штатного режима работы. Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:red;width: 15%" |'''DELETE/model/delete/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Полностью удаляет модель из системы и со всех управляемых серверов. Доступно для следующих сервисов: smc, see, spr.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/errors/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Запрос на получение списка ошибок модели после тестирования/обучения. Доступен для сервисов see и smc. Ответ содержит список вложенных списков. В каждом три значения: правильное значение, предсказанное моделью значение и начальные данные (фраза).
|-
| colspan="2" style="width: 50%" |
* '''type''' — тип ошибок в выводе
'''- train''' ошибки обучения

'''- test''' ошибки тестирования

'''- mark''' ошибки авторазметки
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[ [true, predicted, phrase],

... ]
|-
!style="color:blue;width: 15%" |'''GET/model/export/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Экспорт модели, модель скачивается в виде zip-архива.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл model.zip, где model — название модели
|-
! style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Удаление постобработчика из модели типа future. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель типа future. Обработчик становится активным сразу после успешной отправки. Более подробно об обработчике см. руководства пользователя [[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из модели типа future.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:red;width: 15%" |'''DELETE/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Удаление постобработчика в указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:green;width: 15%" |'''POST/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Отправка файла-постобработчика в указанную модель указанного типа. Становится активным сразу после успешной отправки.
|-
| colspan="2" style="width: 50%" |
* '''modeltype''' — тип модели
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''handler''' — файл, содержащий программный код python постобработчика
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
! style="color:blue;width: 15%" |'''GET/model/handler/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Получение файла-постобработчика из указанной модели указанного типа.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |Файл handler.py
|-
!style="color:green;width: 15%" |'''POST/model/import/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Импортирует модель в черновик (modeltype=future)
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''zip-model''' — zip с файлами модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}'''
! colspan="3" style="width: 85%" |Получение информации о всех моделях указанного сервиса. Аналогичен методу GET /info/{servicetype}/{model}, но выводит информацию обо всех моделях.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |{ "model1": {

 "previous": null,

 "current": null,

 "future": {

 "status": "empty",

 ...

 } }, ... }
|-
!style="color:blue;width: 15%" |'''GET/model/info/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Получение информации о каждом типе (modeltype) указанной модели. Итоговый массив содержит переменные типа modeltype, в каждой из который содержится информация о модели.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{ "previous": null,

 "current": {

 "status": "trained",

 ... },

 "future": {

 "status": "trained",

 ... } }
|-
!style="color:green;width: 15%" |'''POST/model/install/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Установка импортированной или обученной модели на рабочих серверах.
Доступно для следующих сервисов: '''smc''', '''see''', '''spr'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{

"error":0,

"message":"success"

}
|-
!style="color:blue;width: 15%" |'''GET/model/log/{servicetype}/{model}/{modeltype}'''
! colspan="3" style="width: 85%" |Выводит лог обучения и тестирования модели. Доступно для следующих сервисов: '''smc''', '''see'''.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
* '''modeltype''' — тип модели
| colspan="2" style="width: 50%" |[

 "training",

 "preparing data",

 "tokenizing",

 ...

]
|-
!style="color:green;width: 15%" |'''POST/model/restore/{servicetype}/{model}'''
! colspan="3" style="width: 85%" |Откат модели. Делает текущую рабочую модель черновиком (future), рабочие серверы после выполнения данного метода продолжают уже с возвращенной моделью. Схематично действия над modeltype в результате выполнения данного метода можно представить так:
* '''current -> future'''
* '''previous -> current'''
* '''null -> previous'''
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''model''' — название модели
| colspan="2" style="width: 50%" |{"error":0,

"message":"success"

}
|}

===== '''/corpus: работа с данными для обучения моделей''' =====
Методы данного класса предназначены только для сервисов smc и see

{| class="wikitable" style="width: 110%"
|+
!style="color: blue;width: 15%" |'''GET/corpus/automark/list'''
! colspan="3" style="width: 85%" |Перечень заданий автоматической маркировки корпусов.
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "tasks": [ {

 "id": "29d9da98-d6c1-4dc1-bbc9-111309816002",

 "taskname": "test_doc",

 "status": "finished" },

 { "id": "1a5e9bdc-9f98-49d2-84de-1a9bde8fc37c",

 "taskname": "sssss",

 "status": "finished" } ] }
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/result/{id}'''
! colspan="3" style="width: 85%" |Результат выполнения задания на автомаркировку корпуса. Если задание завершено в ответе придет маркированый корпус и время старта и финиша задания
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{
"error": 0,

"message": "success",

"started": "2024-10-09 18:05:51",

"finished": "2024-10-09 18:05:51",

"corpus": [[ [], [ ["тэг"],"фраза 1"]],

[ [], [["тэг"],"фраза 2"]] ]
}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/start'''
! colspan="3" style="width: 85%" |Начать автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''taskname''' — произвольное имя задания

* '''corpus''' — json строка с размечаемым корпусом[[ [класс1,... классН], текст ],

[ [класс1,... классН], текст ]]

* '''marks''' — json строка с набором меток [ [ метка, [синоним, синоним2 ... синоним Н], порог ],

[ метка, [синоним, синоним2 ... синоним Н], порог ]]

* '''appendMarks''' — "yes" - дополнить разметку, "no" -заменить разметку
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "уникальный id задания"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/status/{id}'''
! colspan="3" style="width: 85%" |Получить статус задания на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — уникальный id задания
| colspan="2" style="width: 50%" |{

 "error": "",

 "status": "finished",

 "started": "2024-10-09 13:49:46",

 "finished": "2024-10-09 13:49:46",

 "progress": 0

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/automark/stop/{id}'''
! colspan="3" style="width: 85%" |Прервать задание на автоматическую разметку корпуса.
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор задания
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: green;width: 15%" |'''POST/corpus/copy/{servicetype}'''
! colspan="3" style="width: 85%" |Копирование корпуса данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: red;width: 15%" |'''DELETE/corpus/delete/{servicetype}'''
! colspan="3" style="width: 85%" |Удаляет корпус с данными
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color: blue;width: 15%" |'''GET/corpus/export/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает текстовый файл с корпусом, содержащий строки вида КЛАСС<TAB>ФРАЗА
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |Файл name.txt
|-
!style="color: blue;width: 15%" |'''GET/corpus/get/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает JSON с данными корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
| colspan="2" style="width: 50%" |<code>[</code>
<code> [ "тэг",</code>

<code> "фраза"</code>

<code> ],</code>

<code> ...</code>

<code>]</code>
|-
!style="color: green;width: 15%" |'''POST/corpus/import/{servicetype}'''
! colspan="3" style="width: 85%" |Метод для импорта корпуса данных. Возможен как из текстового файла со строками вида КЛАСС<TAB>ФРАЗА (доступно для smc и see), так и из логов работы системы (только для smc). Если на вход поступил файл csv, происходит импорт из файла, в противном случае — из логов.
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''csv''' — файл данных
* '''startDate''' — дата начала выборки, YYYY-MM-DD
* '''stopDate''' — дата окончания выборки, YYYY-MM-DD
* '''model''' — имя модели, из логов которой будет произведен импорт
* '''limit''' — числовое ограничение строк импорта
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: blue;width: 15%" |'''GET/corpus/list/{servicetype}'''
! colspan="3" style="width: 85%" |Возвращает список всех корпусов данных для указанного типа сервиса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
| colspan="2" style="width: 50%" |[ "корпус1",

"корпус2",

 ...]
|-
!style="color: green;width: 15%" |'''POST/corpus/put/{servicetype}'''
! colspan="3" style="width: 85%" |Перезаписывает корпус отправленным массивом данных
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''name''' — название корпуса
* '''json''' — строка формата json с данными. Аналогична выводу метода GET /get/{servicetype}
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|-
!style="color: green;width: 15%" |'''POST/corpus/rename/{servicetype}'''
! colspan="3" style="width: 85%" |Переименование корпуса
|-
| colspan="2" style="width: 50%" |
* '''servicetype''' — тип сервиса
* '''srcname''' — текущее имя
* '''dstname''' — новое имя
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success"

}
|}

===== '''/marks: работа с наборами меток в smc''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/marks/add'''
! colspan="3" style="width: 85%" |Добавление набора менток
|-
| colspan="2" style="width: 50%" |
* '''json''' —список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''name''' — имя создаваемого набора
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "success",

 "id": "132310fa-98c7-4b12-896f-ff113827d077"

}
|-
!style="color:red;width: 15%" |'''DELETE/marks/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление набора меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }

|-
!style="color:blue;width: 15%" |'''GET/marks/export/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде строк
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

метка1 синоним1,синоним2,синоним3,синонимN 0.9

меткаN синоним11,синоним21,синоним31,синонимN1 0.9
|-
!style="color:blue;width: 15%" |'''GET/marks/get/{id}'''
! colspan="3" style="width: 85%" |Получение набора меток в виде json
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "data": [

 ["метка1", [ "синоним1", "синоним2", "синоним3", "синонимN" ],

 0.9

 ],

 ["меткаN", ["синоним11","синоним21", "синоним31","синонимN1"],

 0.9

 ] ] }
|-
!style="color:green;width: 15%" |'''POST/marks/import/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из файла. Набор будет переписан из файла
|-
| colspan="2" style="width: 50%" |
* '''csv''' — файл "метка"ТАБ"синонимы через запятую"ТАБ"достоверность(число от 0 до 1)"

* '''id''' — идентификатор набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/marks/list'''
! colspan="3" style="width: 85%" |Получение списка наборов меток
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" |Пример:

{ "error": 0,

 "message": "success",

 "result": [ { "id": "416fbe08-19e9-453c-b140-37008a08a76c","name": "test" },

 {"id": "16e77fa2-7c4d-47f9-8644-6385876525d6","name": "Рыжик" },

 {"id": "132310fa-98c7-4b12-896f-ff113827d077", "name": "test" }

 ]}
|-
!style="color:green;width: 15%" |'''POST/marks/put/{id}'''
! colspan="3" style="width: 85%" |Импорт в существующий набор меток из json строки. Набор будет переписан
|-
| colspan="2" style="width: 50%" |
* '''json''' — список меток в формате: [ [ "метка1",

 ["синоним1", "синоним2", "синоним3", "синонимN" ], 0.9 # достоверность для метки (0 - 1)

 ], [ "меткаN",

 ["синоним11", "синоним21","синоним31", "синонимN1"], 0.9 # достоверность для метки (0 - 1)

 ] ]

* '''id''' — идентификатор заменяемого набора меток
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:green;width: 15%" |'''POST/marks/rename/{id}'''
! colspan="3" style="width: 85%" |Присваивает новое наименование существующему набору меток
|-
| colspan="2" style="width: 50%" |
* '''id''' — идентификатор набора меток
* '''name''' — новое имя набора
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|}

===== '''/spr: работа с сервисом SPR''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/spr/audio/{taskID}'''
! colspan="3" style="width: 85%" |Получение аудиофайла отложенного задания
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Wav файл
|-
!style="color:blue;width: 15%" |'''GET/spr/queue'''
! colspan="3" style="width: 85%" |Получение очереди отложенных заданий. Выводит очередь со статусами выполнения заданий. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой
|-
| colspan="2" style="width: 50%" |Нет входных параметров
| colspan="2" style="width: 50%" | { "id задания": {

 "created": "ХХХХ-ХХ-ХХ ХХ:ХХ:ХХ",

 "status": "waiting",

 "filename": "wav"}
|-
!style="color:red;width: 15%" |'''DELETE/spr/queue/{taskID}'''
! colspan="3" style="width: 85%" |Удаление задания из очереди
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success"}
|-
!style="color:blue;width: 15%" |'''GET/spr/result/{taskID}'''
! colspan="3" style="width: 85%" |получениеПезультатов распознавания отложенного задания. Статусы: '''ready''' — готово, '''waiting''' — ожидание, '''failed''' — сбой, '''not found''' — не найдена
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания в очереди/small>
| colspan="2" style="width: 50%" |Вывод аналогичен выводу метода stt + добавлено поле status, которое содержит информацию о статусе отложенной задачи
|-
!style="color:green;width: 15%" |'''POST/spr/stt/{model}'''
! colspan="3" style="width: 85%" |Отправка файла на распознавание речи. Моно-файлы до 30 секунд распознаются без разбивки на фрагменты. Многоканальные файлы и файлы длиннее 30 секунд предварительно разбиваются на фрагменты по отсутствию речи. Настройка данных параметров описана в [[SPR. Руководство администратора.|руководстве администратора]] spr.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''wav''' — файл для распознавания
* '''speakers''' — опция поиска говорящих по базе SBS. Если 1, то дополнительно производится поиск говорящих и получение метаданных по каждому говорящему (используется сервис SBS с предварительно обученными слепками метаданных говорящих)
* '''punctuation''' — опция для расстановки знаков препинания. Если 1, то дополнительно вызывает метод punctuate в SMC и расставляет знаки препинания в распознанном тексте, значение по умолчанию берётся из файла конфигурации (для модели big пунктуация выполняется в любом случае).
* '''normalization''' — опция обратной нормализации текста, если 1, то выполняется обратная нормализация текста текста (для модели big выполняется в любом случае).
* '''vad''' — используемый VAD, по умолчанию webrtc
* '''toxicity''' — анализировать распознанный текст на токсичность через smc (GET/smc/toxicity).Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:"оскорбление": 0.13, "непристойность": 0, "угроза": 0, "вежливость": 0.53
* '''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.
* '''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.Аудио говорящего анализируется на возраст (child, adult, old).Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE). Пол (male, female).
* '''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества
* '''async''' — отложенный запуск распознавания
* '''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя|smc]] и [[SEE. Руководство пользователя|see]].
| colspan="2" style="width: 50%" |В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.
'''Для коротких файлов''':

<code>{</code>

<code> "model": "call",</code>

<code> "text": "текст фрагмента",</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "words": [</code>

<code>{ "word": "текст",</code>

<code> "start": 520,</code>

<code> "stop": 1240 },</code>

<code> { "word": "фрагмента",</code>

<code> "start": 1240,</code>

<code> "stop": 1920 }</code>

<code>]</code>

<code>}</code>

'''Для транскрибации больших файлов:'''

<code>{</code>

<code>"speakers": [</code>

<code> {</code>

<code>"id": null,</code>

<code> "duration": 18980,</code>

<code> "fragments": 3,</code>

<code> "age": "old", # только для voice_analyzer=1</code>

<code> "gender": "female" # только для voice_analyzer=1</code>

<code>}</code>

<code>],</code>

<code>"splitted": [</code>

<code> {</code>

<code>"start": "00:00:01.870",</code>

<code> "text": "текст.",</code>

<code> "words": [</code>

<code> {</code>

<code>"word": "текст.",</code>

<code> "start": 1870,</code>

<code> "stop": 2710,</code>

<code> "confidence": 0.95263671875</code>

<code>}</code>

<code>],</code>

<code> "stop": "00:00:05.510",</code>

<code> "channel": 0,</code>

<code> "duration": "00:00:03.640",</code>

<code> "start_ms": 1870,</code>

<code> "stop_ms": 5510,</code>

<code> "duration_ms": 3640,</code>

<code> "speaker": 4,</code>

<code> "speakerConfidence": 0.87,</code>

<code>"classifiers": тут ответы от моделей smc и see,</code>

<code> "toxicity": { # только для toxicity=1</code>

<code> "insult": 0,</code>

<code> "obscenity": 0,</code>

<code> "threat": 0,</code>

<code> "politeness": 0.99</code>

<code>},</code>

<code> "emotion": { "neutral": -0.3315 }, # только для emotion=1</code>

<code> "voice_analysis": { # только для voice_analyzer=1</code>

<code> "emotion": {</code>

<code> "class": "NEUTRAL",</code>

<code> "confidence": 0.7554781436920166 }</code>

<code>}</code>

<code>}</code>

<code>]</code>

<code>}</code>
|-
!style="color:blue;width: 15%" |'''GET/spr/waveform/{taskID}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
* '''taskID''' — идентификатор задания
| colspan="2" style="width: 50%" |{"error": 0,

"waveform": [

0.016,

 0.015,

 0.01 ] }
|}

===== '''/smc: работа с сервисом SMC''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GETsmc/classify/{model}'''
! colspan="3" style="width: 85%" |Классификация текстовой фразы. В случае если модель была создана из меток, в ответе groups и nearest будут пустыми, а ответ будет построен без учета confidenceThreshold из запроса.
В ответе:

* classes — список, для каждого класса которого отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.
* groups — название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т. е. чем полнее группа, тем выше ее позиция в списке).
* nearest — отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор модели
*'''text''' - текст, подлежащий классификации
*'''correction''' - уровень коррекции ошибок, от 0 до 3, по умолчанию 0
*'''confidenceThreshold''', % - минимальный порог доверия.
| colspan="2" style="width: 50%" |{ "corrected": "исправленный текст", # при наличии флага коррекции "classes": [

 { "class": "название класса",

 "confidence": 1 },

 { "class": "название класса 2",

 "confidence": 1 } ],

 "groups": [

 { "group": "название группы 1",

 "intersection": 2,

 "classes": [ "название класса", "название класса 2" ] } ],

 "nearest": [

 { "group": "название группы 2",

 "percent": 0.67,

 "need": "название класса которого не хватило 1" },

 { "group": ""название группы 3",

 "percent": 0.67,

 "need": "название класса которого не хватило 2" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/compress'''
! colspan="3" style="width: 85%" |Убирает из фразы слова не влияющие на ее смысл.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для сжатия

* '''threshold''' — уровень компрессии от 1 до 100. Чем меньше число тем меньше слов будет в итоговой фразе
| colspan="2" style="width: 50%" |{ "text": "сжатый текст"}
|-
!style="color:blue;width: 15%" |'''GET/smc/correct'''
! colspan="3" style="width: 85%" |Коррекция правописания. Изменяет неправильно написанные слова, меняя их на наиболее близкие правильные (из знакомых модели). Если модель коррекции не смогла предложить правильное написание текста, метод вернёт текст неизменным.
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст для коррекции
*'''correction''' - уровень коррекции, от 1 до 3. По умолчанию 1.
*'''model''' - если указано, то при коррекции дополнительно используется словарь модели
| colspan="2" style="width: 50%" |{ "text": "корректный текст" }
|-
!style="color:blue;width: 15%" |'''GET/smc/emotion'''
! colspan="3" style="width: 85%" |Анализ эмоций. На выходе один из вариантов: positive, negative, neutral.
|-
| colspan="2" style="width: 50%" |'''text''' — фраза для анализа эмоций
| colspan="2" style="width: 50%" |{ "emotion": "positive", "score": 0.9601 }
|-
! style="color:green;width: 15%" |'''POST/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Добавляет к модели группы из корпуса. Группы в модели будут перезаписаны
|-
| colspan="2" style="width: 50%" |
* '''id''' — наименование модели

* '''corpus''' — наименование корпуса- источника групп
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:blue;width: 15%" |'''GET/smc/groups/{model}'''
! colspan="3" style="width: 85%" |Поиск групп по ранее полученным меткам. Ищет группы по набору меток. Результат — группы (если найдены) и ближайшие группы с указанием недостающих меток. Позволяет сохранять контекст в виде меток и дозапрашивать группы с учетом контекста.
|-
| colspan="2" style="width: 50%" |
* '''classes''' — набор меток через запятую

* '''model''' — имя модели
| colspan="2" style="width: 50%" |{"groups": [

 { "group": "Группа 1",

 "intersection": 3,

 "classes": [

 "метка1_о",

 "метка2_о",

 "метка3_о" ] },

 { "group": "Группа 2",

 "intersection": 2,

 "classes": [

 "метка1_о",

 "метка5_о" ] }],

"nearest": [

 { "group": "Группа до которой не хватило 1 метки",

 "percent": 0.75,

 "need": "недостающая метка_о" } ] }
|-
!style="color:blue;width: 15%" |'''GET/smc/normalize'''
! colspan="3" style="width: 85%" |Обратная нормализация текста. Пример: двадцать пятого апреля в пятом часу — 25 апреля в 5-м часу.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{"text": "<строка после обратной нормализации>"}
|-
!style="color:blue;width: 15%" |'''GET/smc/punctuate'''
! colspan="3" style="width: 85%" |Расстановка знаков препинания
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст для обработки.
| colspan="2" style="width: 50%" |{ "text": "string" }
|-
!style="color:green;width: 15%" |'''POST/smc/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели. Удаляет тестовую версию модели с сервера обучения, тем самым прерывает обучение.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "string"}
|-
!style="color:green;width: 15%" |'''POST/smc/test/{model}'''
! colspan="3" style="width: 85%" |Запуск тестирования модели smc. Метод асинхронный, статус тестирования можно запросить методом GET/info/{servicetype}/{model}
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — название корпуса с тестовыми данными
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
!style="color:blue;width: 15%" |'''GET/smc/toxicity'''
! colspan="3" style="width: 85%" |Определение токсичности высказывания. Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:
|-
| colspan="2" style="width: 50%" |
* '''text''' — текстовая строка с высказыванием
| colspan="2" style="width: 50%" |{ "insult": 0.13, # оскорбление

 "obscenity": 0, # брань

 "threat": 0, # угрозы

 "politeness": 0.53 вежливость}
|-
!style="color:green;width: 15%" |'''POST/smc/train/{model}'''
! colspan="3" style="width: 85%" |Добавление модели.
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
* '''corpus''' — имя текстового корпуса для обучения модели или имя набора меток
* '''isMarks''' — если «1», то вместо корпуса метод ожидает набор меток. Модель, созданная из меток, при этом не обучается, созданный файл модели используется для расчетов векторов «на лету» и выдачи результатов на основании сравнения векторов текста и синонимов из файла с метками.
| colspan="2" style="width: 50%" |{ error: INT, message: DESCRIPTION }
|}

===== '''/see: работа с сервисом SEE''' =====
{| class="wikitable" style="width: 110%"
|+
!style="color:blue;width: 15%" |'''GET/see/entities/{model}'''
! colspan="3" style="width: 85%" |Поиск сущностей. Вернется массив со всеми моделями, в которых были найдены сущности (модели для поиска указываются в поле id). Каждая переменная с названием модели будет содержать список всех найденных сущностей.
|-
| colspan="2" style="width: 50%" |
* model — идентификатор[ы] модели. Может быть указано несколько через запятую, тогда запрос будет обработан всеми указанными моделями.
* text — текст для анализа.
* similarity — порог похожести найденной сущности на эталонные, %. По умолчанию 70.
| colspan="2" style="width: 50%" |{ ID-модели: [

{ '''position''': 0, # позиция слова начала фрагмента, определяющего сущность

'''confidence''': 1, #вероятность правильного определения сущности

text: текст сущности,

'''calculated''': vaktsinatsiya # поле, содержащее значение сущности, использованный при обучении модели }, {...}

] }
|-
!style="color:green;width: 15%" |'''POST/see/stop/{model}'''
! colspan="3" style="width: 85%" |Остановка обучения модели
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|-
!style="color:green;width: 15%" |'''POST/see/train/{model}'''
! colspan="3" style="width: 85%" |Запуск обучения модели '''future'''
|-
| colspan="2" style="width: 50%" |
* '''model''' — идентификатор модели

* '''corpus''' — название корпуса с данными

* '''noise''' — уровень шума для генерации синтезированных данных для обучения модели, от 1 до 5, по умолчанию 0
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success"}
|}

===== '''/sbs: работа с сервисом SBS''' =====

{| class="wikitable" style="width: 110%"
|+
!style="color:green;width: 15%" |'''POST/sbs/analyze'''
! colspan="3" style="width: 85%" |Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента.
|-
| colspan="2" style="width: 20%" |
* '''wav''' — файл для анализа
| colspan="2" style="width: 80%" |Пример:

{ age: {

 class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}

 confidence: 0.99 },

emotion: {

 class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR", "NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}

 confidence: 0.99 },

gender: {

 class: FEMALE, # { "MALE", "FEMALE" }

 confidence: 0.99 } }
|-
! style="color:green;width: 15%" |'''POST/sbs/noiselevel'''
! colspan="3" |Возвращает процент зашумленности аудио
|-
| colspan="2" |
*'''wav''' — файл для анализа
| colspan="2" |Пример ответа:
<code>{ error: 0, message: 'success', 'noise': 0.79 }</code>
|-
! style="color:green;width: 15%" |'''POST/sbs/search'''
! colspan="3" style="width: 85%" |Поиск говорящего по базе слепков.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для анализа
*'''threshold''' — процент совпадения
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text.
| colspan="2" style="width: 80%" |Пример ответа:

{ error: 0, speaker: Ivan, confidence: 0.79 }
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/add'''
! colspan="3" style="width: 85%" |Добавление слепка в базу.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то поиск не будет осуществлен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
| colspan="2" style="width: 80%" |{

 "error": 0,

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433"

}
|-
! style="color:red;width: 15%" |'''DELETE/sbs/speakers/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление слепка из базы.
|-
| colspan="2" style="width: 20%" |
*'''id''' — идентификатор говорящего
| colspan="2" style="width: 80%" |{ error: INT, message: DESCRIPTION }
|-
! style="color:blue;width: 15%" |'''GET/sbs/speakers/list'''
! colspan="3" style="width: 85%" |Получение списка всех слепков.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |[ {

 "id": "251f78d7-ee50-4ba1-a669-ee89fdaf5433",

 "name": "наименование слепка"

 }]
|-
! style="color:green;width: 15%" |'''POST/sbs/speakers/modify/{id}'''
! colspan="3" style="width: 85%" |Дообучение слепка.
|-
| colspan="2" style="width: 20%" |
*'''wav''' — файл для обучения
*'''id''' — идентификатор слепка
*'''text''' — текст для сравнения с распознанным текстом из wav, необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от text. Для использования необходим сервис spr.
| colspan="2" style="width: 80%" |{ "error": 0,

 "message": "Success"}
|-
! style="color:green;width: 15%" |'''POST/sbs/verify/{id}'''
! colspan="3" style="width: 85%" |Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1.
|-
| colspan="2" style="width: 20%" |
*'''name''' — имя говорящего
*'''wav''' — файл для создания оцифрованного представления говорящего
*'''text''' — текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет создан, если распознанный текст будет сильно отличаться от '''text.'''
| colspan="2" style="width: 80%" |{ "error": 0, "confidence": 0.78 }
|}

====='''/tts: методы работы с сервисом tts'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/tts/dictionary/export'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений.
|-
| colspan="2" style="width: 20%" |Входные параметры отсутствуют
| colspan="2" style="width: 80%" |Простой текст — строки со словом и его интерпретацией с ударением.
|-
! style="color:blue;width: 15%" |'''GET/tts/dictionary/get'''
! colspan="3" style="width: 85%" |Выгрузка пользовательского словаря ударений в виде json.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ [ "слово", "замена слова с удар+ением"],

[ "слово2", "замена слова2 с удар+ением"],

...]
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/import'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
*'''csv file''' — файл строк со словом и его интерпретацией с ударением.
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "сообщение о статусе результата"}
|-
! style="color:green;width: 15%" |'''POST/tts/dictionary/put'''
! colspan="3" style="width: 85%" |Загрузка пользовательского словаря ударений в виде json. Текущий словарь будет переписан.
|-
| colspan="2" style="width: 50%" |
* '''json''' — строка json следующего вида:

<code>[</code>

<code>[ "слово", "замена слова с удар+ением" ],</code>

<code>[ "слово2", "замена слова2 с удар+ением" ],</code>

<code>...</code>

<code>]</code>
| colspan="2" style="width: 50%" |{

 "error": 0,

 "message": "сообщение о статусе результата"

}
|-
! style="color:green;width: 15%" |'''POST/tts/normalize'''
! colspan="3" style="width: 85%" |Нормализация текста — перевод цифр в слова и расстановка ударений (ударения только в нормализованной части фразы), например «в понедельник 10.10.2025» -> «в понедельник дес+ятого октябр+я две т+ысячи дв+адцать п+ятого г+ода».
|-
| colspan="2" style="width: 50%" |
*'''text''' — фраза для нормализации
| colspan="2" style="width: 50%" |{ "error": 0,

 "message": "success",

 "text": "нормализованный текст" }
|-
! style="color:green;width: 15%" |'''POST/tts/revoice/{revoicer}'''
! colspan="3" style="width: 85%" |Модификация или искажение голоса
|-
| colspan="2" style="width: 50%" |
*'''wav''' — аудиофайл для обработки

*'''revoicer''' — модель модификации голоса
| colspan="2" style="width: 50%" |wav-файл с модифицированным (искаженным) голосом
|-
! style="color:blue;width: 15%" |'''GET/tts/revoicers'''
! colspan="3" style="width: 85%" |Перечень моделей модификации или искажения голоса. Модели поставляются только в составе дистрибутива. Модель distortion — искажение голоса, делает голос неузнаваемым и речь неразборчивой.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ "distortion" ]
|-
! style="color:green;width: 15%" |'''POST/tts/synthesize/{model}'''
! colspan="3" style="width: 85%" |Синтез звукового файла из текста/
|-
| colspan="2" style="width: 50%" |
*'''ID''' — имя модели
*'''text''' — текст синтезируемой фразы
*'''rate''' — скорость речи
*'''pitch''' — высота (тон)
*'''volume''' — громкость
*'''frequency''' — частота дискретизации (по умолчанию 22050 Гц)
*'''format''' - формат файла результата (wav, opus, ogg, mp3)
*'''link''' - если 1, то вернуть только ссылку на файл
| colspan="2" style="width: 50%" |файл с синтезированой фразой
|}

====='''/qas: методы работы с сервисом qas'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе. Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст вопроса, на основе которого будут искаться фрагменты.
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

- "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{

"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' - категория для которой генерируются ответы*'''mode''' - режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' - генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' - {all | empty} обработать все вопросы или только не содержащие ответов
*'''category''' - если указан код категории, то генерация только для этой категории

*'''variants''' - количество ответов, от 1 до 9
*'''replace''' - заменить ответы на сгенерированные
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше. Статусы: '''started''', '''stopped''', если были ошибки, поле ответа '''error''' будет содержать код ошибки.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |Добавить категорию с указанным именем. В ответе — id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование канала
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" |Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,

 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,

 "message": "success" }
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" | Поиск ответа за пределами документов. На стадии разработки, не используется.
|-
| colspan="2" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
|Пример ответа на вопрос "как пройти в библиотеку"{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:blue;width: 15%" |'''GET/qas/chat'''
! colspan="2" | Поиск ответа за пределами документов. Аналогичен методу "POST/qas/chat". Не поддерживает большие тексты.На стадии разработки, не используется.
|-
| colspan="2" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
|Аналогично методу "POST/qas/chat".
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "text": "измененный текст"}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе — id созданного документа или сообщение об ошибке.
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,

"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" | Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{

 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:

{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" |Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="2" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="2" |Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
! colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success", "models": ["default" ]}
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" |Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

*'''aliases''' — вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{

 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" | Получение вопроса вместе с ответами и синонимами вопроса
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,

 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" | Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов, ограничение списка по вопросам

*'''answer''' — фильтр ответов, ограничение списка по ответам
| style="width: 50%" |{ "error": 0,

 "questions": [

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0},

{"id": "","question": "","incomplete": "",

 "aliases": [],"candidates": [],"category": "",

 "checked": 0,"unchecked": 0}

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры так и отдельные
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.

{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="2" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
|{"error": INT, "message": DESCRIPTION,"replacements":INT}
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="2" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" |Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :
массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" | Старт массовой обработки вопросов из файла
|-
| colspan="2" style="width: 50%" |
*'''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы
возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные
*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" |Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" |Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/answers'''
! colspan="2" |Отображает лог найденных несоответствий
|-
| colspan="2" |Входные параметры отсутствуют
|на выходе :массив из объектов {

 'question_id'

'category'

'answer_id'

'answer'

'description'

'error'

}
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" |Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" |Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;<nowiki> status: 'started' | 'stopped';</nowiki>

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,

 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETEqas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
*'''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" |корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0, "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
|[ "error": 0,
"message": "success",
"docs": [],
"answers": []
]
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{ "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
* '''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0, "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
| { "error": 0, "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:
<code>{ "name": "новое имя" }</code>
*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.{"error": INT, "message": DESCRIPTION}
|}

====='''/ses: методы работы с роботом'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! colspan="3" |для некоторых путей, где используется {robot_id} - это обращение к версии черновика, чтобы обращаться к продовой версии - нужен постфикс "_prod", для бэкапа "_backup"
актуально для методов

- получения данных робота GET/ses/robot/get/{id}

- применение настроек робота GET/ses/robot/commit/{id}

- экспорт робота GET/ses/robot/export/{id}

- список скриптов GET/ses/robot/script/list/{robot}

- получение скрипта GET/ses/robot/script/get/{robot}/{id}

- список ЭД GET/ses/robot/data/list/{robot}

- получение ЭД GET/ses/robot/data/get/{robot}/{id}

- список КТ GET/ses/robot/endpoint/list/{robot}

- получение КТ GET/ses/robot/endpoint/get/{robot}/{id}

- метода ask (отладчика) POST/ses/ask/{robot_id}

- данные сессии (отладчика) GET/ses/session/{robot_id}/{session_id}
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/audio/{uuid}'''
! colspan="2" style="width: 85%" |Получение аудио-файла из архива диалогов
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |аудио-файл с расширением opus
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/dialog/{uuid}'''
! colspan="2" style="width: 85%" |Получение диалога из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |{ "error": 0, "message": "success",

 "dialog": [{"id": "...", "robot": "...", "channel": "...",

 "unknown": true/false, "closed": true/false, "endpoint": "...",

 "answered": true/false, "models": [...], "variables": {}, "current": {

 "id": "...", "qas": "", "category": "...", "entry": [...],

 "nearest": "...", "missingRunData": [...], "waitingRunData": "...",

 "answered": true/false, "lastreply": "..."},

 "request": {"datetime": "...", "message": "", "data": [...]},

 "reply": {"answers": [{"messages": [...], "voice": "...",

 "interruptible": true/false, "file": null}],

<nowiki> "datetime": "...", "answered": true/false}}]}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/list'''
! colspan="2" style="width: 85%" |Получение списка диалогов из архива
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
*'''startdate''' - начало временного интервала в формате date %Y-%m-%d %H:%M
*'''enddate''' - конец временного интервала в формате date %Y-%m-%d %H:%M
*'''phone''' - номер телефона
*'''variable''' - переменная в формате variable=value
*'''robot''' - идентификатор робота (id)
*'''text''' - фрагмент текста в любом сообщении
*'''data''' - id элемента данных
*'''channel''' - название канала (коннектора)
| style="width: 50%" |[{"uuid": "...", "datetime": "...","phone": "", "channel": [...], "robot": ["..."]}]
|-
! style="color:blue;width: 15%" |'''GET/ses/archive/waveform/{uuid}'''
! colspan="2" style="width: 85%" |Служебный метод для визуализации полученного из архива диалогов аудио-файла, содержит пики сигнала.
|-
| colspan="2" style="width: 50%" |
*'''uuid''' - идентификатор диалога
| style="width: 50%" |[0.016,

0.015,

0.01]
|-
! style="color:green;width: 15%" |'''POST/ses/ask/{robot_id}'''
! colspan="2" style="width: 85%" |Получение ответа на запрос пользователя. Метод для отладки робота
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст запроса

*'''channel''' - id канала

*'''connector''' - имя коннектора

*'''session''' - uuid сессии, если это не первый запрос в сессии

*'''tts''' - вернуть результат синтеза (1- вернуть, 0 - не выполнять синтез)

*'''variables''' - словарик с переменными {"переменная1":"значение","переменнаяN":"значение"}

*'''handler''' - python скрипт для изменения ответов метода под требования внешних систем, подробнее в следующем разделе. в поле имя файла без расширения.

*'''restartClosed''' - перезагрузить сессию при её закрытии с новым id (1 - перезагрузить, 0 - не перезагружать)

*'''audio''' - аудиофайл с запросом, текст запроса будет получен распознаванием audio

*'''document''' - документ для последующей обработки

*'''robot_id''' - id робота

*'''endpoint''' - id точки, в которую передать управление диалогом (необязательный параметр, используется для исходящих оповещений)
| style="width: 50%" |{ "error": 0, "question": "Вопрос",

 "answer": [

 { "messages": [

 "ответ" ],

 "voice": "",

 "interruptible": true/false,

"file": "" } ],

 "session": "",

"uuid": "" }
|-
! style="color:green;width: 15%" |'''POST/ses/robot/add'''
! colspan="2" style="width: 85%" |Создание нового робота. На выходе id созданного робота или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''name''' — имя нового робота
| style="width: 50%" |{ "error": 0, "id": "2fd2f909-2069-4b20-a725-3a598c83f886"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/apply/{id}'''
! colspan="2" style="width: 85%" |Применение робота. Переводит черновик робота в статус prod. Если до этого был prod вариант — становится backup.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/cleardraft/{id}'''
! colspan="2" style="width: 85%" |Обнуление черновика рабочей версией робота

|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/commit/{id}'''
! colspan="2" style="width: 85%" |Применение текущих изменений настроек робота. Применимо ко всем версиям (черновик, рабочая, резервная копия)
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/data/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек элемента данных
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор элемента данных

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": { "id": "id ЭД", "name": "Имя ЭД", "comment": "",

 "type": "...", "rtype": "report", "model": "Имя модели",

 "param": "Ответ", "script": "", "weight": 3,

 "slaveData": [], "getOnlyAsNearest": true/false,

 "injectToMessage": true/false, "longWaiting": true/false,

 "dataWaiting": [], "actions": { "alone": {

<nowiki> "default": [{"action": "say", "type": "random", "text": ["....."]}]}},</nowiki>

<nowiki> "exceptions": {}}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/data/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка элементов данных
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[ { "id": "3ebfe38b-95bf-4927-a662-17f6e5da22ea",
 "name": "pve", "type": "smc", "rtype": "report",

 "weight": 3, "hasNearestAction": false } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/data/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение элемента данных. Формат '''data''' как на выходе метода '''GET/ses/robot/data/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных

*'''robot''' — идентификатор робота
*'''id''' — идентификатор элемента данных
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/delete/{id}'''
! colspan="2" style="width: 85%" | Удаление всех версий робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/add/{robot}'''
! colspan="2" style="width: 85%" | Создание конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами конечной точки

*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "id": "8576593b-b0d8-4b03-a623-74f3132356ea"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/endpoint/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление конечной точки.
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение настроек конечной точки
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор конечной точки
| style="width: 50%" |{ "error": 0, "data": { "id": "...", "name": "...", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/endpoint/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка конечных точек робота
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
| style="width: 50%" |[{ "error": 0, "data": { "id": "...", "name": "точка 1", "comment": "",

 "entryType": "conditions",

 "entry": [{ "conditions": [{ "type": "...", "depth": 5, "id": "...", "operation": "...", "value": ""}], "run": []}],

 "run": [],

 "actions": { "default": [{ "action": "...", "voice": "....", "type": "...", "interruptible": true/false}]},

<nowiki> "type": "report"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/endpoint/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение конечной точки. Формат '''data''' как на выходе метода '''GET/ses/robot/endpoint/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор элемента данных
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/export/{id}'''
! colspan="2" style="width: 85%" |Выгрузка робота в архив
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |zip файл с именем = идентификатор робота
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/files/download/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''id''' - идентификатор файла
| style="width: 50%" |файл
|-
! style="color:green;width: 15%" |'''POST/ses/robot/files/upload/{robot}'''
! colspan="2" style="width: 85%" | Отправка файла.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота
*'''file''' - файл
| style="width: 50%" |{"error": 0, "message": "success", "id": "Id файла"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка основных настроек робота
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "data": {

 "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78",

 "name": "test", "description": "", "voice": "",

 "session": { "lifetime": 600 },

 "models": {}, "servicedata": {},

 "exceptions": {}, "actions": {},

 "holidays": [], "timeintervals": {

 "name": { "weekdays": [ 1, 2, 3, 4, 5, 6, 7 ],

 "dates": [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31],

"months": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ],

<nowiki>"days": "all", "intervals": [ [ 0, 1440 ] ] }}}}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/import/{id}'''
! colspan="2" style="width: 85%" |Загрузка архива робота в черновик существующего робота
|-
| colspan="2" style="width: 50%" |
*'''zip —''' файл с архивом робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/list'''
! colspan="2" style="width: 85%" |Получение списка роботов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |[ { "id": "9fd7f6f1-2cac-4f0f-a121-75c40f2b5e78", "name": "test",

 "hasProd": true,

 "hasBackup": true } ]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение основных настроек робота. Формат '''data''' как в ответе метода '''GET/ses/robot/get/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с новыми настройками робота
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/restore/{id}'''
! colspan="2" style="width: 85%" |Откат рабочей версии из бэкапа. Резервная копия становится рабочей, и удаляется, а черновик остается без изменений
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/add/{robot}'''
! colspan="2" style="width: 85%" | Добавление нового скрипта. Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами скрипта
*'''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/script/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление скрипта
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/get/{robot}/{id}'''
! colspan="2" style="width: 85%" |Получение текста скрипита
|-
| colspan="2" style="width: 50%" |
*'''robot''' — идентификатор робота
*'''id''' — идентификатор скрипта
| style="width: 50%" |{ "error": 0, "data": {

 "id": "6a9f91b6-9634-4079-ac2b-60a944922c61",

"type": "Тип скрипта",

 "name": "Наименование скрипта",

 "code": "Текст скрипта" }

}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/script/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка скриптов
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор робота
| style="width: 50%" |[ { "id": "9b9d83b7-d5c3-49e6-9bd4-a123a9047939", "name": "наименование1",

 "type": "Тип скрипта"},

 { "id": "48b508ba-a32b-4ada-bcc3-66ce26d81c6a",

 "name": "наименование2",

 "type": "Тип скрипта"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Изменение скрипта.Формат '''data''' как в ответе метода '''GET/ses/robot/script/get/{robot}/{id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' — json строка с параметрами элемента данных
*'''id''' — идентификатор скрипта
* '''robot''' — идентификатор робота
| style="width: 50%" |{ "error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/script/test/{robot}/{id}'''
! colspan="2" style="width: 85%" |Тестирование скрипта. Формат '''data''' как в ответе метода '''GET/ses/session/{robot_id}/{session_id}'''
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка с параметрами сессии
*'''id''' - идентификатор скрипта
*'''robot''' - идентификатор робота
| style="width: 50%" |<nowiki>{"error": 0, "message": "success", "result": {.....}, "variables": {}}</nowiki>
|-
! style="color:blue;width: 15%" |'''POST/ses/robot/userdata/data/add/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление записи в пользовательский справочник.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "id": "id записи"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/data/delete/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" | Удаление записи из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/data/list/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Получение данных из пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |[{ "колонка 1": "значение 1", "колонка n": "значение n", "id": "id записи"}]
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Массовое изменение данных в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/data/modify/{robot}/{structure}/{id}'''
! colspan="2" style="width: 85%" |Изменение одной записи пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code>{"колонка 1": "значение 1","колонка n":"значение n"}</code>
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
*'''id''' - идентификатор записи (id)
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" | '''POST/ses/robot/userdata/data/put/{robot}/{structure}'''
! colspan="2" style="width: 85%" |Добавление данных с заменой в пользовательском справочнике.
|-
| colspan="2" style="width: 50%" |
*'''list''' - json строка в формате <code>[{"колонка 1": "значение 1","колонка n": "значение n", "id": "id строки"}]</code> Поле "id" опционально, при его добавлении данные в строке будут заменены.
*'''replace''' - замена всех данных в справочнике новыми данными. Возможные значения: yes/no. По-умолчанию - yes.
*'''robot''' - идентификатор робота (id)
*'''structure''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/add/{robot}'''
! colspan="2" style="width: 85%" |Добавление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"id": "id справочника", "name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code> Поле "id" опционально.
*'''robot''' - идентификатор робота (id)
| style="width: 50%" | {"error": 0, "id": "id справочника"}
|-
! style="color:red;width: 15%" |'''DELETE/ses/robot/userdata/structure/delete/{robot}/{id}'''
! colspan="2" style="width: 85%" |Удаление пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
* '''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/robot/userdata/structure/list/{robot}'''
! colspan="2" style="width: 85%" |Получение списка пользовательских справочников.
|-
| colspan="2" style="width: 50%" |
*'''robot''' - идентификатор робота (id)
| style="width: 50%" |<nowiki>[{"id": "id справочника", "name": "справочник", "fields": {"колонка1": "значение по умолчанию"}}]</nowiki>
|-
! style="color:green;width: 15%" |'''POST/ses/robot/userdata/structure/modify/{robot}/{id}'''
! colspan="2" style="width: 85%" |Модификация структуры пользовательского справочника.
|-
| colspan="2" style="width: 50%" |
*'''data''' - json строка в формате <code><nowiki>{"name": "справочник", "fields": {"колонка 1": "значение по умолчанию","колонка n":"значение по умолчанию"}}.</nowiki></code>
*'''robot''' - идентификатор робота (id)
*'''id''' - идентификатор пользовательского справочника
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/ses/session/{robot_id}/{session_id}'''
! colspan="2" style="width: 85%" |Выдает параметры сессии. Для отображения на боковой панели тестирования в UPS. Основные блоки результата:
|-
| colspan="2" style="width: 50%" |
*'''robot_id''' — id робота

*'''session_id''' — id незакрытой сессии
| style="width: 50%" |{ "started": "", "modified": "",

 "robot": "",

 "session": "",

 "channel": "",

 "connector": "",

 "unknown": true/false,

 "current": {"id": "", "qas": "", "answered": true/false, "category": "",

 "nearest": "", "entry": [.....], "missingRunData": [],

 "passedRunData": [.....], "waitingRunData": null,

 "border": int, "preborder": int, "lastreply": ""},

 "models": [.....],

 "scripts": [.....],

<nowiki> "data": [{"request": {.....}, "reply": {.....}}],</nowiki>

 "timers": [],

 "variables": {},

 "error": "",

 "events": {.....},

 "closed": "" }
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/config'''
! colspan="3" style="width: 85%" |Выдает параметры виджета для web канала по запросу js скрипта
|-
| colspan="2" style="width: 50%" |
*'''token''' — уникальный код виджета, создается при внедрении
| colspan="2" style="width: 50%" |Состав конфига канала, для передачи виджету. Подробней в [https://wiki.connect2ai.net/index.php/SES._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%B2%D0%B8%D0%B4%D0%B6%D0%B5%D1%82%D0%B0_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B0%D0%B9%D1%82%D0%B0 Руководстве администратора]
|-
! style="color:blue;width: 15%" |'''GET/ses/widget/js'''
! colspan="3" style="width: 85%" |Выдает код js скрипта виджета для web-канала
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |Код скрипта
|}

====='''/res: методы работы с сервисом отчетов'''=====

{| class="wikitable" style="width: 110%"
|+''Описание методов API''
! style="color:blue;width: 15%" |'''GET/res/dashboards'''
! colspan="3" style="width: 85%" |Получить список рабочих столов kibana с наборами отчетов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |{ "error": 0, "message": "success",

 "dashboards": {

"Наименование1": "https://........",

<nowiki>"Наименование2": "https://........." }}</nowiki>
|}

====='''/transcription: методы работы со стенографией'''=====

{| class="wikitable" style="width: 110%"
|+
! style="color:blue;width: 15%" |'''GET/transcription/audio/{id}'''
! colspan="3" style="width: 85%" |Получить аудиофайл по id стенограммы. Идентификатор нужной стенограммы можно получить методом
"GET /transcription/list"
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |wav файл сохраненной стенограммы
|-
! style="color:green;width: 15%" |'''POST/transcription/create'''
! colspan="3" style="width: 85%" |Создание стенограммы из завершенного задания в очереди распознавания. В ответ придет id созданной стенограммы
|-
| colspan="2" style="width: 50%" |
*'''taskID''' — идентификатор задания из очереди

*'''name''' — имя создаваемой стенограммы
| colspan="2" style="width: 50%" |{"error": 0,

"message": "success",

"id": "74721a3b-9055-4650-9afb-de4d103cafc7"}
|-
! style="color:red;width: 15%" |'''DELETE/transcription/delete/{id}'''
! colspan="3" style="width: 85%" |Удаление стенограммы
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/get/{id}'''
! colspan="3" style="width: 85%" |Получение стенограммы. Используется для отображения стенограммы в веб интерфейсе
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор стенограммы
| colspan="2" style="width: 50%" |стенограмма в json формате
|-
! style="color:blue;width: 15%" |'''GET/transcription/list'''
! colspan="3" style="width: 85%" |Получение списка сохраненных стенограмм
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| colspan="2" style="width: 50%" |[ { "id": "926e8d25-4275-4a78-906b-a1109cdacbea",

"name": "название",

"model": "big",

"created": "2024-03-29 12:37:42",

"modified": "2024-04-24 16:09:09",

"user": "0",

"dataset": "0" }, .... ]
|-
! style="color:green;width: 15%" |'''POST/transcription/save/{id}'''
! colspan="3" style="width: 85%" |Сохранение стенограмы. Используется для сохранения изменений по нажатию кнопки «Сохранить».
|-
| colspan="2" style="width: 50%" |
*'''data''' — стенограмма в json формате

*'''id''' стенограммы
| colspan="2" style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/transcription/waveform/{id}'''
! colspan="3" style="width: 85%" |Служебный метод для отображения аудио в графическом виде, ответ содержит пики сигнала
|-
| colspan="2" style="width: 50%" |
*'''id''' стенограммы
| colspan="2" style="width: 50%" |{ "error": 0,

"waveform": [

 0.016,

 ..........

 ..........

 0.015,

 0.01 ] }
|}

QAS. Руководство пользователя

2025-07-28T12:45:08Z

VoroninE: добавление similarityArea в qas&ups

==== '''В Общее описание''' ====
Сервис предназначен для поиска ответа на заданный вопрос. Входным значением для сервиса являются данные в текстовом формате. В ответ на входящий запрос сервис возвращает данные в формате JSON.

==== '''Термины и определения''' ====
Question Answering System (QAS) – сервис ответов на вопросы.

==== '''Описание методов API''' ====
Сервис QAS доступен по протоколу HTTP 1.1 через порт 6187/tcp. Авторизация не требуется, но все запросы должны содержать заголовок «accept: application/json». Ответ сервиса возвращается в формате JSON. Если произошла ошибка, возвращается переменная «error=1» и описание ошибки в переменной «message». Для удобства тестирования и использования методов сервиса по адресу <nowiki>http://АДРЕС:6187</nowiki> доступен интерфейс Swagger, который позволяет просматривать и тестировать все доступные методы из таблицы ниже.

{| class="wikitable" style="width: 110%"
|+''Методы API''
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов qas</big>'''
|-
! style="color:blue;width: 15%" |'''GET/qas/ask'''
! colspan="2" style="width: 85%" |Метод генерирует ответ на поставленный вопрос на основе информации из документов в базе.
Ответ на вопрос генерируется на основе информации, содержащейся в одном или нескольких документах. Документы должны быть в текстовом формате. Ответ возвращается в формате JSON, его можно скачать. Если метод не смог найти ответ, возвращается код ошибки и сообщение.
|-
| colspan="2" style="width: 50%" |
* '''text''' — текст вопроса, на основе которого будут искаться фрагменты.
* '''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
* '''channel''' — id канала
* '''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

* '''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
* '''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{
"error": 0,

"text": "Здесь будет текст ответа"

}
|-
! style="color:green;width: 15%" |'''POST/qas/autocache'''
! colspan="2" style="width: 85%" |Добавление вопросно-ответной пары в кэш.
В случае указания id answer будет принудительно добавлен в вопрос с указанным id. Если же указан question, то система сначала попытается найти похожий вопрос и добавить ответ в него, если же вопрос не будет найден, то система создаст новый с указанной формулировкой. При установке флага emptyQuestion будет добавлен только вопрос (без ответа).
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса
*'''category''' — категория
* '''channel''' — канал
*'''answer''' — ответ
*'''emptyQuestion''' — yes или no, флаг добавления вопроса без указания ответа
*'''id''' — код существующего вопроса
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/start'''
! colspan="2" style="width: 85%" |Генерация ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |
*'''category''' - категория для которой генерируются ответы

*'''mode''' - режим генерации ответов, возможные значения:'''- paraphrase''' - генерирует вариации ответов перефразированием уже проверенных ответов, если таковые имеются на вопросе'''- generate''' - генерирует кэш через разные ответы на каждый вопрос по документации

*'''option''' - {all | empty} обработать все вопросы или только не содержащие ответов
*'''category''' - если указан код категории, то генерация только для этой категории

* '''variants''' - количество ответов, от 1 до 9
*'''replace''' - заменить ответы на сгенерированные
* '''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/status'''
! colspan="2" style="width: 85%" |Состояние генерации ответов на вопросы в кэше.

статусы: '''started''', '''stopped''', если были ошибки поле ответа

'''error''' будет содержать код ошибки
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": "",

 "status": "started",

 "progress": 33.33 }
|-
! style="color:blue;width: 15%" |'''GET/qas/cachemaker/stop'''
! colspan="2" style="width: 85%" |Остановить генерацию ответов на вопросы в кэше.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{"error": 0, "message": "success"}
|-
! style="color:green;width: 15%" |'''POST/qas/chat'''
! colspan="2" style="width: 85%" |Произвольный запрос в LLM.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Пример ответа на вопрос "как пройти в библиотеку"

{"error": 0,

"text": "1. Проверить время работы библиотеки (обычно от 9 до 20)\n2. Проверить местоположение библиотеки на карте или с помощью сервиса Google Maps\n3. Убедиться, что у вас есть необходимые документы для входа (паспорт, карта члена библиотеки и т.д.)\n4. Посетить библиотеку по адресу: [адрес библиотеки]\n5. Проверить правила поведения в библиотеке перед входом" }
|-
! style="color:blue;width: 15%" |'''GET/qas/chat'''
! colspan="2" style="width: 85%" |Поиск ответа за пределами документов. Аналогичен методу "POST/qas/chat". Не поддерживает большие тексты.На стадии разработки, не используется.
|-
| colspan="2" style="width: 50%" |
*'''text -''' текст вопроса
*'''history''' - история вопросов, будет склеена с text при запросе
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''useInternalTemplate''' - использовать ли шаблон запроса. '''no''' - не использовать, либо код шаблона запроса к LLM. Необязательный параметр. Если не указан, используется шаблон по умолчанию.
*'''params''' - необязательный параметр. JSON с произвольными параметрами запроса к LLM. Описание параметров см. в [[QAS. Руководство администратора|руководстве администратора]].
| style="width: 50%" |Аналогично методу "POST/qas/chat".
|-
! style="color:green;width: 15%" |'''POST/qas/cleandoc'''
! colspan="2" |Очистка документа от лишней информации
|-
| colspan="2" |
*'''text -''' текст документа
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "text": "измененный текст"}
|-
! style="color:green;width: 15%" |'''POST/qas/paraphrase'''
! colspan="2" |Генерация фраз-синонимов для предложения.
|-
| colspan="2" |
*'''text -''' предложение
*'''model''' - какую модель использовать для ответа, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{"error": 0, "message": "success", "texts": [ "перефразированный текст 1", ... ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/gpt/list'''
| colspan="2" |Получение списка доступных(установленных) GPT моделей
|-
| colspan="2" |Входные параметры отсутствуют
|{ "error": 0, "message": "success",
 "models": ["default" ]}
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/answers'''
! colspan="2" style="width: 85%" | Отображает лог массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |на выходе :

массив из объектов {

 error: number;

 question: string;

 answer: string;

 confidence: number | null;

}
|-
! style="color:green;width: 15%" |'''POST/qas/questionlist/start'''
! colspan="2" style="width: 85%" | Старт массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |
*'''questions''' - файл с вопросами
*'''format''' - в json или в text файл с вопросами
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''channel''' — id канала
*'''useCache''' — использовать кешированные ответы

возможные варианты:

— "'''no'''" не использовать

- "'''all'''" использовать все

- "'''checked'''" использовать только проверенные

*'''useGPT''' — использовать генеративную сеть для поиска ответов в документах. возможные варианты "'''yes'''" "'''no'''"
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
*'''maxDocs''' - максимальное количество документов одной категории для формирования контекста при генерации ответа на вопрос, по умолчанию 1

*'''addAlias''' — добавлять похожие вопросы к синонимам, не создавая отдельного вопроса. возможные варианты "'''yes'''" "'''no'''"
*'''threshold''' - порог достоверности при обработке
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/status'''
! colspan="2" style="width: 85%" |Статус массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/questionlist/stop'''
! colspan="2" style="width: 85%" | Остановка массовой обработки вопросов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/answers'''
! colspan="2" |Отображает лог найденных несоответствий
|-
| colspan="2" |Входные параметры отсутствуют
|на выходе :

массив из объектов {

 'question_id'

'category'

'answer_id'

'answer'

'description'

'error'

}
|-
! style="color:green;width: 15%" |'''POST/qas/mismatchsearcher/start'''
! colspan="2" |Старт поиска несоответствий
|-
| colspan="2" |
*'''category''' — id категории документа. Если не указать категорию, метод вернет ответ на основе всех документов в базе данных. Допускается указание нескольких категорий через разделитель "|".
*'''model''' - имя модели GPT, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/status'''
! colspan="2" style="width: 85%" |Статус поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ error: string;

 status: 'started' | 'stopped';

 progress: number; }
|-
! style="color:blue;width: 15%" |'''GET/qas/mismatchsearcher/stop'''
! colspan="2" style="width: 85%" |Остановка поиска несоответствий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/questionmaker/stop'''
! colspan="2" style="width: 85%" |Прервать генерацию.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:blue;width: 15%" |'''GET/qas/search'''
! colspan="2" style="width: 85%" |Поиск фрагментов содержащих ответ
|-
| colspan="2" style="width: 50%" |
*'''text''' — текст запроса

*'''category''' — категория (раздел) знаний. Допускается указание нескольких категорий через разделитель "|".
*'''similarityArea -''' определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов
| style="width: 50%" |{ "error": 0,
 "text": "

 Фрагмент 1:Здесь будет текст найденного фрагмента

 Фрагмент 2:Здесь будет текст найденного фрагмента",

 "fragments": [

 { "id": "3a386b0a9e0e19efb0870685e1d0b484",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" },

 { "id": "44fd73ea1ac63f32cf18d79c854dbfe2",

 "title": "Заголовок документа",

 "category": "Категория документа",

 "text": "Здесь будет текст найденного фрагмента" } ] }
|-
! style="color:green;width: 15%" |'''POST/qas/summarize'''
! colspan="2" style="width: 85%" |Построение протокола или краткого содержания совещания
|-
| colspan="2" style="width: 50%" |
*'''text''' - текст совещания

*'''options''' — словарь с разделами протокола, где ключ — название раздела, значение - краткая инструкция к формированию раздела.
*'''model''' - какую GPT модель использовать для построения протокола, если кроме default используются другие модели

*'''file''' — файл с текстом (текст, csv, pdf или текстовые офисные документы)
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
| style="width: 50%" |{ "error": 0,

 "message": "success",

 "summary": "здесь текст протокола"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replace'''
! colspan="2" | корректировка информации в тексте при помощи LLM
|-
| colspan="2" |
*'''text''' - текст
*'''oldinfo''' — старая информация
*'''newinfo''' — новая информация
*'''model''' - какую модель использовать для генерации, если кроме default используются другие модели
*'''template''' - ID шаблона запроса к LLM, необязательный параметр
|{ "error": 0,

 "message": "success",

 "text": "итоговый текст"

}
|-
! style="color:green;width: 15%" |'''POST/qas/replacementlist'''
! colspan="2" |список всех фраз в документах и ответов в вопросах, подлежащих правке. Векторно ищет все фрагменты по указанному тексту.
|-
| colspan="2" |
*'''text''' - текст
*'''category''' — категория, в которой производится векторный поиск
*'''threshold''' — порог похожести, необязательный параметр, если не указан, берется из конфигурационного файла (fragments -> threshold)
|[ "error": 0,
"message": "success",
"docs": [],
"answers": []
]
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов channel</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/channel/add'''
! colspan="2" style="width: 85%" |Добавление канала. В ответе id созданного канала или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |'''name''' — наименование канала
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "a46fb887-5d98-41e0-8299-bcc94f615e91"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/channel/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление канала
|-
| colspan="2" style="width: 50%" |'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0, "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/channel/list'''
! colspan="2" style="width: 85%" |Получить список всех каналов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |{ "error": 0,
 "channels": [

 { "id": "1", "name": "voice" },

 { "id": "56442779-e871-43fd-ae4d-caf4ab6d09b9", "name": "канал++" },

 { "id": "0", "name": "default" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/channel/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить канал. У канала пока есть только наименование, поэтому метод только переименовывает канал
|-
| colspan="2" style="width: 50%" |
*'''name''' — новое наименование канала

*'''id''' — идентификатор канала
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов category</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/category/add'''
! colspan="2" style="width: 85%" |обавить категорию с указанным именем. В ответе - id созданной категории или сообщение об ошибке:
|-
| colspan="2" style="width: 50%" |
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success",

 "id": "ad895085-2e48-439a-831e-b5f699b6a54a" }
|-
! style="color:red;width: 15%" |'''DELETE/qas/category/delete/{id}'''
! colspan="2" style="width: 85%" |Удалить категорию. В ответе или сообщении об успехе, или ошибке, если категория используется или не существует.
|-
| colspan="2" style="width: 50%" |
*'''id''' - идентификатор категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! style="color:blue;width: 15%" |'''GET/qas/category/list'''
! colspan="2" style="width: 85%" |Получить список категорий
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |В ответе json с именами и id категорий
|-
! style="color:green;width: 15%" |'''POST/qas/category/modify/{id}'''
! colspan="2" style="width: 85%" |Изменить категорию. У категории пока есть только наименование, поэтому метод только переименовывает категорию
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор категории
*'''name''' — наименование категории
| style="width: 50%" |{ "error": 0,
 "message": "success" }
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов doc</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/doc/add'''
! colspan="2" style="width: 85%" |Загрузить текстовый документ. Добавляет документ в базу. В ответе - id созданного документа или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
*'''title''' — заголовок документа
*'''category''' — категория документа
*'''text''' — файл документа
| style="width: 50%" |{"error": 0,
"message": "success",

"id": "ebe2bc57551c2d17f892987d1f62306d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/doc/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{"error": 0,"message": "success"}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/get/{id}'''
! colspan="2" style="width: 85%" |Выгрузка текста документа
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор документа
| style="width: 50%" |{
 "error": 0,

 "text": "Здесь будет полный текст документа"

}
|-
! style="color:blue;width: 15%" |'''GET/qas/doc/list'''
! colspan="2" style="width: 85%" |Получение списка имеющихся документов
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |Пример:
{ "error": 0,

 "docs": [

 {id": "d4999cdee5ad1faf2cb3066ea1b5e96b",

 "title": "PVE. Установка сервисного пакета окружения",

 "category": "Техническая поддержка" },

 {"id": "759042575b965745b9d2af869bca1740",

 "title": "UPS. Руководство администратора",

 "category": "Техническая поддержка"} ]}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modify/{id}'''
! colspan="2" style="width: 85%" |Обновление документа. В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c изменяемыми параметрами документа

<code>{</code>

<code> title: string,</code>

<code> category: string,</code>

<code> text: string</code>

<code>}</code>

параметр который не меняется может отсутствовать в json

*'''id''' — идентификатор документа.
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/doc/replace'''
! colspan="3" style="width: 85%" |Замена подстроки в текстах категории Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/doc/modifyphrases'''
! colspan="3" |Массовая замена текста в указанных фразах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым фразами следующего вида:
[

{

'doc_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'phrase_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов question</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/question/add'''
! colspan="2" style="width: 85%" |Добавление вопроса. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''question''' — текст вопроса

*'''category''' — id категории к которой относится вопрос

*'''answers''' — ответы в виде Json:

<code>[ { "checked": true, "channel": "0", "answer": "ответ" } ]</code>

*'''aliases''' - вопросы к которым подходят ответы из блока answers в виде json:

<code>["вопрос","еще вопрос"]</code>
| style="width: 50%" |{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:green;width: 15%" |'''POST/qas/question/append/{id}'''
! colspan="2" style="width: 85%" |Добавляет алиасы/кандидаты к другому вопросу
|-
| colspan="2" style="width: 50%" |
*'''aliases''' — JSON list с синонимами

*'''candidates''' — JSON list с кандидатами

*'''id''' — идентификатор вопроса к которому добавить синонимы и(или) кандидаты
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/approve/{destination_id}'''
! colspan="2" style="width: 85%" |Перемещает кандидаты в формулировки другого вопроса
|-
| colspan="2" style="width: 50%" |
*'''candidates''' — json массив c текстами кандидатов

*'''destination_id''' — идентификатор вопроса
| style="width: 50%" |<nowiki>{error: 0 | 1, message: string}</nowiki>
|-
! style="color:green;width: 15%" |'''POST/qas/question/delete/list'''
! colspan="2" style="width: 85%" |Удаление списка вопросов или ответов.
|-
| colspan="2" style="width: 50%" |
*'''questions''' — json строка с перечнем id

*'''type''' — выбор, удалять вопросы или ответы ('''questions''', '''answers''')
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:red;width: 15%" |'''DELETE/qas/question/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/question/get/{id}'''
! colspan="2" style="width: 85%" |Получение вопроса вместе с ответами и синонимами вопроса.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор вопроса
| style="width: 50%" |{ "error": 0,
 "answers": [

 { "checked": true,

 "channel": "0",

 "answer": "ответ" } ],

 "aliases": [

 "вопрос",

 "синоним вопроса",

 "еще синоним вопроса" ] }
|-
! style="color:blue;width: 15%" |'''GET/qas/question/list'''
! colspan="2" style="width: 85%" |Получение списка вопросов.
|-
| colspan="2" style="width: 50%" |
*'''question''' — фильтр вопросов

*'''answer''' — фильтр ответов
| style="width: 50%" |{ "error": 0,
 "questions": [

 { "id": "77b42c9b-2075-4a5f-b6d9-a284bba7cf43",

 "question": "вопрос",

 "category": "9580b3b7-34cb-4d0e-ba75-d17313ead16d" },

 { "id": "d1836e5e-010e-4f3a-b306-813c3acb7efb",

 "question": "n-й второй вопрос",

 "category": "7d8a3415-cb09-4dad-a169-478ba15ade47" }

 ] }
|-
! style="color:green;width: 15%" |'''POST/qas/question/modify/{id}'''
! colspan="2" style="width: 85%" |Модификация вопроса. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" style="width: 50%" |
*'''data''' — json c измененными параметрами, пример полного:

<code>{ "answers": [</code>

<code> {</code>

<code> "checked": true,</code>

<code> "channel": "0",</code>

<code> "answer": "новый ответ"</code>

<code> }</code>

<code> ],</code>

<code>"question":"новый вопрос",</code>

<code>"category": "a3801cc0-f8e5-4f3b-bb10-e42148cd772b",</code>

<code> "aliases": [</code>

<code> "новый вопрос",</code>

<code> "синоним",</code>

<code> "еще синоним"</code>

<code> ]</code>

<code>}</code>

*'''id''' — идентификатор вопроса
| style="width: 50%" |В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|-
! style="color:green;width: 15%" |'''POST/qas/question/replace'''
! colspan="3" style="width: 85%" |Поиск и замена подстроки. Будут заменены все найденные вхождения
|-
| colspan="2" style="width: 50%" |
*'''search''' - искомая подстрока, будет заменена

*'''replace''' - текст замены

*'''category''' - в какой категории искать
| style="width: 50%" |{"error": INT, "message": DESCRIPTION,"replacements":INT}
|
|-
! style="color:green;width: 15%" |'''POST/qas/question/modifyanswers'''
! colspan="3" |Массовая замена текста в указанных ответах.
|-
| colspan="2" |
*'''phrases''' - JSON массив с изменяемым ответами следующего вида:
[

{

'question_id': 'ad895085-2e48-439a-831e-b5f699b6a54a',

'answer_id': 5,

'text': 'новый текст'

}

]
|{"error": 0,"message": "success"}
|
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов summarization_template</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/add'''
! colspan="2" style="width: 85%" |Добавление шаблона протокола. В случае успеха метод вернет id шаблона, в случае неудачи — код ошибки.
|-
| colspan="2" style="width: 50%" |
*'''name''' — название шаблона

*'''options''' — json словарь с именами разделов и их описанием
| style="width: 50%" |{ "error": 0, "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"}
|-
! style="color:red;width: 15%" |'''DELETE/qas/summarization_template/delete/{id}'''
! colspan="2" style="width: 85%" |Удаление шаблона.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/get/{id}'''
! colspan="2" style="width: 85%" |Получение json с шаблоном.
|-
| colspan="2" style="width: 50%" |
*'''id''' — идентификатор шаблона
| style="width: 50%" |На выходе словарь, основные элементы: data — словарь с шаблоном, остальные элементы этого уровня служебные. В data: id, name (идентификатор и наименование).И options — словарь с разделами шаблона.
|-
! style="color:blue;width: 15%" |'''GET/qas/summarization_template/list'''
! colspan="2" style="width: 85%" |Получение всех шаблонов.
|-
| colspan="2" style="width: 50%" |Входные параметры отсутствуют
| style="width: 50%" |На выходе словарь, основной элемент — templates, содержит список шаблонов (каждый шаблон как в выдаче метода GET /qas/summarization_template/get/{id}).
|-
! style="color:green;width: 15%" |'''POST/qas/summarization_template/modify/{id}'''
! colspan="2" style="width: 85%" |Изменение шаблона.
|-
| colspan="2" style="width: 50%" |
*'''data''' — словарь как в выдаче метода GET/qas/summarization_template/get/{id}

*'''id''' — идентификатор шаблона
| style="width: 50%" |{"error": INT, "message": DESCRIPTION}
|-
! colspan="3" style="text-align: center" |'''<big>Группа методов prompt</big>'''
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/add'''
! colspan="2" |Добавление шаблона запроса к LLM. В случае успеха метод вернет id вопроса, в случае неудачи — код ошибки.
|-
| colspan="2" |
*'''type''' — тип шаблона - chat - произвольный чат, - ask - запрос к документам, - cleandoc - очистка документа, форматирование либо другое преобразование, - similars_generator - генерация синонимичных которотких фраз, - paraphrase - перефразировка текста, - summarize - суммаризация текста (формирование краткой выдержки из текста), - question_generator - генерация вопросов по тексту, - replace - замена информации в тексте

*'''name''' — название шаблона

*'''prompt''' — текст шаблона

*'''postprompt''' - текст шаблона постобработки результатов (нужен только для summarize)
*'''params''' - параметры запроса к LLM"max_tokens": 4096, "top_k": 30, "top_p": 0.5, "temperature": 0.5, "repeat_penalty": 1.3
|{
 "error": 0,

 "id": "527be9f0-f773-4a3e-bd0b-81b40a061d0d"

}
|-
! style="color:red;width: 15%" |'''DELETE/qas/prompt/delete/{id}'''
! colspan="2" |Удаление шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{"error": INT, "message": DESCRIPTION}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/get/{id}'''
! colspan="2" |Получение шаблона.
|-
| colspan="2" |
*'''id''' — идентификатор вопроса
|{ "error": 0,

 "prompt": {

 "id": "cleandoc",

 "type": "cleandoc",

 "isDefault": false,

 "name": "Чистка документа",

 "prompt": "Удали сноски, колонтитуры и мусорную информацию из текста ниже. Не удаляй ничего лишнего. Не добавляй ничего, только информация из текста. Выведи только конечный результат без отчета о результате.\n###Текст:\n{context}\n\n###Конечный результат:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

}
|-
! style="color:blue;width: 15%" |'''GET/qas/prompt/list'''
! colspan="2" |Получение списка шаблонов.
|-
| colspan="2" |
| { "error": 0,

 "prompts": [

 {

 "id": "chat",

 "type": "chat",

 "isDefault": false,

 "name": "Чат",

 "prompt": "Ты спокойный вежливый консультант.[\n\n###История переписки:\n{history}]\n\n###Вопрос: {question}\n###Ответ:",

 "postprompt": "",

 "_modified": 1751475766.7460272,

 "_created": 1751475766.7460272,

 "_modified_date": "2025-07-02",

 "_created_date": "2025-07-02"

 }

 ]

}
|-
! style="color:green;width: 15%" |'''POST/qas/prompt/modify/{id}'''
! colspan="2" |Модификация шаблона. Позволяет заменить как все параметры, так и отдельные.
|-
| colspan="2" |
*'''data''' — json c измененными параметрами:

<code>{ "name": "новое имя" }</code>

*'''id''' — идентификатор вопроса
|В случае успеха метод вернет статус выполнения операции (например, «success»), в случае неудачи — код ошибки.
{"error": INT, "message": DESCRIPTION}
|}