Включение или отключение семантического ранга

Семантический рангер — это функция уровня "Премиум", которая взимается по использованию. По умолчанию семантический рангировщик отключен во всех службах.

Проверить доступность

Проверьте страницу "Доступные по регионам " на веб-сайте Azure, чтобы узнать, указан ли ваш регион.

Включение семантического ранжирования

Выполните следующие действия, чтобы включить семантический рангер на уровне обслуживания. После включения он доступен для всех индексов. Вы не можете включить или отключить его для определенных индексов.

Портал Azure

1. Откройте портал Azure.

2. Перейдите к своей службе поиска На странице "Обзор" убедитесь, что служба является оплачиваемым уровнем, базовым или более высоким.

3. На панели навигации слева выберите семантический рейтинг.

4. Выберите бесплатный план или стандартный план. Вы можете переключаться между бесплатным планом и стандартным планом в любое время.

   

Бесплатный план ограничен 1000 запросов в месяц. После первых 1000 запросов в бесплатном плане вы получите сообщение об ошибке, позволяющее узнать, что квота исчерпана при следующем выполнении семантического запроса. В этом случае необходимо перейти к стандартному плану, чтобы продолжить использование семантического ранжирования.

REST

Чтобы включить семантический ранжирование с помощью REST API, можно использовать API создания или обновления службы.

Вызовы REST API управления проходят проверку подлинности с помощью идентификатора Microsoft Entra. Инструкции по проверке подлинности см. в статье "Управление служба ИИ Azure с помощью REST API".

• ИНТЕРФЕЙС REST API управления версии 2023-11-01 предоставляет свойство конфигурации.

• Разрешения владельца или участника необходимы для включения или отключения функций.

Примечание.

Создание или обновление поддерживает два метода HTTP: PUT и PATCH. С помощью PUT и PATCH можно обновить существующие службы, но для создания новой службы можно использовать только PUT. Если PUT используется для обновления существующей службы, он заменяет все свойства службы своими значениями по умолчанию, если они не указаны в запросе. При использовании PATCH для обновления существующей службы он заменяет только свойства, указанные в запросе. При использовании PUT для обновления существующей службы можно случайно ввести непредвиденное масштабирование или изменение конфигурации. При включении семантического ранжирования в существующей службе рекомендуется использовать PATCH вместо PUT.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

Отключение семантического ранжирования с помощью REST API

Чтобы отменить включение функций или полную защиту от случайного использования и расходов, можно отключить семантический ранжирование с помощью API создания или обновления службы в службе поиска. После отключения функции все запросы, включающие тип семантического запроса, будут отклонены.

Вызовы REST API управления проходят проверку подлинности с помощью идентификатора Microsoft Entra. Инструкции по проверке подлинности см. в статье "Управление служба ИИ Azure с помощью REST API".

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Чтобы повторно включить семантический ранжирование, повторно выполните приведенный выше запрос, задав значение "semanticSearch" значение "бесплатный" (по умолчанию) или "стандартный".

Следующие шаги

Настройте семантический рейтинг, чтобы проверить семантический ранжирование содержимого.