Abilitare o disabilitare la fatturazione per recupero tramite agente

Il recupero agentico è una funzionalità Premium fatturata sulla base dell'utilizzo. Per impostazione predefinita, tutti i servizi di ricerca vengono registrati nel piano gratuito, che fornisce una indennità mensile senza costi. Per abilitare l'accesso continuo dopo l'utilizzo della quota gratuita, è possibile passare al piano standard.

A partire dalla versione 2026-04-01 dell'API REST del servizio di ricerca, il consenso alla fatturazione per il ranker semantico e il retrieval agentico è separato. Usare knowledgeRetrieval per controllare l'utilizzo del recupero agentico a pagamento indipendentemente da semanticSearch.

Prerequisiti

  • Un servizio Azure AI Search, in qualsiasi area che fornisce il recupero agentico.

  • Autorizzazioni di proprietario o collaboratore per il servizio di ricerca.

  • Versione REST API di gestione della ricerca 2026-03-01-preview o successiva per configurare la proprietà knowledgeRetrieval.

Comportamento della suddivisione della fatturazione e del portale

Il consenso alla fatturazione viene impostato usando l'API REST di gestione della ricerca. La tabella seguente illustra quale proprietà ha effetto in base alla versione dell'API REST del servizio di ricerca usata dall'applicazione.

Versione dell'API REST del servizio di ricerca Fatturazione per il classificatore semantico Fatturazione per il recupero agentico
2026-04-01 e versioni successive Controllato da semanticSearch Controllato da knowledgeRetrieval
2025-11-01-preview e versioni precedenti Controllato da semanticSearch Controllato da semanticSearch

Per l'API REST del servizio di ricerca versione 2026-04-01 e successive, knowledgeRetrieval controlla la fatturazione del recupero agentico indipendentemente da semanticSearch. Per controllare la fatturazione del ranker semantico, vedere Abilitare o disabilitare la fatturazione del ranker semantico.

Per l'API REST del servizio di ricerca, versione 2025-11-01-preview e versioni precedenti, semanticSearch controlla il consenso sia per il classificatore semantico sia per l'utilizzo del recupero agentico a pagamento. La knowledgeRetrieval proprietà viene ignorata.

Comportamento del portale

Il portale di Azure usa l'API REST del servizio di ricerca versione 2025-11-01-preview, che imposta la proprietà semanticSearch, non knowledgeRetrieval. In questa versione, semanticSearch controlla il consenso alla fatturazione per entrambe le funzionalità, quindi il selettore Impostazioni>funzionalità Premium influisce anche sulla fatturazione del classificatore semantico. Per gestire la fatturazione del recupero agentico in modo indipendente, usare l'API REST.

Piani di fatturazione

Il sistema di recupero agentico offre due opzioni di fatturazione. Per i prezzi in base alla valuta, vedere i prezzi di Azure AI Search.

Piano Descrizione
Gratuito (impostazione predefinita) Fornisce una indennità di token mensile senza alcun addebito. Dopo l'utilizzo dell'indennità gratuita, le richieste che comportano l'utilizzo a pagamento restituiscono un errore di pagamento richiesto. Disponibile in tutti i piani tariffari.
Standard Prezzi con pagamento in base al consumo dopo l'utilizzo dell'indennità gratuita mensile. Richiede il livello Basic o superiore.

Abilitare la fatturazione per il recupero agentico

Seguire questi passaggi per passare il recupero agentico al piano di fatturazione standard.

Attualmente, il portale non espone un controllo di fatturazione dedicato per il recupero agentico. È necessario usare l'API REST per gestire il consenso alla fatturazione. Per altre informazioni, vedere Comportamento del portale.

Disabilitare la fatturazione per il recupero agentico

Seguire questi passaggi per riportare il recupero agentico al piano di fatturazione gratuito.

Attualmente, il portale non espone un controllo di fatturazione dedicato per il recupero agentico. È necessario usare l'API REST per gestire il consenso alla fatturazione. Per altre informazioni, vedere Comportamento del portale.