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

Note

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

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 Hozzáadja queryType=semantic a keresési dokumentumokhoz.
Preview 2021.04.30-i előzetes Hozzáadja a(z) semanticConfiguration elemet az „Index létrehozása vagy frissítése” művelethez.
Preview 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.
Preview 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.
Preview 2024-05-01-preview Nincs változás.
Stabil 2024-07-01 Nincs változás.
Preview 2024.09.01- előzetes Nincs változás.
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.
Preview 2025-03-01-preview Választási lehetőséget ad a szemantikai modellek előzetes verzióihoz való csatlakozáshoz.
Preview 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.
Preview 2025-08-01-preview Nincs változás.
Stabil 2025-09-01 Nincs változás.
Preview 2025-11-01-preview Ingyenes szinteken érhető el.
Stabil 2026-04-01 Külön kezeli a számlázásra vonatkozó beleegyezést a szemantikai rangsoroló és az ügynöki visszakeresés esetében. semanticSearch mostantól csak a szemantikus rangsoroló számlázását vezérli. A frissítés előtt, ha van semanticSearch=standard, a(z) knowledgeRetrieval=standard értéket is be kell állítania. További információ: Szemantikai rangsoroló számlázásának engedélyezése vagy letiltása.
Preview 2026-05-01-előzetes Nincs változás.
Preview 2026-08-01-preview Nincs változás.

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:

2024.11.01. - előnézet

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

  • Utolsó frissítés időpontja: