Megosztás a következőn keresztül:


Adatsík REST API-verziók (Azure AI Search)

Ez a cikk az Azure AI Search REST API-jainak aktuális és korábbi verzióit sorolja fel.

Verziószámozott API-dokumentumok

A REST API-dokumentumok már verziószámozottak. Amikor megnyit egy API-referencialapot, megjelenik egy verzióválasztó a tartalomjegyzék felett. Győződjön meg arról, hogy az API-referencia a Referencia>Adatsík mappából származik.

A verzióválasztó képernyőképe.

Stabil verziók

API-verzió Előírás API-frissítések
2024-07-01 (legújabb) Swagger specifikációs Kibocsátási megjegyzés
2023-11-01 Swagger specifikációs Kibocsátási megjegyzés
2020-06-30 Swagger specifikációs Kibocsátási megjegyzés
2019-05-06 Swagger specifikációs Összetett típusokat ad hozzá.

Előzetes verzió

Az előzetes verziókkal tesztelheti az új funkciókat, visszajelzéseket gyűjthet, és felderítheti és kijavíthatja a problémákat. Az előzetes verziójú API-k a Microsoft Azure Previews kiegészítő használati feltételeialatt érhetők el.

API-verzió Előírás API-frissítések
2025-05-01-preview (legújabb) Swagger specifikációs Kibocsátási megjegyzés
2025-03-01-preview Swagger specifikációs Kibocsátási megjegyzés
2024-11-01-preview Swagger specifikációs Kibocsátási megjegyzés
2024-09-01-preview Swagger specifikációs Kibocsátási megjegyzés
2024-05-01-preview Swagger specifikációs Kibocsátási megjegyzés
2024-03-01-preview Swagger specifikációs Kibocsátási megjegyzés
2023-10-01-preview Swagger specifikációs Kibocsátási megjegyzés
2023-07-01-preview (elavult) Swagger specifikációs Kibocsátási megjegyzés
2021-04-30-preview Swagger specifikációs Kibocsátási megjegyzés
2020-06-30-preview Swagger specifikációs Kibocsátási megjegyzés
2019-05-06-preview Swagger specifikációs Kibocsátási megjegyzés

Kibocsátási megjegyzések

2025-05-01-preview

Ez az előzetes verzió a 2025-03-01-previewjelenleg előzetes verzióban elérhető összes funkcióra épül, és tartalmazza azokat.

A REST API verziókat2025-03-01-preview2025-05-01-preview minimális kódmódosítással frissítheti.

Ez az előzetes verzió támogatja az ügynöki lekérést, a multimodális indexelést, az engedélyek öröklését a dokumentum szintjén, valamint a nagy nyelvi modellekkel való mélyebb integrációt az indexelési és lekérdezési számítási feladatokban.

Az Azure AI Search újdonságai további információkat tartalmaznak.

Tulajdonság Frissít Alkalmazható REST API
Ügynöki visszakeresés Lekérdezésbővítést ad hozzá beszélgetési nyelvi modellek használatával az intelligens lekérdezéstervezéshez. Emellett összetett választ is generál, amely földelési adatokat tartalmaz az alsóbb rétegbeli csevegőalkalmazásokhoz. A válasz tartalmaz egy lekérdezési tervet és a forrásdokumentumokon alapuló referenciaadatokat. Tudásügynökök és tudáskeresés
GenAI prompt skill Lehetővé teszi a promptok és az LLM megadását az új mezőtartalom létrehozásához. Képességkészlet létrehozása vagy frissítése
Dokumentum Elrendezés képesség Mostantól támogatja a képészlelést és a környezet megőrzését a multimodális indexeléshez. Képességkészlet létrehozása vagy frissítése
Azure Logic Apps integráció Kibővíti a munkafolyamatokból futó indexelő-alapú indexelés támogatott adatforrástípusait. Adatforrások létrehozása vagy frissítése
Dokumentumszintű engedélyek öröklése Támogatja a felhasználónkénti engedélyekkel rendelkező keresési eredményeket. Indexek létrehozása vagy frissítése (engedélyszűrők)

Adatforrások létrehozása vagy frissítése (engedélybeállítások)

2025-03-01-preview

