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

Общее описание

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

Термины и определения

Question Answering System (QAS) – сервис ответов на вопросы.

Описание методов API

Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6187/tcp.

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

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

Метод	Тип	Описание	Входные параметры	Ответ
/doc/	POST	Добавление документа в базу	title - заголовок файла. category - категория документа. text file - поле для загрузки файла.	{ models: [model1,...,modelN] }
/sbs/analyze/{id}	POST	Получение аналитических метаданных из голосового фрагмента	id - идентификатор модели. wav - файл для анализа	Вернется массив с метаданными голосового фрагмента. Пример: { age: { class: 20-29, confidence: 0.99 }, emotion: { class: SADNESS, confidence: 0.99 }, gender: { class: FEMALE, confidence: 0.99 } } age - возраст 00-05 06-12 13-19 20-29 30-39 40-49 50-59 60+ emotion - эмоция ANGER BORE DISAPPOINTMENT DISGUST EXCITEMENT FEAR NEUTRAL PAIN PLEASURE SADNESS SUPRISE gender - пол MALE FEMALE
/sbs/embedding/{id}	POST	Получение оцифрованного представления говорящего	id - идентификатор модели. wav - файл для анализа	Пример ответа: { error: 0, embedding: [ 0.019493144005537033, -0.08348844200372696, ... ] }
/sbs/search/{id}	POST	Поиск говорящего по базе слепков	id - идентификатор модели. wav - файл для анализа	Пример ответа: { error: 0, speaker: Ivan, confidence: 0.79 }
/sbs/speaker/{id}/{speaker_id}	POST	Добавление слепка в базу.	id - идентификатор модели speaker_id - идентификатор говорящего wav - файл для создания оцифрованного представления говорящего	{ error: INT, message: DESCRIPTION }
/qas/doc/{id}	DELETE	Удаление документа из базы	id - идентификатор документа.	{"error": 0, "message": "success"}
/sbs/speakers/{id}	GET	Получение списка всех слепков	id - идентификатор модели	[ "Kiryl", "Artem", "vladimir", "Sergey", "vladimir2", "Alla" ]
/sbs/verify/{id}/{speaker_id}	POST	Сравнение оцифрованного представления wav-файла cо слепком в базе	id - идентификатор модели speaker_id - идентификатор говорящего	{ "error": 0, "confidence": 0.78 }