Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Note
Pesquisa de IA do Azure está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.
A recuperação por meio de agentes é um recurso premium cobrado pelo uso. Por padrão, todos os serviços de pesquisa são registrados no plano gratuito, que fornece um subsídio mensal sem custo. Para habilitar o acesso contínuo após o consumo da cota gratuita, você pode alternar para o plano padrão.
A partir da versão 2026-04-01 da API REST do Serviço de Busca, o consentimento de cobrança para o ranqueador semântico e a recuperação agêntica é feito separadamente. Use knowledgeRetrieval para controlar o uso da recuperação por meio de agentes paga independentemente de semanticSearch.
Pré-requisitos
Um serviço de Pesquisa de IA do Azure em qualquer região que ofereça recuperação por meio de agentes.
Acesso de proprietário ou colaborador ao serviço de pesquisa.
A API REST de Gerenciamento de Pesquisa versão 2026-03-01-preview ou posterior para definir a propriedade
knowledgeRetrieval.
Divisão de cobrança
Defina o consentimento de cobrança usando a API REST do Gerenciamento de Pesquisa. A tabela a seguir mostra qual propriedade entra em vigor com base na versão da API REST do Serviço de Pesquisa que seu aplicativo usa.
| Versão da API REST do Serviço de Pesquisa | Cobrança do classificador semântico | Cobrança de recuperação por meio de agentes |
|---|---|---|
| 2026-04-01 e em diante | Controlado por semanticSearch |
Controlado por knowledgeRetrieval |
| 2025-11-01-preview e versões anteriores | Controlado por semanticSearch |
Controlado por semanticSearch |
Para a versão da API REST do Serviço de Pesquisa 2026-04-01 e posteriores, knowledgeRetrieval controla de forma independente a cobrança da recuperação por meio de agentes de semanticSearch. Para controlar a cobrança do classificador semântico, consulte Habilitar ou desabilitar a cobrança do classificador semântico.
Na versão 2025-11-01-preview da API REST do Serviço de Pesquisa e em versões anteriores, semanticSearch controla o consentimento para o classificador semântico e para o uso pago da recuperação por meio de agentes. A knowledgeRetrieval propriedade é ignorada.
Planos de cobrança
O Agentic retrieval oferece dois planos de cobrança. Para obter preços por moeda, consulte preços do Pesquisa de IA do Azure .
| Plano | Descrição | Availability |
|---|---|---|
| Gratuito (padrão) | Fornece uma cota de token mensal sem custo. Depois que o subsídio gratuito é consumido, as solicitações que implicariam em uso pago retornam um erro de pagamento exigido. | Disponível em todos os tipos de preço. |
| Standard | Cobrança por uso após o consumo do subsídio gratuito mensal. | Requer a camada Básica ou superior. |
Habilitar a cobrança da recuperação por meio de agentes
Siga estas etapas para mudar a recuperação por meio de agentes para o plano de cobrança padrão.
Acesse seu serviço de pesquisa no portal do Azure.
Na página Visão geral , verifique se o tipo de preço é Básico ou superior.
No painel esquerdo, selecione Os recursos de Configurações>Premium.
Em Recuperação de conhecimento, selecione Selecionar plano no cartão Standard.
Desabilitar a cobrança da recuperação por meio de agentes
Siga estas etapas para retornar a recuperação por meio de agentes para o plano de cobrança padrão.
Acesse seu serviço de pesquisa no portal do Azure.
No painel esquerdo, selecione Os recursos de Configurações>Premium.
No Recuperação de conhecimento, selecione Selecionar plano no cartão Gratuito.