Ez az előzetes verzió a 2024-11-01-previewjelenleg előzetes verzióban elérhető összes funkcióra épül, és tartalmazza azokat. Minimális kódmódosításokkal frissíthet a 2024-11-01-preview2025-03-01-preview. További információ: REST API-k frissítése.

Ebben az előzetes verzióban csak néhány adatsík API-frissítés található, de további képességek érhetők el a keresési szolgáltatásban, amikor a kód meghívja ezt az előzetes verziójú API-verziót. További információ: Az Azure AI Search újdonságai.

Frissít Alkalmazható REST API
Dimenziós hierarchiák, összesítés és szűrők, amelyek a hierarchikus, összesített és szűrt dimenziók dimenziós navigációs struktúráinak létrehozására szolgálnak. Dokumentumok keresése, új dimenzióparaméterek a kérelemben.
Szemantikai rangsoroló feliratkozás a fedélzeti modellekhez Index létrehozása vagy frissítése, új flightingOptIn logikai tulajdonság a szemantikai konfigurációs szakaszban. Ha a keresési szolgáltatási régióban elérhető egy előzetes verziójú szemantikai rangsorolási modell, a rendszer a másodlagos rangsoroláshoz a stabil verzió helyett használja. Ez a tulajdonság azoknak a fejlesztőknek készült, akik a legújabb rangsorolási modelleket nem éles kódon szeretnék tesztelni.

2024-11-01-preview

Ez az előzetes verzió a 2024-09-01-previewjelenleg előzetes verzióban elérhető összes funkcióra épül, és tartalmazza azokat. Minimális kódmódosításokkal frissíthet a 2024-09-01-preview2024-11-01-preview. További információ: REST API-k frissítése.

Frissít Alkalmazható REST API
Lekérdezés újraírása a szemantikai reranker, amely az L2 rangsorolónak küldött lekérdezések finomítására szolgál. Dokumentumok keresése, a kérés új QueryRewritesType tulajdonsága.
dokumentumelrendezési képesség a dokumentum szerkezetének elemzéséhez. , új DocumentIntelligenceLayoutSkill képesség létrehozása vagy frissítése.
Felügyelt identitás az Azure AI többszolgáltatásos erőforráscsatolásához. , új AIServicesAccountIdentity tulajdonság létrehozása vagy frissítése.
Markdown-elemzési mód, amely Markdown-fájlok indexelésére szolgál az Azure Storage-ban. Indexelő létrehozása vagy frissítése, új markdown elemzési mód.
tömörített vektorokújraszerkesztési beállításai, amelyeket a tömörített vektorok helyett az eredeti vektorokkal történő újrakorrekcióhoz használnak. A HNSW és a teljes KNN-vektor algoritmusokra vonatkozik bináris és skaláris tömörítéssel. Indexlétrehozása vagy frissítése, új rescoringOptions tulajdonságok. A 2024.03.01-2024-03-01-ben bevezetett enableRescoring új rerankWithOriginalVectors tulajdonság leképezett.

2024-09-01-preview

Ez az előzetes verzió a 2024-05-01-previewjelenleg előzetes verzióban elérhető összes funkcióra épül, és tartalmazza azokat. A 2024-05-01-preview-ről 2024-09-01-preview frissíthet, és nincs szükség kódmódosításra. További információ: REST API-k frissítése.

Frissít Alkalmazható REST API
Csonkolt dimenziók a Matryoshka Representation Learning (MRL) kvantálásán áttanított 3-kicsi és szövegbeágyazási-3-nagy modellekhez. Indexlétrehozása vagy frissítése, új csonkolásDimension paraméter
A Reciprocal Rank Fusion (RRF)által pontozott hibrid keresési eredmények kicsomagolásának részletei. Dokumentumok keresése, új hibakeresési paraméter és lekérdezési alpontdefiníciók a válaszban.
Célszűrés egy hibrid keresési lekérdezés vektorrészére. Search Documents, new filterOverride paraméter a RawVectorQuery, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery.
A jogkivonatok Szöveg felosztása képességben, nem csak karakterekben. Képességkészlet létrehozása vagy frissítése, új egység paraméter és egyéb jogkivonattal kapcsolatos tulajdonságok.

2024-07-01

