Frissítés a legújabb REST API-ra a Azure AI Keresés

Ez a cikk a Keresési szolgáltatás REST API-jainak újabb verzióiba, valamint az adatsík- és vezérlősíkműveletekkereséskezelési REST API-iiba való migráláshoz használható.

A REST API-k legújabb verziói a következők:

A frissítési utasítások olyan kódmódosításokra összpontosítanak, amelyek átvezetik a korábbi verziók kompatibilitástörő módosításain, így a meglévő kód ugyanúgy fut, mint korábban, de az újabb API-verzión. Ha a kód működése rendben van, eldöntheti, hogy újabb funkciókat vezet-e be. Az új funkciókról további információt a Az Azure AI Keresés újdonságai című témakörben talál.

Javasoljuk, hogy egymás után frissítse az API-verziókat, és az egyes verziókon haladjon végig, amíg el nem ér a legújabb verzióhoz.

2023-07-01-preview volt az első REST API a vektortámogatáshoz. Ne használja ezt az API-verziót. Ez most elavult, és azonnal át kell telepítenie a stabil vagy újabb előzetes REST API-kba.

Mikor kell frissíteni?

Azure AI Keresés végső megoldásként megszakítja a visszamenőleges kompatibilitást. Frissítésre akkor van szükség, ha:

• A kód egy kivezetett vagy nem támogatott API-verzióra hivatkozik, és egy vagy több kompatibilitástörő változásnak van kitéve.

• A kód meghiúsul, ha a rendszer nem felismert tulajdonságokat ad vissza egy API-válaszban. Ajánlott eljárásként az alkalmazásnak figyelmen kívül kell hagynia azokat a tulajdonságokat, amelyeket nem ért.

• A kód megőrzi az API-kéréseket, és megpróbálja újraküldni őket az új API-verzióra. Ez például akkor fordulhat elő, ha az alkalmazás megőrzi a Keresési API-ból visszaadott folytatási tokeneket (további információért keressen @search.nextPageParameters a keresési API-referencia-ban).

Frissítés

1. Ha adatsík-verziót frissít, tekintse át, hogy mi jelent meg az új API-verzióban.

2. Frissítse a api-version kérelem fejlécében megadott paramétert egy újabb verzióra.

   A REST API-khoz közvetlen hívásokat kezdeményező alkalmazáskódban keresse meg a meglévő verzió összes példányát, majd cserélje le az új verzióra. A REST-hívások strukturálásáról további információt a következő rövid útmutatóban talál: Teljes szöveges keresés REST használatával.

   Ha Azure SDK használ, minden csomag a REST API egy adott verzióját célozza meg. Annak megállapításához, hogy a csomag melyik REST API-verziót támogatja, tekintse át a változásnaplót. Frissítsen a legújabb csomagverzióra a legújabb funkciók és API-fejlesztések eléréséhez.

3. Ha adatsík-verziót frissít, tekintse át a cikkben dokumentált kompatibilitástörő módosításokat, és implementálja a kerülő megoldásokat. Kezdje a kód által használt verzióval, és oldja fel az egyes újabb API-verziók kompatibilitástörő változásait, amíg el nem ér a legújabb stabil vagy előzetes kiadáshoz.

Kompatibilitástörő változások

A következő meghatározó változások az adatműveletekre vonatkoznak.

Az autonóm lekérés kompatibilitást megszakító változásai

2026-04-01 az ügynöki lekérés első stabil REST API-verziója. A következő kompatibilitástörő változásokat vezeti be 2025-11-01-preview:

• A rendszer eltávolítja a válaszszintézist, a lekérdezéstervezést és a konfigurálható érvelési erőfeszítéseket. A lekérés csak kinyert, földelt tartalmat ad vissza.

• A lekérési kérelem alakja megváltozik: messages lecserélődik intents-re, és több paramétert átneveznek vagy eltávolítanak.

• A blobok és OneLake-tudásbázisok dokumentumszintű engedélyszűrése nem támogatott.

