Ativar ou desativar a faturação semântica do ranker

Nota

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

O ranker semântico é uma funcionalidade premium faturada por uso. Por padrão, todos os serviços de pesquisa estão inscritos no plano gratuito, que oferece um limite mensal de solicitações sem custos. Para permitir o acesso contínuo após o esgotamento da quota gratuita, pode mudar para o plano padrão.

A partir da versão 2026-04-01 da API REST do Serviço de Pesquisa, o consentimento de faturação para o classificador semântico e a recuperação agêntica é dado separadamente. Use semanticSearch para controlar a faturação do ranker semântico e knowledgeRetrieval para controlar a faturação da recuperação agêntica.

Pré-requisitos

  • Um serviço Pesquisa de IA do Azure em qualquer região que forneça classificador semântico.

  • Acesso do Proprietário ou Contribuinte ao serviço de pesquisa.

  • Utilize o API REST de Gestão de Pesquisa versão 2026-03-01-preview ou posterior para definir a propriedade semanticSearch.

Separação da faturação

Define o consentimento de faturação usando a API REST de Gestão de Pesquisa. A tabela seguinte mostra qual a propriedade que entra em vigor com base na versão da API REST do Serviço de Pesquisa que a sua aplicação utiliza.

Versão da API REST do Serviço de Pesquisa Faturação semântica de rankers Faturação de recuperação agential
2026-04-01 e posteriores Controlado por semanticSearch Controlado por knowledgeRetrieval
2025-11-01-preview e anteriores Controlado por semanticSearch Controlado por semanticSearch

Na versão 2026-04-01 da API REST do Serviço de Pesquisa e em versões posteriores, semanticSearch afeta apenas a faturação do classificador semântico. Para controlar a faturação da recuperação agêntica, veja Ativar ou desativar a faturação da recuperação agêntica.

Para a versão 2025-11-01-preview da API REST do Serviço de Pesquisa e versões anteriores, semanticSearch controla o consentimento tanto para o classificador semântico como para a utilização paga da recuperação agêntica.

Planos de faturação

O Semantic Ranker tem dois planos de faturação. Para consultar os preços por moeda, veja preços do Pesquisa de IA do Azure.

Plano Descrição Availability
Grátis (padrão) Oferece um limite mensal gratuito para pedidos. Depois de consumida a quota gratuita, as solicitações do ranker semântico retornam um erro de faturação. Disponível em todos os escalões de preço.
Standard Preço conforme o uso após o consumo da franquia mensal gratuita. Requer o nível Básico ou superior.

Ativar faturação semântica do ranker

Siga estes passos para alterar o classificador semântico para o plano de faturação padrão. O plano de faturação aplica-se ao nível do serviço e afeta todos os índices.

  1. Vá ao seu serviço de pesquisa no portal Azure.

  2. Na página de Visão Geral , certifique-se de que a faixa de preços é Básica ou superior.

  3. No painel esquerdo, selecione Definições>Funcionalidades Premium.

  4. Em Classificador semântico, selecione Selecionar plano no cartão Padrão.

    Captura de ecrã da página de funcionalidades Premium no portal Azure, mostrando o plano Semântic Ranker Standard selecionado.

Desativar a faturação semântica do ranker

Siga estes passos para mudar o classificador semântico de volta para o plano de faturação gratuito.

  1. Vá ao seu serviço de pesquisa no portal Azure.

  2. No painel esquerdo, selecione Definições>Funcionalidades Premium.

  3. Em Classificador semântico, selecione Selecionar plano no cartão Gratuito.

    Captura de ecrã da página de funcionalidades Premium no portal Azure, mostrando o plano Semantic Ranker Free selecionado.

Próximo passo