Ez a verzió általánosan elérhető frissítéseket biztosít az integrált vektorizáláshoz (készségek és vektorizálók), a skaláris kvantáláshoz és a bináris kvantáláshoz. Részletekért tekintse meg Az Azure AI Search újdonságai.

Frissít Alkalmazható REST API
Általánosan elérhető – vektoros adattípusok index létrehozása vagy frissítése
Általánosan elérhető – vektorkvantálási tulajdonságok a beépített skaláris vagy bináris kvantáláshoz a keresési indexben. index létrehozása vagy frissítése
Általánosan elérhető – tárolt tulajdonság egy vektormezőn, amely meghatározza, hogy a mező egy további példánya van-e tárolva. A további másolat a mező lekért tartalma. Ha nem tárolja, a mező továbbra is használható a lekérdezésekben, de nem adható vissza keresési eredményként. Ezt a tulajdonságot úgy állíthatja be, hogy helyet biztosítson a keresési szolgáltatásban vagy a vektorkvóta egy keresési indexben. index létrehozása vagy frissítése
Általánosan elérhető – VectorizableTextQuery paraméterek a relevanciahangoláshoz. A hibrid lekérdezési paraméterek (MaxTextSizeRecall) továbbra is előzetes verzióban érhetők el. Dokumentumok keresése
Általánosan elérhető – Az AzureOpenAIEmbedding képesség több modellt támogat, mint a text-embedding-ada-002 integrált vektorizáláshoz az indexelés során. Adja meg a modell nevét és dimenziótulajdonságait egy adott modell megcélzásához. Képességkészlet létrehozása vagy frissítése
Általánosan elérhető – Azure OpenAI-beágyazási vektorizáló a lekérdezések során történő integrált vektorizáláshoz. A vektorizáló tulajdonságai további modelleket támogatnak. index létrehozása vagy frissítése
Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását. Minden verzió

2024-05-01-preview

Ez az előzetes verzió támogatja a OneLake-indexelést, a relevanciahangolást és a mélyebb integrációt a több beágyazási modellel az indexelés és a lekérdezések során. A 2024-03-01-preview épül, és tartalmazza azokat.

Ha 2024-03-01-preview vagy 2023-10-01-previewszeretne frissíteni, frissítse az AzureOpenAIEmbedding készséget vagy vektorosítót, hogy tartalmazza a modell nevét és dimenzióit. Ha frissíteni szeretne 2023-07-01-preview (elavult) vagy részletes útmutatást szeretne, olvassa el A REST API-k frissítése.

Az alábbi frissítéseket tekintheti meg ebben az előzetes verzióban. Azt is javasoljuk, Az Azure AI Searchújdonságai.

Frissít Alkalmazható REST API
Indexelő adatforrás OneLake-fájlokhoz és parancsikonokhoz. Adatforrás- létrehozása vagy frissítése
Collection(Edm.Byte)bináris adattípus az őket támogató modellek beágyazásához. A vektormező-definíciók támogatják ezt az adattípust. index létrehozása vagy frissítése
Több vektoros és hibrid lekérdezési paraméter a relevanciahangoláshoz. Állítsa be a küszöbértékeket az alacsony pontozási eredmények kizárásához. Súly vektoros lekérdezések. Hibrid lekérdezések esetén állítsa be a maximális dokumentumokat a hibrid lekérdezés szövegrészében való lekérésre. Dokumentumok keresése
Új Azure AI Vision-képesség a multimodális integrált vektorizációhoz az indexelés során. Ez a képesség meghívja az Azure AI Vision multimodális API-ját. Képességkészlet létrehozása vagy frissítése
Új Azure AI Vision-vektorizáló multimodális lekérdezésekhez. A vektorizáló az indexdefiníciókban van megadva, de a lekérdezés végrehajtása során használatos. index létrehozása vagy frissítése
Frissítettük az AzureOpenAIEmbedding képességet, hogy az indexelés során több modellt támogatjon, mint a text-embedding-ada-002. Adja meg a modell nevét és dimenziótulajdonságait egy adott modell megcélzásához. Képességkészlet létrehozása vagy frissítése
Frissítettük az Azure OpenAI-beágyazási vektorizálót az integrált vektorizáláshoz a lekérdezések során. A vektorizáló tulajdonságai további modelleket támogatnak. index létrehozása vagy frissítése
Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását. Minden verzió