A tulajdonságszintű módosítások és migrálási lépések teljes listáját az ügynöki lekérési kód migrálása című témakörben találja.

A tudásügynökök kompatibilitástörő változásai

A tudásügynökök a következő helyen 2025-05-01-previewlettek bevezetve: . 2025-08-01-preview Ebben targetIndexesaz esetben egy új tudásforrás-objektumra cserélték, és defaultMaxDocsForReranker más API-kra cserélték. További kompatibilitástörő változásokat vezettek be a 2025-11-01-preview.

A tulajdonságszintű módosítások és migrálási lépések teljes listáját az ügynöki lekérési kód migrálása című témakörben találja.

Kompatibilitástörő változások a kapcsolati adatokat beolvasó ügyfélkódban

2024. március 29-én lép hatályba, és az összes támogatott REST API-ra érvényes:

• A GET Skillset, a GET Index és a GET Indexer már nem ad vissza kulcsokat vagy kapcsolattulajdonságokat a válaszban. Ez egy kompatibilitástörő változás, ha olyan alsóbb rétegbeli kóddal rendelkezik, amely kulcsokat vagy kapcsolatokat (bizalmas adatokat) olvas be a GET-válaszból.

• Ha le kell kérnie a keresési szolgáltatás rendszergazdai vagy lekérdezési API-kulcsait, használja a Search Management REST API-kat.

• Ha egy másik Azure erőforrás( például Azure Storage vagy Azure Cosmos DB) kapcsolati sztringjeinek lekérésére van szüksége, használja az erőforrás API-jait és a közzétett útmutatást az információk beszerzéséhez.

A szemantikai besorolási rendszer kompatibilitástörő változásai

Szemantikai rangsoroló általánosan elérhetővé vált 2023-11-01. Ezek a korábbi kiadások kompatibilitástörő változásai:

• A 2020-06-01-preview utáni összes verzióban a semanticConfiguration az searchFields helyére lép az L2-rangsoroláshoz használatos mezők meghatározásának mechanizmusaként.

• Minden API-verzió esetében a Microsoft által üzemeltetett szemantikai modelleket 2023. július 14-én frissítették, aminek eredményeként a szemantikai rangsoroló nyelvfüggetlenné vált, és gyakorlatilag megszűnt a queryLanguage tulajdonság. A kódban nincs "kompatibilitástörő változás", de a tulajdonság figyelmen kívül lesz hagyva.

Lásd Migrálás az előzetes verzióról, hogy a kódot semanticConfiguration-re áttérje.

Adatsík frissítései

A frissítési útmutató feltételezi, hogy a frissítés a legutóbbi korábbi verzióról történt. Ha a kód egy régi API-verzión alapul, javasoljuk, hogy az egymást követő verziókon keresztül frissítsen a legújabb verzióra.

Frissítés a 2026-08-01 előzetes verzióra

2026-08-01-preview Új ügynöki lekérési vezérlőket, tudásbázis-fejlesztéseket és kurzorlapozást ad hozzá a listaműveletekhez.

A frissítés előtt ellenőrizze, hogy az alábbi 2026-08-01-preview kompatibilitástörő módosítások érvényesek-e a kódra:

• Az agentes lekérés kompatibilitást megszakító változásai közé tartoznak a tevékenységnaplókban található beágyazott model objektumok, az MCP-tudásforrás kiszolgálói eszközei esetében a resultsProcessinginclusionMode általi felváltása, valamint az ügyfél tulajdonában lévő Microsoft Entra-alkalmazás hitelesítése a Work IQ-tudásforrásokhoz. Részletes migrálási útmutatásért tekintse meg az ügynöki lekérési kód migrálását ismertető témakört.

• Az adatforrások, indexelők, indexek, képességkészletek és tudásforrások listázási műveletei esetében a(z) $top, $skip és $count helyére a pageSize, search és @odata.nextLink használatával megvalósított kurzoralapú lapozás lép. Az új lapozási mechanizmussal kapcsolatos további információkért lásd: Page through Azure AI Keresés list results (preview).

