Ativar ou desativar o classificador semântico

O ranker semântico é uma funcionalidade premium cujo custo é calculado conforme o uso. Por padrão, o classificador semântico é habilitado em um novo serviço de pesquisa faturável e configurado para o plano gratuito, mas qualquer pessoa com permissões de Colaborador pode desativá-lo ou alterar o plano de cobrança. Se você não quiser que ninguém use o recurso, você pode desativá-lo em todo o serviço usando a API REST de gerenciamento.

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

O classificador semântico pode não estar habilitado em serviços mais antigos. 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.

Portal do Azure

1. Abra o portal do Azure.

2. Aceda ao serviço de busca. 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 à esquerda, selecione Configurações>Classificação semântica.

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

   

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ê poderá atualizar para o plano padrão para continuar usando a classificação semântica.

REST

Para habilitar o classificador semântico usando a API REST, você pode usar a API Criar ou Atualizar Serviço.

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.

• Management REST API versão 2023-11-01 ou posterior inclui a propriedade de configuração.

• As permissões de Proprietário ou Colaborador são necessárias para ativar ou desativar recursos.

Nota

Create or Update suporta dois métodos HTTP: PUT e PATCH. PUT e PATCH podem ser usados para atualizar serviços existentes, mas apenas PUT pode ser usado para criar um novo serviço. Se o PUT for usado para atualizar um serviço existente, ele substituirá todas as propriedades no serviço pelos seus valores padrão se não forem especificados na solicitação. Quando PATCH é usado para atualizar um serviço existente, ele substitui apenas as propriedades especificadas na solicitação. Ao usar o PUT para atualizar um serviço existente, é possível introduzir acidentalmente uma alteração inesperada de dimensionamento ou configuração. Ao habilitar a classificação semântica em um serviço existente, é recomendável usar PATCH em vez de 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"
      }
    }

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