Сброс навыков (предварительная версия REST API)
Применимо к: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Важно!
2023-07-01-Preview (без изменений).
30.04.2021 (без изменений).
2020-06-30-Preview добавляет API. Он поддерживает кэшированные обогащения и сценарии сброса.
Запрос на сброс навыков выборочно обрабатывает один или несколько навыков при следующем запуске индексатора. Для индексаторов с включенным кэшированием можно явно запросить обработку обновлений навыков, которые индексатор не может обнаружить. Например, при внесении внешних изменений, таких как изменения пользовательского навыка, можно использовать этот API для повторного запуска навыка. Выходные данные, такие как хранилище знаний или индекс поиска, обновляются с помощью повторно используемых данных из кэша и нового содержимого в соответствии с обновленным навыком.
Вы можете сбросить существующий набор навыков с помощью HTTP POST, указав имя набора навыков для обновления в URI запроса.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Параметры URI
| Параметр | Описание |
|---|---|
| имя службы | Обязательный. Задайте уникальное, определяемое пользователем имя службы поиска. |
| Имя набора навыков | Обязательный. URI запроса указывает имя набора навыков для сброса. |
| api-version | Обязательный. Текущая предварительная версия — 2023-07-01-Preview. Дополнительные версии см. в разделе Версии API . |
Заголовки запросов
Таблица ниже содержит обязательные и необязательные заголовки запроса.
| Поля | Описание |
|---|---|
| Content-Type | Обязательный. Для этого заголовка необходимо задать значение application/json |
| api-key | Необязательно, если вы используете роли Azure и в запросе предоставляется маркер носителя, в противном случае требуется ключ. Ключ API — это уникальная, созданная системой строка, которая проверяет подлинность запроса к службе поиска. Запросы на сброс должны включать заголовок, заданный api-key для ключа администратора (в отличие от ключа запроса). Дополнительные сведения см. в статье Подключение к поиску ИИ Azure с помощью проверки подлинности по ключу . |
Текст запроса
Текст запроса представляет собой массив имен навыков.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Ответ
Код состояния: в качестве успешного ответа возвращается код «204 — Нет содержимого».