Как использовать REST API QnA Maker для обновления моей базы знаний с использованием собственного JavaScript?

Обновление 1: после прочтения вопроса спрашивающий хочет создать пару QnAMaker, а не просто запросить ее. Документация по API QnAMaker не очень хороша, а в некоторых случаях устарела или сбивает с толку. Следовательно, я делюсь подсказками для обоих сценариев.

Сценарий 1. Создание пар QnAMaker

Создать пары QnAMaker немного сложнее, и я бы порекомендовал начать с образца С# и его Program.cs. Оттуда вы можете преобразовать его в сценарий Java. В документации есть примеры и для других языков, например для nodejs.

Подсказка: запустите Fiddler, пока выполняете сэмплы. Таким образом, вы можете проверить вызов по вызову и порт для почтальона или композитора для ваших тестов.

Исходя из исходного вопроса, правильный вызов выглядит так:

// Replace {key} with your QnAMaker endpoint key 
// and {kbId} with the id of the knowledgebase you want to upgrade.

function synchronize() {
    var jsonData = {
        qnaList: [
          {
            id: 0,
            answer: 'Hello',
            source: 'Custom Editorial',
            questions: [
              'Hi','Hello'
            ],
            metadata: [
              {
                name: 'category',
                value: 'api'
              }
            ]
          }
        ]
    }

    var request = new XMLHttpRequest();    

    request.open("PATCH", "https://westus.api.cognitive.microsoft.com/qnamaker/v4.0/knowledgebases/{kbId}", true);                    
    request.setRequestHeader("Ocp-Apim-Subscription-Key", "{key}");
    request.setRequestHeader("Content-type", "application/json");                    
    request.onreadystatechange = function () { 
        //Call a function when the state changes.
        if (request.readyState == 4) {
            alert(request.responseText);
        }
    }

    request.send(JSON.stringify(jsonData));
}

Сценарий 2: Запрос QnAMaker

Для POST/generateAnswer Ocp-Apim-Subscription-Key устарел, и вы должны использовать свой собственный uri (хост) вместо westus.api.cognitive.microsoft.com.

Когда летом прошлого года QnAMaker стал GA, определение заголовка и хоста изменилось.

Самый простой способ найти правильные настройки для всех ваших параметров - это перейти на портал QnAMaker и щелкнуть Просмотр кода в своей базе знаний.

Оттуда вы найдете правильные настройки, чтобы скопировать его.

Сопутствующее сравнение измененного определения ниже было опубликовано в объявлении ГА.