Habilitar ou desabilitar o classificador semântico

O classificador semântico é um recurso premium que é cobrado de acordo com o uso. Por padrão, o classificador semântico está desativado em todos os serviços.

Verificar a disponibilidade

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

Habilitar a classificação semântica

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.

Portal do Azure

1. Abra o portal do Azure.

2. Navegue até seu serviço de pesquisa. Na página Visão geral, certifique-se de que o serviço seja de nível faturável, Básico ou superior.

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

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

   

O plano gratuito está limitado em 1.000 consultas por mês. Após as primeiras 1.000 consultas no plano gratuito, você receberá uma mensagem de erro informando que você esgotou sua cota da próxima vez que você emitir uma consulta semântica. Quando isso acontecer, você precisará 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 o Criar ou Atualizar a API de Serviço.

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

• A API REST de Gerenciamento versão 2023-11-01 fornece a propriedade de configuração.

• Para habilitar ou desabilitar os recursos, são necessárias permissões de Proprietário ou de Colaborador.

Observação

Criar ou Atualizar dá suporte a dois métodos HTTP: PUT e PATCH. PUT e PATCH podem ser usados para atualizar os 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 elas não forem especificadas na solicitação. Quando PATCH é usado para atualizar um serviço existente, ele substitui apenas as propriedades especificadas na solicitação. Ao usar PUT para atualizar um serviço existente, é possível introduzir acidentalmente uma alteração inesperada de escala 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 habilitação de recurso ou para obter proteção total contra uso e encargos acidentais, você pode desabilitar a classificação semântica 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 do 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 reabilitar a classificação semântica, execute novamente a solicitação acima, definindo "semanticSearch" como "free" (padrão) ou "standard".

Próximas etapas

Configurar a classificação semântica para que você possa testá-la no conteúdo.