2024-03-01-preview

Ez az előzetes verzió a 2023-10-01-preview a vektoros tárolást javító előzetes API-k hozzáadásával épül fel. Részletekért tekintse meg Az Azure AI Search újdonságai.

Frissít Alkalmazható REST API
Az új a vektormezők szűk adattípusait, ha olyan modelleket ágyaz be, amelyek támogatják azokat, vagy a kisebb vektorokat kimenetként szolgáló kvantálási logikával rendelkezik. index létrehozása vagy frissítése
Új vektorkvantálási tulajdonságok a keresési indexek beépített vektortömörítéséhez. index létrehozása vagy frissítése
Új logikai tárolt tulajdonság egy vektormezőn, amely meghatározza, hogy a mező egy további példánya van-e tárolva. A további másolat a mező lekért tartalma. Ha nem tárolja, a mező továbbra is használható a lekérdezésekben, de nem adható vissza keresési eredményként. Ezt a tulajdonságot úgy állíthatja be, hogy helyet biztosítson a keresési szolgáltatásban vagy a vektorkvóta egy keresési indexben. index létrehozása vagy frissítése
Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását. Minden verzió

2023-11-01

Ez a verzió általánosan elérhető funkciókat biztosít. Részletekért tekintse meg Az Azure AI Search újdonságai.

Frissít Alkalmazható REST API
Szemantikai rangsorolás a Search Post-kérelmekben. Dokumentumok keresése
Vektorkeresés konfigurálása az indexelő vektormezőkhöz index létrehozása vagy frissítése
Vektoros lekérdezések a Search Post-kérelmekben. Dokumentumok keresése
Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását. Minden verzió

2023-10-01-preview

Ez a verzió tartalmazza a korábbi előzetes verziókban bevezetett összes funkciót, valamint a vektorkeresési API-k hozzáadását és módosítását. A vektorkeresési API-k frissítései a 2023-07-01-preview verziótól való kompatibilitástörő változást jelentenek. Lásd: Vektormezők hozzáadása és Vektoros lekérdezés létrehozása migrálási súgó.

Ha az új előszűrési képességet kívánja használni, akkor a .2023-10-01

Indexlétrehozása vagy frissítése:

  • vectorSearch algorithms, profilesés vectorizersdefiníciókkal rendelkezik:

    • algorithms továbbra is támogatja a hnsw, és mostantól a eknnis támogatja, hivatkozva a hierarchikus navigálható kisvilágra (HNSW) és a teljes K-legközelebbi szomszédokra (eKNN). Az algoritmus szakaszon belül a HNSW és az eKNN paraméterek több elnevezett kombinációját is definiálhatja. Ez a 2023-07-01-preview algorithmConfigurations tulajdonságon belüli vectorSearch helyettesíti.

    • profiles egy új definíció, amely meghatározza az algoritmus konfigurációját. Tegyük fel például, hogy rendelkezik HNSW-1, HSNW-2 és eKNN-1 nevű algoritmuskonfigurációkkal. Előfordulhat, hogy egy profil HNSW-1 értéket ad meg.

    • vectorizers egy indexben van definiálva, de a lekérdezési időpontban egy szöveges lekérdezési sztring beágyazására szolgál. A vektorizáló beágyazási modellre hivatkozik. A keresőszolgáltatás meghívja a beágyazási modellt a szöveges lekérdezési sztring vektorizálására, majd átadja az eredményt a keresőmotornak egy vektoros lekérdezéshez.

  • A vektormezőkben vectorSearchProfilevectorSearchConfigurationcseréli le. A vectorSearchProfile tulajdonság határozza meg, hogy melyik vektorkeresési profilt használja a mező.

  • Az API-verzió előtt létrehozott indexeken a 2023-10-01-Preview API meghívásakor a kérésben módosítania kell a mezőt egy vectorSearchProfile megadásához, feltéve, hogy a profil pontosan ugyanazt az algoritmust adja meg, amelyet korábban a vectorSearchConfiguration. Ha például a meglévő meződefiníció "vectorSearchConfiguration": "myHnsw"határoz meg, akkor azt "vectorSearchProfile": "your profile name"kell lecserélni, és a profilt úgy kell definiálni , hogy ugyanarra a "algorithm": "myHnsw"hivatkozzon.

