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ó kompatibilitástörő változásai a lekérdezési logikára korlátozódnak a legutóbbi API-kban, de ha a kódot a kezdeti előzetes verzióra írták, előfordulhat, 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:
-
searchFieldssemanticConfiguration2021-04-30-preview -
queryLanguage2023-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.
Ha Azure SDK-kat használ, a rendszer több API-t is átnevezett. 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-preview | Hozzáadás a queryType=semantic keresési dokumentumokhoz |
| preview | 2021-04-30-preview | Hozzáadás az semanticConfiguration index létrehozásához vagy frissítéséhez |
| preview | 2023-07-01-preview | Frissítések semanticConfiguration. 2023. július 14-től kezdődően queryLanguage a Microsoft által üzemeltetett szemantikai modellek frissítései szemantikai rangsoroló nyelv-agnosztikussá tették a tulajdonságot a szemantikai rangsorolás érdekében. 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. |
| preview | 2023-10-01-preview |
semanticQuery Csak újraküldési célokra használt lekérdezés küldéséhez ad hozzá. |
| stabil | 2023-11-01 | Általánosan elérhető. A stabil verzióra semanticConfiguration vonatkozó módosításokat vezetett be. 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. |
| preview | 2024-05-01-preview | Nem változott |
| stabil | 2024-07-01 | Nem változott |
| preview | 2024-09-01-preview | Nem változott |
| preview | 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. |
Az Azure SDK-k naplóinak módosítása
Az Azure SDK-k független kiadási ütemezésben vannak. A változásnaplókban meg kell állapítania, hogy mely csomagok biztosítanak szemantikai szolgáltatásokat, és hogy az API-k átnevezve lettek-e.
- Az Azure SDK for .NET változásnaplója
- Azure SDK for Python változásnaplója
- Azure SDK for Java változásnaplója
- Azure SDK for JavaScript változásnaplója
2024-11-01-preview
- Lekérdezés-átírást ad hozzá 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-preview
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-preview
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
SemanticDebuga 2023-10-01-es verziót, éssemanticQueryellenkező esetben megegyezik a 2023-10-01-es verzióval.
2023-10-01-preview
- Hozzáteszi
semanticQuery
2023-07-01-preview
- Hozzáadja
semanticErrorHandling,semanticMaxWaitInMilliseconds. - Számos szemantikai vonatkozású mezőt ad hozzá a válaszhoz, például
SemanticDebugésSemanticErrorMode. -
queryLanguageFigyelmen kívül hagyja, már nem használja a szemantikai rangsorban.
2023. július 14-től kezdődően a szemantikai rangsoroló nyelv agnosztikus. 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
semanticConfigurationkeresési indexhez. A szemantikai konfigurációk neve és rangsorolása mezőlista. - Hozzáadja a "'prioritizedFields' elemet.
A searchFields tulajdonság már nem a mezők rangsorolására szolgál. Az előrehaladt semanticConfiguration.prioritizedFieldssearchFields verziókban az L2-rangsoroláshoz használandó mezők meghatározására szolgáló mechanizmust kell felváltani.
2020-06-30-preview
- A szemantikai támogatás a Search Documents előzetes verziójú API-hívásán keresztül érhető el.
- Hozzáadja
queryType=semantica lekérdezési kérelemhez. - Úgy alkalmazkodik
searchFields, hogy ha a lekérdezés típusa szemantikai, asearchFieldstulajdonság határozza meg a mezőbemenetek prioritási sorrendjét a szemantikai rangsorolóhoz. - Hozzáadja és
answershighlightshozzáadjacaptionsa lekérdezési választ.
Következő lépések
Szemantikai lekérdezés futtatásával tesztelje a szemantikai konfiguráció migrálását.