Ativar ou desativar o classificador semântico

  • Artigo

O ranker semântico é um recurso premium cobrado pelo uso. Por padrão, o classificador semântico é desativado quando você cria um novo serviço de pesquisa, mas qualquer pessoa com permissões de Colaborador pode habilitá-lo. Se você não quiser que ninguém o habilite inadvertidamente, você pode desativá-lo usando a API REST.

Verificar disponibilidade

Para verificar se o classificador semântico está disponível na sua região, consulte a lista de regiões do Azure AI Search.

Ativar classificador semântico

Siga estas etapas para habilitar o classificador semântico no nível de serviço. Uma vez ativado, fica disponível para todos os índices. Não é possível ativá-lo ou desativá-lo para índices específicos.

  1. Abra o portal do Azure.

  2. Navegue até o serviço de pesquisa. Na página Visão geral, verifique se o nível de preço está definido como Básico ou superior.

  3. No painel de navegação esquerdo, selecione Classificação semântica de configurações>.

  4. Selecione o plano gratuito ou o plano padrão. Você pode alternar entre o plano gratuito e o plano padrão a qualquer momento.

    Captura de ecrã a mostrar a ativação da classificação semântica no portal do Azure.

O plano gratuito é limitado a 1.000 consultas por mês. Após as primeiras 1.000 consultas no plano gratuito, uma mensagem de erro indica que você esgotou sua cota na próxima consulta semântica. Quando a cota estiver esgotada, você deve atualizar para o plano padrão para continuar usando a classificação semântica.

Desabilitar o classificador semântico usando a API REST

Para desativar a ativação de recursos ou para obter proteção total contra uso acidental e cobranças, você pode desabilitar a classificação semântica usando a API Criar ou Atualizar Serviço em seu serviço de pesquisa. Depois que o recurso for desabilitado, todas as solicitações que incluírem o tipo de consulta semântica serão rejeitadas.

As chamadas da API REST de gerenciamento são autenticadas por meio do Microsoft Entra ID. Para obter instruções sobre como autenticar, consulte Gerenciar seu serviço Azure AI Search com APIs REST.

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"
      }
    }

Para reativar o classificador semântico, execute a solicitação anterior novamente e defina semanticSearch como Livre (padrão) ou Padrão.

Próximo passo

Configurar classificador semântico