Włączyć lub wyłączyć fakturowanie rankera semantycznego

Uwaga

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

Ranga semantyczna to funkcja w warstwie Premium rozliczana według użycia. Domyślnie wszystkie usługi wyszukiwania są rejestrowane w ramach bezpłatnego planu, który zapewnia miesięczny zasiłek na żądanie bez opłat. Aby włączyć stały dostęp po użyciu bezpłatnego limitu przydziału, możesz przełączyć się do planu standardowego.

Od wersji 2026-04-01 interfejsu API REST usługi Search Service zgoda na naliczanie opłat za klasyfikator semantyczny i wyszukiwanie agentowe jest oddzielna. Służy semanticSearch do kontrolowania rozliczeń dla semantycznego rankera i knowledgeRetrieval do kontrolowania rozliczeń dla agentowego pobierania danych.

Wymagania wstępne

• Usługa Wyszukiwanie AI platformy Azure w dowolnym regionie, który zapewnia semantyczny ranker.

• Dostęp właściciela lub współautora do usługi wyszukiwania.

• Interfejs API REST zarządzania wyszukiwaniem w wersji 2026-03-01-preview lub nowszej, do ustawienia właściwości semanticSearch.

Podział płatności

Wyrażasz zgodę na rozliczenia przy użyciu interfejsu API REST usługi Search Management. W poniższej tabeli przedstawiono, która właściwość ma wpływ na podstawie wersji interfejsu API REST usługi wyszukiwania używanej przez aplikację.

Wersja REST API interfejsu usługi wyszukiwania	Rozliczanie rangi semantycznej	Rozliczenia za pobieranie przez agenta
2026-04-01 i nowsze	Kontrolowane przez semanticSearch	Kontrolowane przez knowledgeRetrieval
2025-11-01-preview i wcześniejsze wersje	Kontrolowane przez semanticSearch	Kontrolowane przez semanticSearch

W przypadku wersji 2026-04-01 i nowszych interfejsu API REST usługi Search Service semanticSearch ma wpływ tylko na rozliczenia rankera semantycznego. Aby kontrolować rozliczenia agentycznego pobierania, zobacz Włączanie lub wyłączanie rozliczeń agentycznego pobierania.

W przypadku wersji 2025-11-01-preview interfejsu API REST usługi Search i wcześniejszych element semanticSearch kontroluje zgodę zarówno na użycie rankera semantycznego, jak i na płatne korzystanie z wyszukiwania agentowego.

Plany rozliczeniowe

Ranker semantyczny ma dwa plany rozliczeniowe. Aby uzyskać informacje o cenach według waluty, zobacz cennik Wyszukiwanie AI platformy Azure.

Plan	Opis	Availability
Bezpłatna (domyślna)	Zapewnia miesięczny bezpłatny zasiłek na żądanie. Po wykorzystaniu bezpłatnego limitu, żądania semantycznego rankera zwracają błąd rozliczeniowy.	Dostępne we wszystkich warstwach cenowych.
Standard	Płatność zgodnie z rzeczywistym użyciem po wyczerpaniu miesięcznego bezpłatnego przydziału.	Wymaga pakietu podstawowego lub wyższego.

Włącz rozliczanie klasyfikatora semantycznego

Wykonaj następujące kroki, aby zmienić semantyczny ranker na standardowy plan rozliczeniowy. Plan rozliczeniowy ma zastosowanie na poziomie usługi i wpływa na wszystkie indeksy.

Portal Azure

1. Przejdź do usługi wyszukiwania w portalu Azure.

2. Na stronie Przegląd upewnij się, że warstwa cenowa to Podstawowa lub nowsza.

3. W okienku po lewej stronie wybierz pozycję Ustawienia>Funkcje Premium.

4. W sekcji Semantic ranker wybierz Select plan na kafelku Standard.

   

REST

Użyj usług — utwórz lub zaktualizuj (interfejs API REST usługi Search Management), aby ustawić wartość semanticSearch na standard:

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "semanticSearch": "standard"
  }
}

Wywołania REST API do zarządzania są uwierzytelniane za pomocą Microsoft Entra ID. Aby uzyskać instrukcje dotyczące uwierzytelniania, zobacz Zarządzanie usługą Wyszukiwanie AI platformy Azure przy użyciu interfejsów API REST.

Uwaga

Funkcja Create lub Update obsługuje dwie metody HTTP: PUT i PATCH. Zarówno PUT, jak i PATCH mogą służyć do aktualizowania istniejących usług, ale tylko put może służyć do tworzenia nowej usługi. Jeśli funkcja PUT jest używana do aktualizowania istniejącej usługi, zastępuje wszystkie właściwości w usłudze wartością domyślną, jeśli nie zostały określone w żądaniu. Gdy funkcja PATCH jest używana do aktualizowania istniejącej usługi, zastępuje tylko właściwości określone w żądaniu. W przypadku używania funkcji PUT do aktualizowania istniejącej usługi można przypadkowo wprowadzić nieoczekiwaną zmianę skalowania lub konfiguracji. Podczas włączania klasyfikacji semantycznej w istniejącej usłudze zaleca się użycie funkcji PATCH zamiast PUT.

Wyłączanie rozliczeń semantycznego klasyfikatora

Wykonaj następujące kroki, aby przełączyć semantyczny rangator z powrotem do bezpłatnego planu rozliczeniowego.

Portal Azure

1. Przejdź do usługi wyszukiwania w portalu Azure.

2. W okienku po lewej stronie wybierz pozycję Ustawienia>Funkcje Premium.

3. W sekcji Semantic ranker wybierz Select plan na kafelku Free.

   

REST

Użyj Usług; Utwórz lub Aktualizuj (interfejs API REST usługi Search Management), aby ustawić semanticSearch na free.

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "semanticSearch": "free"
  }
}

Wywołania REST API do zarządzania są uwierzytelniane za pomocą Microsoft Entra ID. Aby uzyskać instrukcje dotyczące uwierzytelniania, zobacz Zarządzanie usługą Wyszukiwanie AI platformy Azure przy użyciu interfejsów API REST.

Uwaga

Wartość disabled nie jest już prawidłowa w wersji 2026-03-01-preview interfejsu Search Management REST API i nowszych. Istniejące usługi z ustawionym semanticSearch na disabled są automatycznie traktowane jako free.

Następny krok

Konfigurowanie klasyfikatora semantycznego