Habilitar ou desabilitar o classificador semântico

O classificador semântico é um recurso Premium cobrado por 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 desabilitá-lo usando a API REST.

Verificar a disponibilidade

Para verificar se o classificador semântico está disponível em sua região, consulte a lista de regiões da Pesquisa de IA do Azure.

Habilitar o classificador semântico

Siga estas etapas para habilitar o classificador semântico no nível do serviço. Uma vez habilitada, ela estará disponível para todos os índices. Você não pode ativá-la ou desativá-la para índices específicos.

  1. Abra o portal do Azure.

  2. Navegue até seu serviço de pesquisa. Na página Visão Geral, verifique se o tipo de preço está definido como Básico ou superior.

  3. No painel de navegação à esquerda, selecione Configurações>Classificador semântico.

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

    Captura de tela da habilitação da classificação semântica no portal do Azure.

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

Desabilitar o classificador semântico usando a API REST

Para reverter a habilitação do recurso ou para proteção total contra uso e cobranças acidentais, você pode desabilitar o classificador semântico usando a API de criação ou atualização de serviço no 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 à API REST de Gerenciamento são autenticadas por meio do Microsoft Entra ID. Consulte Gerenciar seu serviço da Pesquisa de IA do Azure com APIs REST para obter instruções sobre como autenticar.

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 habilitar novamente o classificador semântico, execute a solicitação anterior novamente e defina semanticSearch como Gratuito (padrão) ou Standard.

Próxima etapa