Dokumentumok keresése:

  • vectorQueries 2023-07-01-preview vectors cseréli le
  • vectorQueries.vectors 2023-07-01-preview vectors.values helyettesíti.
  • A vektoros lekérdezés ma már polimorfikus struktúra. kind meg kell adni a kért vektoros lekérdezés típusát. "kind": "vector" azt jelenti, hogy a lekérdezés vektor, ezért a hívónak már vektorizálta a keresési lekérdezési sztringet egy vektoros beágyazással.
  • "exhaustive": "true" egy új tulajdonság, amely meghatározza, hogy teljes körű (találgatásos) k-legközelebbi szomszédkeresést végezzen-e a vektorindex összes vektorában.
  • vectorFilterMode egy új paraméter az előszűrés (alapértelmezés szerint a után 2023-10-01létrehozott indexek esetében) vagy az utószűrés (alapértelmezett a korábbi indexeken) megadásához a lekérdezésben.

Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását.

2023-07-01-preview

Fontos

Ne használja ezt az API-verziót. Az előzetes verzió elavulását 2024. április 15-én jelentették be, és 2024. július 8. után már nem támogatott. A migrálással kapcsolatos segítségért lásd: REST API-k frissítése az Azure AI Search.

Ez a verzió bevezette a vektortámogatást, és olyan vektorkonfigurációt használ, amely nem kompatibilis az újabb API-verziókkal.

2021-04-30-preview

Ez az előzetes verzió tartalmazza a 2020-06-30 előzetes verzióban bevezetett összes funkciót, valamint a következő API-k kiegészítéseit:

2020-06-30

Ez a verzió általánosan elérhető funkciókat biztosít, többek között a következőket:

  • Azure szerepköralapú hozzáférés-vezérlés adatsík-műveletekhez
  • Relevanciapontozás (BM25)
  • Tudástárak
  • Indexelő adatforrás az Azure Data Lake Storage (ADLS) Gen2-hez
  • Egyéni entitáskeresési képesség
  • Rendszer vagy felhasználó által felügyelt identitás alatt futó indexelők a Microsoft Entra-azonosítón keresztül
  • Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását.

2020-06-30-preview

Ez az előzetes verzió tartalmazza a 2019.05.06-előzetes verzióban bevezetett összes funkciót, valamint a következő kiegészítéseket:

  • Szemantikai keresés, egy prémium szintű szolgáltatás, amely standard szintű szolgáltatásokon fut, és amely szemantikai rangsorolást hív meg.
  • Indexelő adatforrás Power Query-összekötőkhöz
  • Indexelő adatforrás a MySQL-hez
  • Indexelő adatforrás a Cosmos DB Gremlin API-hoz
  • Indexelő adatforrás a SharePoint Online-hoz
  • Normalizer tulajdonság szöveg normalizálásához, kis- és nagybetűk megkülönböztetése szűréséhez, szűréséhez és rendezéséhez
  • Az indexelőalapú indexelés dokumentumainak alaphelyzetbe állítása adott dokumentumok egyedi azonosító szerinti frissítéséhez
  • Entitások összekapcsolása kognitív képesség (v3)
  • Entitásfelismerési kognitív képesség (v3)
  • Hangulatelemzési kognitív képesség (v3)
  • Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását.

2019-05-06-preview

  • Indexelő adatforrás támogatása a Cosmos DB MongoDB API-hoz
  • Indexelő adatforrás a Blob Storage helyreállítható törléséhez
  • featuresMode paraméter, amely részletes információkat ad vissza egy relevanciapontról
  • Az Azure Machine Learning (AML) kognitív készsége
  • Személyes azonosítás észlelése kognitív képesség
  • Gyorsítótárazza a bővített dokumentumokat a képfeldolgozás (és más AI-bővítések) megőrzése és újbóli felhasználása érdekében
  • Érvényes 2024. március 29-én: A GET válaszok már nem adnak vissza kapcsolati sztringeket vagy kulcsokat. A részletekért lásd kapcsolati adatokat beolvasó ügyfélkód kompatibilitástörő változását.

Lásd még: