Sdílet prostřednictvím

Migrace sémantického kódu řazení z předchozích verzí

  • Článek

Pokud byl váš sémantický kód řazení napsán proti rozhraním API s dřívějšími verzemi Preview, tento článek identifikuje změny kódu potřebné pro migraci na novější verze rozhraní API. Zásadní změny sémantického rankeru jsou omezené na logiku dotazu v nedávných rozhraních API, ale pokud byl váš kód napsaný proti počáteční verzi Preview, možná budete muset změnit i sémantickou konfiguraci.

Změny způsobující chyby

U sémantických rankerů ve verzích rozhraní REST API existují dvě zásadní změny:

  • searchFields semanticConfiguration v roce 2021-04-30-preview
  • queryLanguage byl ignorován od verze 2023-07-01-preview, ale znovu byl obnoven pro přepsání dotazu v 2024-11-01-preview.

Další aktualizace specifické pro jednotlivé verze se týkají nových funkcí, ale nerušují stávající kód, a proto nejsou zásadními změnami.

Pokud používáte sady Azure SDK, bylo v průběhu času přejmenováno více rozhraní API. Protokoly změn sady SDK obsahují podrobnosti.

Verze rozhraní API poskytující sémantické řazení

Zkontrolujte kód verze rozhraní REST API nebo verze balíčku sady SDK a ověřte, která verze poskytuje sémantické hodnocení. Následující verze rozhraní API mají určitou úroveň podpory sémantického řazení.

Typ vydání Verze rozhraní REST API Sémantické aktualizace rankeru
počáteční 2020-06-30-preview Přidá queryType=semantic do dokumentů hledání
preview 2021-04-30-preview Přidá semanticConfiguration k vytvoření nebo aktualizaci indexu.
preview 2023-07-01-preview Aktualizace semanticConfiguration. Od 14. července 2023 se aktualizace sémantických modelů hostovaných Microsoftem zpřístupnily sémantické sémantické rankery nezávislé na jazyce a efektivně vyřadí queryLanguage vlastnost z provozu pro sémantické řazení. V kódu není žádná změna způsobující chybu, ale vlastnost se ignoruje. Zákazníkům se doporučilo odebrat tuto vlastnost z kódu.
preview 2023-10-01-preview Přidá semanticQuery k odeslání dotazu použitého pouze pro účely opětovného řazení.
stáj 2023-11-01 Obecně dostupné. Zavedli jsme změny semanticConfiguration , které postupovaly ve stabilní verzi. Pokud váš kód cílí na tuto verzi nebo novější, je kompatibilní s novějšími verzemi rozhraní API, pokud nepřidáte nové funkce ve verzi Preview.
preview 2024-05-01-preview Beze změny
stáj 2024-07-01 Beze změny
preview 2024-09-01-preview Beze změny
preview 2024-11-01-preview Přidá přepsání dotazu. Vlastnost queryLanguage se teď vyžaduje, pokud použijete přepis dotazu (Preview).

Protokoly změn pro sady Azure SDK

Sady Azure SDK jsou v nezávislém plánu vydávání verzí. Měli byste zkontrolovat protokoly změn a zjistit, které balíčky poskytují sémantické funkce a jestli byla přejmenována nějaká rozhraní API.

2024-11-01-preview

  • Přidá přepsání dotazu do vyhledávacích dokumentů.
  • Vyžaduje queryLanguage pro úlohy přepisování dotazů. Seznam platných hodnot najdete v rozhraní REST API.

2024-09-01-preview

Ve stabilní verzi 2024-07-01 nedošlo k žádným změnám syntaxe sémantického řazení.

2024-07-01

Žádné změny syntaxe sémantického řazení z verze 2024-05-01-preview.

Tuto verzi rozhraní API nepoužívejte. Implementuje syntaxi vektorového dotazu, která není kompatibilní s žádnou novější verzí rozhraní API.

2024-05-01-preview

Ve verzi 2024-03-01-preview nejsou žádné změny syntaxe sémantického řazení.

2024-03-01-preview

Žádné změny syntaxe sémantického řazení z verze 2023-10-01-preview, ale vektorové dotazy se zavádějí. Sémantické řazení se teď vztahuje na odpovědi z hybridních a vektorových dotazů. Pořadí můžete použít u všech textových polí čitelných pro člověka v odpovědi za předpokladu, že jsou pole uvedená v prioritizedFieldsseznamu .

2023-11-01

  • Vyloučí SemanticDebug a semanticQueryv opačném případě bude stejná jako verze 2023-10-01-preview.

2023-10-01-preview

  • Přidává semanticQuery

2023-07-01-preview

  • Přidá semanticErrorHandling, semanticMaxWaitInMilliseconds.
  • Přidá do odpovědi mnoho sémantických polí, například SemanticDebug a SemanticErrorMode.
  • queryLanguageIgnoruje , už se nepoužívá v sémantickém pořadí.

Od 14. července 2023 je sémantický ranker nezávislý na jazyce. Ve verzích Preview by se sémantické řazení odlišovalo od zadaného querylanguage analyzátoru polí. queryLanguage Tato vlastnost se ale stále vztahuje na opravu pravopisu a krátký seznam jazyků podporovaných danou funkcí.

2021-04-30-preview

Vlastnost searchFields se už nepoužívá k určení priority polí. Ve všechverzích semanticConfiguration.prioritizedFieldssearchFields

2020-06-30-preview

  • Sémantická podpora je prostřednictvím volání rozhraní API pro vyhledávání dokumentů ve verzi Preview.
  • Přidá queryType=semantic do požadavku dotazu.
  • searchFields Přizpůsobí se tak, že pokud je typ dotazu sémantický, searchFields vlastnost určuje pořadí priority vstupů polí do sémantického rankeru.
  • answersPřidá captionsa highlights do odpovědi dotazu.

Další kroky

Otestujte migraci sémantické konfigurace spuštěním sémantického dotazu.

Vytvoření sémantického dotazu