Az összes többi meglévő API esetében nincsenek viselkedésbeli változások. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés a 2026-05-01 előzetes verzióra

2026-05-01-preview új tudásbázistípusokat, a lekérési művelet új paramétereit, új SharePoint indexelő tartalomtípusokat, ACL-beállításokat és egyéb képességeket ad hozzá.

A 2025-11-01-preview-hoz képest nincsenek wire protocol szintű kompatibilitást törő változások. Ha azonban a Python- vagy JavaScript SDK-t használja az ágensi visszakereséshez, a retrieve ügyfél neve KnowledgeBaseRetrievalClient-ra változik, és a retrieveKnowledge(...) helyébe retrieve(...) lép. Az SDK migrálásával kapcsolatos útmutatásért lásd: Az agentikus lekérési kód migrálása.

Az összes többi meglévő API esetében nincsenek viselkedésbeli változások. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés 2026-04-01-re

2026-04-01 A legújabb stabil REST API-verzió. Elősegíti az ágens-alapú információlekérést, a tudásforrások kiválasztását, valamint számos készséget és funkciót az általános elérhetőségre.

A frissítés előtt ellenőrizze, hogy az alábbi 2026-04-01 kompatibilitástörő módosítások érvényesek-e a kódra:

• Hat tulajdonság törlődik a GenAI Prompt képességdefiníciójából: httpMethod, timeout, batchSize, degreeOfParallelism, httpHeadersés authResourceId. A frissítés előtt távolítsa el ezeket a tulajdonságokat. A tulajdonságokat továbbra is tartalmazó definíciók hibát adnak 400 Bad Request vissza.

• Az "agentic retrieval" most már saját számlázási hozzájárulást igényel. Ha jelenleg van semanticSearch=standard, a frissítés előtt explicit módon be kell állítania knowledgeRetrieval=standard . További információ: Ügynöki lekéréses számlázás engedélyezése vagy letiltása.

• Ha az ügynöki lekérési kód a 2025-11-01-preview elemet célozza meg, akkor a 2026-04-01 eltávolít több előzetes képességet, és szabványosítja a lekérést a szándékok bemenete, a kinyerés kimenete és a minimális érvelés körül. További információért lásd: Ügynöki lekérési kód migrálása.

Az összes többi meglévő API esetében nincsenek viselkedésbeli változások. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés a 2025-11-01-preview verzióra

2025-11-01-preview a következő törést okozó változtatásokat vezeti be az ügynöki lekérdezésen belül, a 2025-08-01-preview-ben végrehajtva.

• A agents elemet kicseréli knowledgebases elemre. A tudásbázis-definícióból és a lekérési műveletből több, a tudásbázishoz kapcsolódó tulajdonság is elmozdult.

• A tudásbázis tulajdonságai újrabontásra kerülnek, és új ingestionParameters objektumot implementálnak az indexelő folyamatot létrehozó tudásbázisokhoz.

A tulajdonságszintű módosítások és migrálási lépések teljes listáját az ügynöki lekérési kód migrálása című témakörben találja.

Az összes többi meglévő API esetében nincsenek viselkedésbeli változások. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés 2025.09.01-re

2025-09-01 egy stabil REST API-verzió, amely általános elérhetőséget biztosít a OneLake indexelőhöz, a Dokumentumelrendezés képességhez, és más API-khoz.

Nem történik jelentős változás, ha 2024-07-01 verzióról frissít, és nem használ semmilyen előzetes funkciót. Az új stabil kiadás használatához módosítsa az API-verziót, és tesztelje a kódot.

Frissítés a 2025-08-01-preview verzióra

2025-08-01-preview A következő kompatibilitástörő változásokat vezeti be a 2025-05-01-preview használatával létrehozott tudásügynökökre:

• A targetIndexes elemet kicseréli knowledgeSources elemre.
• defaultMaxDocsForReranker Csere nélkül távolítja el.

