Używanie profilów oceniania z rankerem semantycznym w usłudze Wyszukiwanie AI platformy Azure

Profil oceniania można zastosować na semantycznie uszeregowanych wynikach wyszukiwania, gdzie profil oceniania jest przetwarzany na końcu.

Aby upewnić się, że profil oceniania dostarcza decydujący wynik, semantyczny klasyfikator dodaje pole odpowiedzi, @search.rerankerBoostedScore, które stosuje logikę profilu oceniania do semantycznie sklasyfikowanych wyników. W wynikach wyszukiwania, które obejmują @search.score z poziomu 1 klasyfikacji, @search.rerankerScore z semantycznego rankera i @search.rerankerBoostedScore, wyniki są sortowane według @search.rerankerBoostedScore.

Wymagania wstępne

• Wyszukiwanie AI platformy Azure w dowolnym regionie, który zapewnia klasyfikację semantyczną.

• Indeks wyszukiwania z semantyczną konfiguracją określającą "rankingOrder": "boostedRerankerScore" i profil oceniania określający funkcje.

Ograniczenia

Zwiększenie semantycznie sklasyfikowanych wyników ma zastosowanie tylko do funkcji profilu oceniania. Nie ma zwiększenia, jeśli profil oceniania składa się tylko z ważonych pól tekstowych.

To zachowanie dotyczy zapytań semantycznych wysyłanych bezpośrednio do indeksu, takich jak /docs/search. Pobieranie agentowe nie stosuje profilów ocen, w tym defaultScoringProfile w indeksie bazowym, a odpowiedzi pobierania nie ujawniają @search.rerankerBoostedScore. Aby uzyskać więcej informacji, zobacz Tworzenie źródła wiedzy indeksu wyszukiwania i Wykonywanie zapytań w bazie wiedzy.

Jak działa konfiguracja semantyczna z profilami oceniania?

Po wykonaniu semantycznego zapytania związanego z profilem oceniania, generowana jest trzecia wartość wyników wyszukiwania, @search.rerankerBoostedScore, dla każdego dokumentu w wynikach wyszukiwania. Ten wzmocniony wynik, obliczany przez zastosowanie profilu punktacji do istniejącego wyniku ponownego rangowania, nie ma gwarantowanego zakresu (0–4), jak normalny wynik ponownego rangowania, a wyniki mogą być znacznie wyższe niż 4.

Wyniki semantyczne są domyślnie sortowane według @search.rerankerBoostedScore , jeśli istnieje profil punktacji. rankingOrder Jeśli właściwość nie jest określona, BoostedRerankerScore jest to wartość domyślna w konfiguracji semantycznej.

W tym scenariuszu profil oceniania jest używany dwa razy.

1. Najpierw profil oceniania zdefiniowany w indeksie jest używany w początkowej fazie klasyfikacji L1, zwiększając wyniki z:

   • Zapytania oparte na tekście (BM25 lub RRF)
   • Część tekstowa zapytań wektorowych
   • Zapytania hybrydowe łączące oba typy

2. Następnie semantyczny klasyfikator przeszacowuje 50 najlepszych wyników, promując bardziej semantycznie istotne dopasowania na szczyt. Ten krok może wymazać korzyść z profilu punktacji. Jeśli na przykład zwiększysz wartość na podstawie świeżości, to semantyczna zmiana kolejności zastąpi to swoją logiką tego, co semantycznie jest najbardziej istotne.

3. Na koniec profil oceniania zostanie ponownie zastosowany po ponownym korekcie, przywracając wpływ impulsów na ostateczną kolejność wyników. Jeśli zwiększysz ocenę według świeżości, semantycznie sklasyfikowane wyniki zostaną ponownie ocenione na podstawie świeżości.

Włączanie profilów oceniania w konfiguracji semantycznej

Aby włączyć profile oceniania dla semantycznie sklasyfikowanych wyników, zaktualizuj indeks , ustawiając rankingOrder właściwość konfiguracji semantycznej. Użyj metody PUT, aby zaktualizować indeks za pomocą swoich poprawek. Nie jest wymagana ponowna kompilacja indeksu.

PUT https://{service-name}.search.windows.com/indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "boostedRerankerScore"
      }
    ]
  }
}

Wyłączanie profilów oceniania w konfiguracji semantycznej

Aby zrezygnować z sortowania według wyniku wzmocnionego przez semantyczny reranker, ustaw pole rankingOrder na wartość reRankerScore w konfiguracji semantycznej.

PUT /indexes/{index-name}?api-version=2026-04-01
{
  "semantic": {
    "configurations": [
      {
        "name": "mySemanticConfig",
        "rankingOrder": "reRankerScore"
      }
    ]
  }
}

Nawet jeśli zrezygnowasz z sortowania według @search.rerankerBoostedScore, boostedRerankerScore pole jest nadal generowane w odpowiedzi, ale nie jest już używane do sortowania wyników.

Przykładowe zapytanie i odpowiedź

Rozpocznij od zapytania semantycznego określającego profil oceniania. To zapytanie jest przeznaczone dla indeksu wyszukiwania, który ma rankingOrder ustawiony na boostedRerankerScore.

POST /indexes/{index-name}/docs/search?api-version=2026-04-01
{
  "search": "my query to be boosted",
  "scoringProfile": "myScoringProfile",
  "queryType": "semantic"
}

Odpowiedź zawiera nowy rerankerBoostedScore element, wraz z L1 @search.score i L2 @search.rerankerScore. Wyniki są uporządkowane według @search.rerankerBoostedScore.

{
  "value": [
    {
      "@search.score": 0.63,
      "@search.rerankerScore": 2.98,
      "@search.rerankerBoostedScore": 7.68,
      "content": "boosted content 2"
    },
    {
      "@search.score": 1.12,
      "@search.rerankerScore": 3.12,
      "@search.rerankerBoostedScore": 5.61,
      "content": "boosted content 1"
    }
  ]
}