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

Note

Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.

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.

Zásadní změny

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

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

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 Aktualizace sémantického řadicího algoritmu
Počáteční 2020-06-30-preview Přidá queryType=semantic do vyhledávacích dokumentů.
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 aktualizace sémantických modelů hostovaných společností Microsoft učinily sémantické rankery nezávislé na jazyce, což efektivně ukončilo používání vlastnosti queryLanguage 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 1. 10. 2023 ve verzi Preview Přidá semanticQuery k odeslání dotazu použitého pouze pro účely opětovného řazení.
Stabilní 01. 11. 2023 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 Žádná změna.
Stabilní 2024-07-01 Žádná změna.
Preview 2024-09-01-preview Žádná změna.
Preview 1. 11. 2024 – preview Přidá přepisování dotazu. Vlastnost queryLanguage je nyní vyžadována, pokud použijete přepis dotazu (náhled).
Preview 2025-03-01-preview Přidá možnost zapsání se k předběžným verzím sémantických modelů.
Preview 2025-05-01-preview V této verzi Preview nejsou žádné aktualizace rozhraní API, ale sémantické řazení teď má lepší integraci s bodovacími profily.
Preview 2025-08-01-preview Žádná změna.
Stabilní 2025-09-01 Žádná změna.
Preview 2025-11-01-preview K dispozici na úrovních Free.
Stabilní 2026-04-01 Odděluje souhlas s účtováním pro sémantické řazení a agentní vyhledávání. semanticSearch nyní řídí pouze sémantické účtování ranker. Před upgradem, pokud máte semanticSearch=standard, musíte také nastavit knowledgeRetrieval=standard. Další informace najdete v tématu Povolení nebo zakázání fakturace sémantického třídicího algoritmu.
Preview 2026-05-01-preview Žádná změna.

Protokoly změn pro sady Azure SDK

Pokud chcete zjistit, které sémantické funkce jsou k dispozici v konkrétním balíčku sady Azure SDK a jestli se nějaká rozhraní API přejmenovala, podívejte se do protokolu změn sady SDK:

2024-11-01-preview

2024-09-01-náhled

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

01.07.2024

Žá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-náhled

Žádné změny syntaxe sémantického řazení od verze 2023-10-01-preview, ale jsou zaváděny nové vektorové dotazy. 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 seznamu prioritizedFields.

1. 11. 2023

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

2023-10-01-náhled

  • Přidává semanticQuery

2023-07-01-náhled

  • 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 verzi Preview by sémantické řazení de-prioritizovalo výsledky, které se liší 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-náhled

Vlastnost searchFields se už nepoužívá k určení priority polí. Ve všech budoucích verzích nahrazuje semanticConfiguration.prioritizedFieldssearchFields jako mechanismus pro určení, která pole používat pro hodnocení L2.

2020-06-30-náhled

  • Sémantická podpora probíhá prostřednictvím volání rozhraní API pro vyhledávání dokumentů.
  • 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.
  • captionsPřidá answersa 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

  • Last updated on