Ellenkező esetben a meglévő API-k nem változnak. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés a 2025-05-01-preview verzióra

2025-05-01-preview új funkciókat biztosít, de a meglévő API-k nem változnak. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés a 2025-03-01 előzetes verzióra

2025-03-01-preview új funkciókat biztosít, de a meglévő API-k nem változnak. Felcserélheti az új API-verziót, és a kód ugyanúgy fut, mint korábban.

Frissítés a 2024-11-01-preview verzióra

2024-11-01-preview lekérdezés újraírása, Dokumentumelrendezési képesség, kulcs nélküli számlázás a készségek feldolgozásához, Markdown-elemzési mód és a tömörített vektorok újraszerkesztési beállításai.

Ha frissít 2024-09-01-preview, kicserélheti az új API-verzióra, és a kód ugyanúgy fog futni, mint korábban.

Az új verzió azonban szintaxismódosításokat vezet be a következőhöz vectorSearch.compressions:

• rerankWithOriginalVectors cserélve enableRescoring-re
• Áthelyezés defaultOversampling új rescoringOptions tulajdonságobjektumba

A visszamenőleges kompatibilitás egy belső API-leképezés miatt megmarad, de javasoljuk, hogy az új előzetes verzió bevezetésekor módosítsa a szintaxist. A szintaxis összehasonlítása: Vektorok tömörítése skaláris vagy bináris kvantálás használatával.

Frissítés a 2024-09-01 előzetes verzióra

2024-09-01-preview Hozzáadja a Matryoshka Representation Learning (MRL) tömörítést a text-embedding-3 modellekhez, a hibrid lekérdezések célzott vektorszűrését, a hibakeresési vektor alérték részleteit és a Text Split skill token-darabolását.

Ha frissít 2024-05-01-preview, kicserélheti az új API-verzióra, és a kód ugyanúgy fog futni, mint korábban.

Frissítés 2024.07.01-re

2024-07-01 egy általános kiadás. A korábbi előzetes verziójú funkciók már általánosan elérhetők: integrált adattömb- és vektorizálás (Text Split skill, AzureOpenAIEmbedding skill), azureOpenAIEmbedding alapú lekérdezésvektor, vektortömörítés (skaláris kvantálás, bináris kvantálás, tárolt tulajdonság, keskeny adattípusok).

A(z) 2024-05-01-preview stabil verzióra történő frissítésekor nincsenek kompatibilitástörő változások. Az új stabil kiadás használatához módosítsa az API-verziót, és tesztelje a kódot.

Ha közvetlenül frissít a 2023-11-01 rendszerről, jelentős változások következhetnek be. Az áttelepítéshez kövesse az egyes újabb előzetes verziókban ismertetett lépéseket 2023-11-01-ról 2024-07-01-re.

Frissítés a 2024-05-01 előzetes verzióra

2024-05-01-preview hozzáad egy indexelőt Microsoft OneLake-hez, bináris vektorokhoz és további beágyazási modellekhez.

Ha frissít 2024-03-01-preview, az AzureOpenAIEmbedding funkcióhoz most egy modellnév és dimenzió paraméter szükséges.

1. Keresse meg a kódbázisban az AzureOpenAIEmbedding-hivatkozásokat .

2. Állítsa modelName be a "text-embedding-ada-002" értéket, és állítsa dimensions az "1536" értéket.

Frissítés a 2024-03-01 előzetes verzióra

2024-03-01-preview keskeny adattípusokat, skaláris kvantálást és vektoros tárolási lehetőségeket ad hozzá.

Ha Ön frissít valamire 2023-10-01-preview, nincsenek kompatibilitástörő változások. Van azonban egy viselkedésbeli különbség: az újabb és újabb előzetes verziók esetében 2023-11-01 az vectorFilterMode alapértelmezett beállítás a postfilterről előszűrőre változott a szűrőkifejezések esetében.

