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

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.

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 agentowego pobierania i źródła wiedzy, które indeksuje zawartość w Wyszukiwanie AI platformy Azure, wygenerowany indeks ma już konfigurację semantyczną, która odpowiada Twojej 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 usługi wyszukiwania 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 pokazujący, jak utworzyć konfigurację semantyczną 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.

Wyrażenie zgody na modele wstępne semantycznego rankingu

Uwaga

Ta funkcja jest obecnie dostępna w wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Wygólne warunki użytkowania Microsoft Azure Previews.

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-08-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.

Tworzenie zapytania semantycznego

  • Last updated on