Konfiguracja semantycznego mechanizmu rankingowego i zwracanie podpisów w wynikach wyszukiwania

Uwaga

Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.

Ważna

Funkcje lub możliwości oznaczone (wersja zapoznawcza) w tym artykule znajdują się w publicznej wersji zapoznawczej i podlegają dodatkowym warunkom użytkowania Microsoft Azure w wersji zapoznawczej. Informacje o warunkach wersji zapoznawczej specyficznych dla Foundry IQ (Wyszukiwanie AI platformy Azure) znajdują się w artykule Funkcje wersji zapoznawczej.

Semantyczny ranking iteruje po początkowym zestawie wyników, stosując metodologię rankingu L2, która promuje najbardziej semantycznie istotne wyniki na szczyt stosu. Możesz również uzyskać napisy semantyczne z wyróżnieniem najistotniejszych terminów i fraz oraz odpowiedziami semantycznymi.

W tym artykule wyjaśniono, jak skonfigurować indeks wyszukiwania do semantycznego ponownego sortowania.

Uwaga

Jeśli masz istniejący kod, który wywołuje wersje wstępne lub poprzednie wersje interfejsu API, zobacz Migrowanie semantycznego kodu klasyfikacji, aby uzyskać pomoc dotyczącą modyfikowania kodu.

Wymagania wstępne

Wybieranie klienta

Można określić semantyczną konfigurację dla nowych lub istniejących indeksów przy użyciu dowolnego z następujących narzędzi i zestawów SDK w celu dodania konfiguracji semantycznej:

Dodawanie konfiguracji semantycznej

Niektóre obciążenia automatycznie tworzą konfigurację semantyczną. Jeśli używasz agentic retrieval i źródła wiedzy, które indeksuje zawartość w Foundry IQ, wygenerowany indeks ma już konfigurację semantyczną, która działa dla zawartości.

Wskazówka

Począwszy od wersji interfejsu API 2026-05-01-preview, obsługiwane przepływy bazy wiedzy dla agentowego pobierania nie wymagają jawnie zdefiniowanej konfiguracji semantycznej. Ten wyjątek nie dotyczy klasycznych zapytań klasyfikacji semantycznej ani starszych wersji interfejsu API. Aby uzyskać więcej informacji, zobacz Tworzenie źródła wiedzy indeksu wyszukiwania.

W przypadku innych obciążeń można samodzielnie skonfigurować konfigurację semantyczną. Semantyczna konfiguracja to sekcja w twoim indeksie, która określa pola wejściowe używane do klasyfikacji semantycznej. W dowolnym momencie można dodać lub zaktualizować konfigurację semantyczną bez konieczności ponownego kompilowanie. Jeśli tworzysz wiele konfiguracji, możesz określić wartość domyślną. W czasie wykonywania zapytania określ konfigurację semantyczną w żądaniu zapytania lub pozostaw ją pustą, aby użyć wartości domyślnej.

W jednym indeksie można utworzyć maksymalnie 100 konfiguracji semantycznych.

Konfiguracja semantyczna ma nazwę i następujące właściwości:

Właściwość Cechy
Pole tytułu Krótki ciąg, najlepiej poniżej 25 słów. To pole może być tytułem dokumentu, nazwy produktu lub unikatowego identyfikatora. Jeśli nie masz odpowiedniego pola, pozostaw to pole puste.
Pola zawartości Dłuższe fragmenty tekstu w postaci języka naturalnego, z zastrzeżeniem maksymalnych limitów wejściowych tokenu w modelach uczenia maszynowego. Typowe przykłady obejmują treść dokumentu, opis produktu lub inny tekst dowolny.
Pola słów kluczowych Lista słów kluczowych, takich jak tagi w dokumencie lub termin opisowy, taki jak kategoria elementu.

Można określić tylko jedno pole tytułu, ale możesz mieć dowolną liczbę pól zawartości i słów kluczowych. W przypadku pól zawartości i słów kluczowych wyświetl pola w kolejności priorytetów, ponieważ pola o niższym priorytecie mogą zostać obcięte.

We wszystkich właściwościach konfiguracji semantycznej przypisywane pola muszą być następujące:

  • Przypisano jako searchable i retrievable
  • Ciągi typu Edm.String, Collection(Edm.String), podpola ciągów Edm.ComplexType
  1. Przejdź do swojej usługi Foundry IQ w portalu Azure.

  2. W obszarze Indeksy w okienku nawigacji po lewej stronie wybierz indeks.

  3. Wybierz pozycję Konfiguracje semantyczne , a następnie wybierz pozycję Dodaj konfigurację semantyczną.

    Zrzut ekranu przedstawiający opcję dodania konfiguracji semantycznej w portalu Azure.

  4. Na stronie Nowa konfiguracja semantyczna wprowadź nazwę konfiguracji semantycznej i wybierz pola do użycia w konfiguracji semantycznej. Kwalifikują się tylko pola znakowe, które można przeszukiwać i pobierać. Pamiętaj, aby wyświetlić listę pól zawartości i pól słów kluczowych w kolejności priorytetów.

    Zrzut ekranu przedstawiający sposób tworzenia konfiguracji semantycznej w portalu Azure.

  5. Wybierz pozycję Zapisz , aby zapisać ustawienia konfiguracji.

  6. Wybierz ponownie pozycję Zapisz na stronie indeksu, aby zapisać konfigurację semantyczną w indeksie.

Zgłoś chęć korzystania z przedpremierowych modeli rankingu semantycznego (wersja zapoznawcza)

Korzystając z interfejsów API REST preview i Azure SDKs w wersji zapoznawczej, które udostępniają właściwość, można opcjonalnie skonfigurować indeks tak, aby używał modeli klasyfikacji semantycznych wersji wstępnych, jeśli został wdrożony w twoim regionie. Nie ma mechanizmu umożliwiającego określenie, czy jest dostępna w wersji wstępnej, czy też została użyta w konkretnym zapytaniu. Z tego powodu zalecamy użycie tej właściwości w środowiskach testowych i tylko wtedy, gdy interesuje Cię wypróbowanie najnowszych modeli klasyfikacji semantycznej.

Właściwość konfiguracji to "flightingOptIn": true, która jest ustawiona w sekcji semantycznej konfiguracji indeksu. Właściwość ma wartość null lub false domyślnie. Wartość true można ustawić w żądaniu tworzenia lub aktualizacji w dowolnym momencie i ma wpływ na zapytania semantyczne w przyszłości, zakładając, że zapytanie określa konfigurację semantyczną, która zawiera właściwość.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-11-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Następne kroki

Przetestuj konfigurację semantyczną, uruchamiając zapytanie semantyczne.