1. Keresse meg a vectorFilterMode hivatkozásokat a kódbázisban.

2. Ha a tulajdonság kifejezetten be van állítva, nincs szükség műveletre. Ha az alapértelmezett értékre támaszkodik, az új alapértelmezett viselkedés szerint a szűrés a lekérdezés végrehajtása előtt történik. Ha a lekérdezés utáni szűrést szeretné elvégezni, a régi viselkedés megőrzése érdekében explicit módon állítsa vectorFilterMode be a postfilter értékre.

Frissítés 2023.11.01-re

2023-11-01 egy általános kiadás. A korábbi előzetes verziójú funkciók már általánosan elérhetők: szemantikai rangsoroló és vektortámogatás.

Vannak megszakító változások 2023-10-01-preview-ról 2023-07-01-preview-re, de nincsenek megszakító változások 2023-11-01-tól. További információért lásd: Frissítés 2023-07-01-preview verzióból.

Az új stabil kiadás használatához módosítsa az API-verziót, és tesztelje a kódot.

Frissítés a 2023-10-01-preview verzióra

2023-10-01-preview volt az első előzetes verzió, amely beépített adattömb- és vektorizálást adott hozzá az indexelés és a beépített lekérdezésvektorizálás során. Támogatja a vektorindexelést és az előző verzióból származó lekérdezéseket is.

Ha az előző verzióról frissít, a következő szakaszban találja a lépéseket.

Frissítés a 2023.07.01-i előzetes verzióról

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.

2023-07-01-preview elavult, ezért ne alapozza az új kódot erre a verzióra, és semmilyen körülmények között ne frissítsen erre a verzióra. Ez a szakasz ismerteti a migrációs útvonalat a 2023-07-01-preview bármely újabb API-verzióra.

Portálfrissítés vektorindexekhez

Azure portál támogatja a 2023-07-01-preview indexek egykattintásos frissítési útvonalát. Felérzékeli a vektormezőket, és biztosít egy Migrálás gombot.

• A migrálási útvonal 2023-07-01-preview-tól 2024-05-01-preview-ig tart.
• A frissítések a vektormező-definíciókra és a vektorkeresési algoritmus konfigurációira korlátozódnak.
• A frissítések egyirányúak. A frissítés nem vonható vissza. Az index frissítése után 2024-05-01-preview vagy újabb verziót kell használnia az index lekérdezéséhez.

A vektoros lekérdezés szintaxisának frissítéséhez nincs portálmigrálás. A lekérdezésszintaxis változásait a kódfrissítések között tekintheti meg.

A Migrálás kiválasztása előtt válassza a JSON szerkesztése lehetőséget a frissített séma áttekintéséhez. Olyan sémát kell találnia, amely megfelel a kódfrissítési szakaszban leírt módosításoknak. A portálmigrálás csak egy vektorkeresési algoritmus konfigurációjával kezeli az indexeket. Létrehoz egy alapértelmezett profilt, amely megfelel a vektorkeresési 2023-07-01-preview algoritmusnak. A több vektoros keresési konfigurációval rendelkező indexek manuális migrálást igényelnek.

Vektorindexek és lekérdezések kódfrissítése

A vektorkeresés támogatása a Létrehozás vagy frissítés indexben (2023-07-01-preview) jelent meg.

Az 2023-07-01-preview bármelyik újabb stabil vagy előzetes verzióra való frissítéshez a következőre van szükség:

• A vektorkonfiguráció átnevezése és átszervezése az indexben
• Vektoros lekérdezések újraírása

Az ebben a szakaszban található utasítások segítségével migrálhatja a vektormezőket, a konfigurációt és a lekérdezéseket.2023-07-01-preview

1. Hívja meg az Index lekérése parancsot a meglévő definíció lekéréséhez.

