Szemantikai rangsorolási kód migrálása a korábbi verziókból

Ha a szemantikai rangsorolási kód a korai előzetes verziójú API-kra lett írva, ez a cikk azonosítja az újabb API-verziókra való migráláshoz szükséges kódmódosításokat. A szemantikai rangsorolóra vonatkozó, a kompatibilitást érintő változások a lekérdezési logikára korlátozódnak a legutóbbi API-kban, azonban ha a kódot a kezdeti előzetes verzióra készítették, lehetséges, hogy a szemantikai konfigurációt is módosítania kell.

Kompatibilitástörő változások

A szemantikai rangsoroló két kompatibilitástörő változtatást hajt végre a REST API-verziókban:

• searchFields le lett cserélve semanticConfiguration-re 2021-04-30-previewben
• queryLanguage 2023-07-01-preview verziótól kezdve figyelmen kívül lett hagyva, de 2024-11-01-preview verzióban visszaállították a lekérdezés újraírásához

Az egyéb verzióspecifikus frissítések új képességekre vonatkoznak, de nem törik meg a meglévő kódot, ezért nem törik meg a módosításokat.

Amennyiben Azure SDK-kat használ, több API-t átneveztek az idő múlásával. Az SDK változásnaplói adják meg a részleteket.

Szemantikai rangsorolást biztosító API-verziók

Ellenőrizze a REST API-verzió vagy az SDK-csomag verzióját, és ellenőrizze, hogy melyik biztosítja a szemantikai rangsorolást. Az alábbi API-verziók támogatják a szemantikai rangsorolást.

Kiadás típusa	REST API-verzió	Szemantikai rangsoroló frissítései
kezdeti	2020.06.30-i előzetes	A queryType=semantic hozzáadása a keresési dokumentumokhoz
előzetes verzió	2021.04.30-i előzetes	Az semanticConfiguration hozzáadása az index létrehozása vagy frissítése során
előzetes verzió	2023.07.01-preview	Frissítések semanticConfiguration. 2023. július 14-től kezdődően a Microsoft által üzemeltetett szemantikai modellek frissítései nyelv-agnosztikussá tették a szemantikai rangsorolót, ami ténylegesen megszüntette a queryLanguage tulajdonságot a szemantikai rangsorolás során. A kódban nincs kompatibilitástörő változás, de a tulajdonság figyelmen kívül lesz hagyva. Az ügyfeleknek azt javasolták, hogy távolítsa el ezt a tulajdonságot a kódból.
előzetes verzió	2023-10-01-preview	semanticQuery hozzáadása a lekérdezés küldéséhez, amelyet csak újrarangsorolási célokra használnak.
stabil	2023.11.01	Általánosan elérhető. Olyan változtatásokat vezetett be a semanticConfiguration komponensen, amelyek a stabil verzióvá fejlődtek. Ha a kód ezt a verziót vagy újabb verziót célozza meg, akkor kompatibilis az újabb API-verziókkal, hacsak nem vezet be új előzetes verziójú funkciókat.
előzetes verzió	2024-05-01-preview	Nem változott
stabil	2024-07-01	Nem változott
előzetes verzió	2024.09.01- előzetes	Nem változott
előzetes verzió	2024-11-01-preview	Hozzáadja a lekérdezés újraírását. A queryLanguage tulajdonságra most már szükség van a lekérdezés újraírása (előzetes verzió) használata esetén.
előzetes verzió	2025-03-01-preview	Választási lehetőséget ad a szemantikai modellek előzetes verzióihoz való csatlakozáshoz.
előzetes verzió	2025-05-01-preview	Ebben az előzetes verzióban nincs API-frissítés, de a szemantikai rangsorolás jobb integrációt mutat a pontozási profilokkal.
előzetes verzió	2025-08-01-preview	Nem változott
előzetes verzió	2025-11-01-preview	Ingyenes szinteken érhető el.

Az Azure SDK-k változásnaplói

