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

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

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

Чтобы проверить, доступен ли семантический рангировщик в вашем регионе, см . список регионов поиска ИИ Azure.

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

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

Портал Azure

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

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

3. В области навигации>слева выберите "Параметры семантического рангера".

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

   

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

REST

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

Вызовы REST API управления проходят проверку подлинности с помощью идентификатора Microsoft Entra. Инструкции по проверке подлинности см. в статье "Управление azure AI служба с помощью 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 AI служба с помощью 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 значение "Бесплатный " (по умолчанию) или "Стандартный".

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

Настройка семантического рангера