2. Módosítsa a vektorkeresés konfigurációját. 2023-11-01 és a későbbi verziók bemutatják a vektorprofilok fogalmát, amelyek egy név alatt kötik össze a vektorokkal kapcsolatos konfigurációkat. Az újabb verziók átnevezik a algorithmConfigurations-t algorithms-re.

   • Átnevezés algorithmConfigurations : algorithms. Csupán a tömb átnevezése történik. A tartalom visszafelé kompatibilis. Ez azt jelenti, hogy a meglévő HNSW konfigurációs paraméterek használhatók.

   • Adjon hozzá profilesegy nevet és egy algoritmuskonfigurációt mindegyikhez.

   Migrálás előtt (2023-07-01-preview):

     "vectorSearch": {
       "algorithmConfigurations": [
           {
               "name": "myHnswConfig",
               "kind": "hnsw",
               "hnswParameters": {
                   "m": 4,
                   "efConstruction": 400,
                   "efSearch": 500,
                   "metric": "cosine"
               }
           }
       ]}
   

   Migrálás után (2023-11-01):

     "vectorSearch": {
       "algorithms": [
         {
           "name": "myHnswConfig",
           "kind": "hnsw",
           "hnswParameters": {
             "m": 4,
             "efConstruction": 400,
             "efSearch": 500,
             "metric": "cosine"
           }
         }
       ],
       "profiles": [
         {
           "name": "myHnswProfile",
           "algorithm": "myHnswConfig"
         }
       ]
     }
   

3. Módosítsa a vektormező-definíciókat, és cserélje le vectorSearchConfiguration a következőre vectorSearchProfile: . Győződjön meg arról, hogy a profilnév egy új vektor profil definícióra oldódik fel, nem pedig az algoritmus konfigurációs nevére. A vektormező egyéb tulajdonságai változatlanok maradnak. Nem lehet például szűrhető, rendezhető vagy facetable, és nem használhat elemzőket, normalizálókat vagy szinonimatérképeket.

   Előtte (2023-07-01-preview):

     {
         "name": "contentVector",
         "type": "Collection(Edm.Single)",
         "key": false,
         "searchable": true,
         "retrievable": true,
         "filterable": false,  
         "sortable": false,  
         "facetable": false,
         "analyzer": "",
         "searchAnalyzer": "",
         "indexAnalyzer": "",
         "normalizer": "",
         "synonymMaps": "", 
         "dimensions": 1536,
         "vectorSearchConfiguration": "myHnswConfig"
     }
   

   2023-11-01 után:

     {
       "name": "contentVector",
       "type": "Collection(Edm.Single)",
       "searchable": true,
       "retrievable": true,
       "filterable": false,  
       "sortable": false,  
       "facetable": false,
       "analyzer": "",
       "searchAnalyzer": "",
       "indexAnalyzer": "",
       "normalizer": "",
       "synonymMaps": "", 
       "dimensions": 1536,
       "vectorSearchProfile": "myHnswProfile"
     }
   

4. A módosítások közzétételéhez hívja meg az Index létrehozása vagy frissítése parancsot.