Annak megállapításához, hogy mely szemantikai funkciók érhetők el egy adott Azure SDK-csomagban, és hogy átnevezték-e az API-kat, tekintse meg az SDK változásnaplóját:

• Az Azure SDK for .NET változásnaplója
• Azure SDK for Python változásnaplója
• Azure SDK Java számára: változásnapló
• Azure SDK for JavaScript változásnaplója

2024.11.01. - előnézet

• Hozzáadja a lekérdezés-átírást a keresési dokumentumokhoz.
• A lekérdezés újraírásához számítási feladatokra van szükség queryLanguage . Az érvényes értékek listájáért tekintse meg a REST API-t.

2024-09-01-előzetes

A szemantikai rangsor szintaxisa nem változik a 2024-07-01-es stabil verzióban.

2024-07-01

A szemantikai rangsor szintaxisa nem módosul a 2024-05-01 előzetes verzióban.

Ne használja ezt az API-verziót. Olyan vektoros lekérdezési szintaxist implementál, amely nem kompatibilis bármely újabb API-verzióval.

2024-05-01-preview

A szemantikai rangsor szintaxisa nem módosul a 2024-03-01 előzetes verzióban.

2024-03-01-előzetes

A 2023-10-01-es verzió szemantikai rangsorolásának szintaxisa nem módosul, de vektoros lekérdezések jelennek meg. A szemantikai rangsorolás mostantól a hibrid és vektoros lekérdezések válaszaira vonatkozik. A válaszban szereplő bármely, emberi olvasásra alkalmas szövegmezőre alkalmazhatja az újrarankálást, feltéve, hogy a mezők a listában prioritizedFieldsszerepelnek.

2023-11-01

• Kizárja SemanticDebug és semanticQuery, egyébként megegyezik a 2023-10-01-előzetes verzióval.

2023-10-01-előzetes

• Hozzáteszi semanticQuery

2023. július 1. - előnézet

• Hozzáadja semanticErrorHandling, semanticMaxWaitInMilliseconds.
• Számos szemantikai vonatkozású mezőt ad hozzá a válaszhoz, például SemanticDebug és SemanticErrorMode.
• queryLanguage figyelmen kívül hagyva, már nem használják a szemantikai rangsorolásban.

2023. július 14-től a szemantikai rangsoroló nyelvfüggetlen. Az előzetes verziókban a szemantikai rangsorolás a mezőelemző által megadotttól querylanguage eltérő eredményeket deprioritizálná. A queryLanguage tulajdonság azonban továbbra is alkalmazható a helyesírás-javításra és a funkció által támogatott nyelvek rövid listájára.

2021-04-30-preview

• A szemantikai támogatás a Dokumentumok keresése és az Index előzetes verziójú API-hívások létrehozása vagy frissítése révén érhető el.
• Hozzáad egy semanticConfiguration keresési indexhez. A szemantikai konfigurációnak van neve és egy rangsorolt mezőlistája.
• Hozzáadja a "prioritizedFields" elemet.

A searchFields tulajdonság már nem a mezők rangsorolására szolgál. A jövőbeni verziókban a semanticConfiguration.prioritizedFields felváltja a searchFields mechanizmust, amely meghatározza az L2 rangsoroláshoz használandó mezőket.

2020-06-30-előnézet

• A szemantikai támogatás a Search Documents előzetes verziójú API-hívásán keresztül érhető el.
• Hozzáadja queryType=semantic a lekérdezési kérelemhez.
• Úgy alkalmazkodik searchFields , hogy ha a lekérdezés típusa szemantikai, a searchFields tulajdonság határozza meg a mezőbemenetek prioritási sorrendjét a szemantikai rangsorolóhoz.
• Hozzáadja captions, answers és highlights a lekérdezési válaszhoz.

Következő lépések

Szemantikai lekérdezés futtatásával tesztelje a szemantikai konfiguráció migrálását.

Szemantikai lekérdezés létrehozása