Ativar ou desativar o classificador semântico

O ranker semântico é um recurso premium que é cobrado pelo uso. Por padrão, o classificador semântico é desativado em todos os serviços.

Verificar disponibilidade

Verifique a página Produtos Disponíveis por Região no Web site do Azure para ver se a sua região está listada.

Ativar classificação semântica

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. Navegue até o serviço de pesquisa. Na página Visão geral, verifique se o serviço é uma camada faturável, básica ou superior.

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

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.

   

O plano gratuito é limitado a 1.000 consultas por mês. Após as primeiras 1.000 consultas no plano gratuito, você receberá uma mensagem de erro informando que esgotou sua cota na próxima vez que emitir uma consulta semântica. Quando isso acontece, você precisa atualizar para o plano padrão para continuar usando a classificação semântica.

REST

Para habilitar a classificação semântica usando a API REST, você pode usar a API de serviço Criar ou Atualizar.

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

• Management REST API versão 2023-11-01 fornece 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 PUT for usado para atualizar um serviço existente, ele substituirá todas as propriedades no serviço por seus padrões se eles 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 a classificação semântica usando a API REST

Para reverter 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 desativado, 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. Consulte Gerenciar seu serviço Azure AI Search 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 reativar a classificação semântica, execute novamente a solicitação acima, definindo "semanticSearch" como "free" (padrão) ou "standard".

Próximos passos

Configure a classificação semântica para que você possa testar a classificação semântica em seu conteúdo.