5. Módosítsa a Search POST függvényt a lekérdezés szintaxisának módosításához. Ez az API-módosítás lehetővé teszi a polimorf vektoros lekérdezéstípusok támogatását.

   • Átnevezés vectors : vectorQueries.
   • Minden vektoros lekérdezéshez adja hozzá kind, és állítsa be a következőre vector: .
   • Minden vektoros lekérdezéshez nevezze át a value-t vector-re.
   • Ha vectorFilterMode használ, adja hozzá. Az alapértelmezett érték az 2023-10-01 után létrehozott indexek előszűrője. Az adott dátum előtt létrehozott indexek csak a szűrő mód beállításától függetlenül támogatják a postfiltert.

   Előtte (2023-07-01-preview):

   {
       "search": "*", //Required by the API but ignored for ranking in vector-only queries
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   2023-11-01 után:

   {
     "search": "*", //Required by the API but ignored for ranking in vector-only queries
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

Ezek a lépések befejezik a migrálást a stabil API-verzióra 2023-11-01 vagy az újabb előzetes verziójú API-verziókra.

Frissítés 2020.06.30-ra

Ebben a verzióban egy kompatibilitástörő változás és számos viselkedésbeli különbség van. Általánosan elérhető funkciók:

• Tudástár, a készségkészleteken keresztül létrehozott gazdagított tartalom állandó tárolása, amelyet az alsóbb rétegbeli elemzéshez és más alkalmazásokon keresztüli feldolgozáshoz hoztak létre. A tudástár Azure AI Keresés REST API-kon keresztül jön létre, de Azure Storage található.

Kompatibilitástörő változás

A korábbi API-verziókra írt kód megtörik a 2020-06-30 és későbbi verziókban, ha az alábbi funkciókat tartalmazza:

• A Edm.Date szűrőkifejezésekben szereplő konstansoknak (például 2020-12-12egy év-hónap napból álló dátumnak) a Edm.DateTimeOffset következő formátumot kell követnie: 2020-12-12T00:00:00Z. Ez a módosítás szükséges volt a hibás vagy váratlan lekérdezési eredmények kezeléséhez az időzónák eltérései miatt.

Viselkedésváltozások

• A BM25 rangsorolási algoritmus az előző rangsorolási algoritmust újabb technológiára cseréli. A 2019 után létrehozott szolgáltatások automatikusan használják ezt az algoritmust. Régebbi szolgáltatások esetén paramétereket kell beállítania az új algoritmus használatához.

• A null értékek rendezett eredményei megváltoztak ebben a verzióban: a null értékek jelennek meg elsőként, ha a rendezés típusa asc, és utolsóként, ha a rendezés típusa desc. Ha a null értékek rendezésének kezelésére kódot írt, vegye figyelembe ezt a változást.

Frissítés 2019.05.06-ra

Az API-verzióban általánosan elérhetővé vált funkciók a következők:

• Az automatikus kiegészítés egy olyan funkció, amely kiegészíti a részben megadott kifejezést.
• Az összetett típusok natív támogatást nyújtanak a strukturált objektumadatokhoz a keresési indexben.
• JsonLines elemzési módok, az Azure Blob-indexelés része, JSON-entitásonként egy keresési dokumentumot hoz létre, amelyet egy új sor választ el egymástól.
• Az AI-bővítés olyan indexelést biztosít, amely az Foundry Tools AI-dúsítási motorjait használja.

Kompatibilitástörő változások

Egy korábbi API-verzióra írt kód nem működik 2019-05-06 és később sem, ha a következő funkciókat tartalmazza:

1. Az Azure Cosmos DB tulajdonság típusa. Az Azure Cosmos DB NoSQL API-hoz tartozó adatforrás indexelőinél módosítsa a "type": "documentdb" értékét "type": "cosmosdb" értékre.

2. Ha az indexelő hibakezelése hivatkozik a status tulajdonságra, távolítsa el. Eltávolítottuk az állapotot a hibaválaszból, mert nem adott meg hasznos információkat.

3. Az adatforrás kapcsolati sztringjei már nem jelennek meg a válaszban. Az API-verzióktól 2019-05-062019-05-06-Preview kezdve az adatforrás API már nem ad vissza kapcsolati sztringeket a REST-műveletek válaszában. A KORÁBBI API-verziókban a POST használatával létrehozott adatforrások esetében Azure AI Keresés visszaadta 201, majd az OData-választ, amely egyszerű szövegben tartalmazta a kapcsolati karakterlánc.

4. A nevesített entitásfelismerési kognitív képesség megszűnik. Ha a kódban a Név entitásfelismerési képességet hívta meg, a hívás sikertelen lesz. A helyettesítő funkció az Entity Recognition Skill (V3). Kövesse az elavult készségekre vonatkozó javaslatokat a támogatott készségekre való migráláshoz.

Összetett típusok frissítése

Az API-verzió 2019-05-06 formális támogatást adott az összetett típusokhoz. Ha a kód a 2017-11-11-Preview vagy a 2016-09-01-Preview verzióban implementálta az összetett típusok ekvivalenciájára vonatkozó korábbi javaslatokat, néhány új és módosított korlátokkal kell tisztában lennie verzió 2019-05-06-tól:

• Az almezők mélységére és az indexenkénti összetett gyűjtemények számára vonatkozó korlátok csökkentek. Ha olyan indexeket hozott létre, amelyek túllépik ezeket a korlátokat az előzetes verziójú API-verziók használatával, az API-verzióval 2019-05-06 való frissítésre vagy újbóli létrehozására tett kísérletek meghiúsulnak. Ha ebben a helyzetben találja magát, újra kell terveznie a sémát, hogy megfeleljen az új korlátoknak, majd újra kell építenie az indexet.

• Az API-verzió 2019-05-06 új korlátot szab a dokumentumonkénti összetett gyűjtemények elemeinek számával kapcsolatban. Ha az előzetes verziójú api-verziók használatával olyan dokumentumokkal hozott létre indexeket, amelyek túllépik ezeket a korlátokat, az api-verzióval 2019-05-06 végzett újraindexelés sikertelen lesz. Ha ebben a helyzetben találja magát, az adatok újraindexelése előtt csökkentenie kell a dokumentumonkénti összetett gyűjteményelemek számát.

További információ: Szolgáltatások korlátai Azure AI Keresés.

Régi komplex típusú struktúra frissítése

Ha a kód összetett típusokat használ az egyik régebbi előzetes verziójú API-verzióval, előfordulhat, hogy az alábbihoz hasonló indexdefiníciós formátumot használ:

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}  

Az API-verzióban 2017-11-11-Previewegy újabb faszerű formátum jelent meg az indexmezők meghatározásához. Az új formátumban minden összetett mező rendelkezik egy mezőgyűjteménysel, amelyben az almezők definiálva vannak. Az API 2019-05-06-os verziójában ez az új formátum kizárólag ezt a formátumot használja, és nem sikerül létrehozni vagy frissíteni egy indexet a régi formátum használatával. Ha a régi formátum szerint létrehozott indexek vannak, az API 2017-11-11-Preview verzióját kell használnia, hogy frissítse őket az új formátumra, mielőtt azok kezelhetők legyenek a 2019-05-06-os API verzióval.

A lapos indexeket az új formátumra frissítheti a következő lépésekkel az API-verzió 2017-11-11-Previewhasználatával:

1. GET kérést kell végrehajtania az index lekéréséhez. Ha már az új formátumban van, akkor elkészült.

2. Fordítsa le az indexet az egysíkú formátumról az új formátumra. Ehhez a feladathoz kódokat kell írnia, mivel az íráskor nem áll rendelkezésre mintakód.

3. PUT-kérés végrehajtása az index új formátumra való frissítéséhez. Ne módosítsa az index egyéb részleteit, például a mezők kereshetőségét/szűrhetőségét, mert a meglévő index fizikai kifejezését befolyásoló módosításokat az Update Index API nem engedélyezi.

Vezérlősík frissítései

A következőkre vonatkozik:2014-07-31-Preview , 2015-02-28és 2015-08-19

A listQueryKeys GET kérés a korábbi Search Management API-verziókon most már megszűnt. Javasoljuk, hogy a POST-kérés használatáhozlistQueryKeys migráljon a legújabb stabil vezérlősík API-verziójára.

1. A meglévő kódban módosítsa a paramétert api-version a legújabb verzióra (2025-05-01).

2. A kérés átkeretezése GET-ról POST-re:

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
   Authorization: Bearer {{token}}
   

3. Ha Azure SDK használ, javasoljuk, hogy frissítsen a legújabb verzióra.

Következő lépések

Tekintse át a Search REST API referenciadokumentációját. Ha problémákat tapasztal, kérjen segítséget a Stack Overflow szolgáltatással kapcsolatban, vagy forduljon az ügyfélszolgálathoz.