REST API-verziók (Azure AI-Keresés)

Ez a cikk az Azure AI-Keresés Keresés REST API-k 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, egy verzióválasztó jelenik meg a tartalomjegyzék felett.

1. Bontsa ki a Referencia > adatsík elemet.

2. Válasszon ki egy API-referencialapot.

3. Válasszon egy API-verziót a bal felső legördülő szűrőből.

   

Stabil verziók

API-verzió	Specifikáció	API-frissítések
2023-11-01 (Legújabb)	Swagger-specifikáció	Kibocsátási megjegyzés
2020-06-30	Swagger-specifikáció	Kibocsátási megjegyzés
2019-05-06	Swagger-specifikáció	Összetett típusokat ad hozzá.
2017-11-11	Swagger-specifikáció	Képességcsoportokat és AI-bővítést ad hozzá.
2016-09-01	Swagger-specifikáció	Indexelőket ad hozzá.
2015-02-28	2020. 10. 10. után nem támogatott	Első általánosan elérhető kiadás.

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 előzetes verziójának kiegészítő használati feltételei között érhetők el.

API-verzió	Specifikáció	API-frissítések
2024-03-01-Preview (Legújabb)	Swagger-specifikáció	Kibocsátási megjegyzés
2023-10-01-Preview	Swagger-specifikáció	Kibocsátási megjegyzés
2023-07-01-Preview (elavult)	Swagger-specifikáció	Kibocsátási megjegyzés
2021-04-30-Preview	Swagger-specifikáció	Kibocsátási megjegyzés
2020-06-30-Preview	Swagger-specifikáció	Kibocsátási megjegyzés
2019-05-06-Preview	Swagger-specifikáció	Kibocsátási megjegyzés
2017-11-11-Preview	Swagger-specifikáció	A stabil verzióhoz társított előzetes verzió.
2016-09-01-Preview	Swagger-specifikáció	A stabil verzióhoz társított előzetes verzió.
2015-02-28-Preview (kivezetve)	2020. 10. 10. után nem támogatott	A stabil verzióhoz társított előzetes verzió.
2014-10-20-Preview (kivezetve)	2020. 10. 10. után nem támogatott	Második nyilvános előzetes verzió.
2014-07-31-Preview (kivezetve)	2020. 10. 10. után nem támogatott	Első nyilvános előzetes verzió.

Kibocsátási megjegyzések

2024-03-01-Preview

Ez az előzetes verzió a következő előzetes verziójú API-k hozzáadásával épül 2023-10-01-preview fel, amelyekkel helyet takaríthat meg:

• Új , keskeny adattípusok a vektormezőkhöz , ha olyan modelleket ágyaz be, amelyek támogatják őket, vagy kvantálási logikával rendelkezik, amelyek kisebb vektorokat adnak ki.
• Új vektorkvantálási tulajdonságok a keresési index beépített vektortömörítéséhez.
• Ú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ényben. Ezt a tulajdonságot beállíthatja úgy, hogy helyet biztosítson a keresési szolgáltatásnak vagy a vektorkvótának egy keresési indexben.

2023-11-01

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

• Szemantikai rangsorolás Keresés Post-kérelmekben.
• Vektorkeresési indexelés Létrehozás vagy indexfrissítési kérelmekben, valamint vektoros lekérdezések Keresés Post-kérelmekben.

2023-10-01-Preview

Ez a verzió tartalmazza a korábbi előzetes verziókban bevezetett összes funkciót, valamint a vektoros keresési API-k hozzáadását és módosítását. Frissítések a vektoros keresési API-kra a 2023-07-01-Preview verzióhoz való kompatibilitástörő változás. A migráláshoz lásd: Vektormezők hozzáadása és vektoros lekérdezés Létrehozás.

Ha az új előszűrő képességet tervezi használni, a 2023.10.01. után létrehozott indexet kell használnia.

Létrehozás vagy index frissítése:

• vectorSearcha , profilesés vectorizersdefiníciókkal algorithmsrendelkezik:

  • algorithms továbbra is támogatja hnsw és most is támogatja eknna HNSW(Hierarchical Navigable Small World) (Hierarchical Navigable Small World, HNSW) és a teljes körű K-legközelebbi szomszédok (eKNN) használatát. Az algoritmus szakaszban a HNSW és az eKNN paraméterek több nevesített kombinációját is definiálhatja. Ez a vectorSearch 2023-07-01-Preview tulajdonságon belülre lépalgorithmConfigurations.

  • 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, eKNN-1 nevű algoritmuskonfigurációkkal. Egy profil HNSW-1-et adhat meg.

  • vectorizers egy indexben van definiálva, de a lekérdezéskor szöveges lekérdezési sztring beágyazására használatos. 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 a vectorSearchProfile helyére a képlet lép vectorSearchConfiguration. A vectorSearchProfile tulajdonság határozza meg, hogy melyik vektoros keresési profilt használja a mezőben.

• Az API-verzió előtt létrehozott indexek esetében a 2023-10-01-Preview API meghívásakor a kérésben módosítania kell a mezőt, hogy megadjon egy vectorSearchProfile értéket, amíg a profil pontosan ugyanazt az algoritmust adja meg, amelyet korábban a -ben vectorSearchConfigurationmegadott. Ha például a meglévő meződefiníció a értéket adja meg "vectorSearchConfiguration": "myHnsw", cserélje le a értékre "vectorSearchProfile": "your profile name", és a profilt úgy kell definiálni, hogy ugyanarra "algorithm": "myHnsw"hivatkozzon.

dokumentumok Keresés:

• vectorQueries replaces vectors in 2023-07-01-Preview

• vectorQueries.vectorsvectors.values a 2023-07-01-Preview verzióban cseréli le.

• A vektoros lekérdezés mostantól polimorf szerkezet. 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ásba.

• "exhaustive": "true" egy új tulajdonság azt határozza meg, hogy teljes körű (találgatásos) k-legközelebbi szomszédkeresést kell-e végezni a vektorindex összes vektorában.

• vectorFilterMode a 2023-10-01 után létrehozott indexek alapértelmezett előszűrési vagy utólagos szűrésének (alapértelmezett értéke a korábbi indexeken) megadására szolgáló új paraméter a lekérdezésben.

2023-07-01-Preview

Fontos

Az előzetes verzió elavulását 2024. április 15-én jelentették be, és 2024. július 8-án kivezetik. A migrálással kapcsolatos segítségért lásd: REST API-k frissítése az Azure AI-Keresés.

Ez a verzió a korábbi előzetes verziók funkcióival, valamint a vektorkeresés támogatásával rendelkezik:

• A keresési indexben rendeljen Collection(Edm.Single) adattípust olyan mezőkhöz, amelyek egypontos lebegőpontos számokat tartalmazó tömböt tartalmaznak. Ez az új vektorkeresési képesség adattípusa, amellyel dokumentummezőnként egy generált beágyazást tárolhat. A keresési indexben is adja meg a vektorkonfiguráció tulajdonságait. Ezekhez az API-khoz lásd a Létrehozás vagy az Index frissítése című témakört.

• Az indexelési számítási feladatok frissülnek a vektoradatok elfogadásához. Lásd: Dokumentumok hozzáadása, frissítése vagy törlése.

• A vektorkeresés lekérdezési paraméterei. Ezekről a paraméterekről Keresés Dokumentumok című témakörben olvashat.

• Szolgáltatásstatisztikák lekérése: vektorindexkvótát és -használatot ad vissza a szolgáltatáshoz.

• Indexstatisztikák lekérése: a keresési index vektorindexkvótát és -használatot ad vissza.

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:

• Az indexalias egy másodlagos nevet ad hozzá az indexek lekérdezési és indexelési kérelmekben való hivatkozásához. Az aliasműveletek közé tartozik a létrehozás, a frissítés, a törlés, a lekérés és a lista.

• Felügyelt identitások kimenő kapcsolatokhoz. A Létrehozás vagy az Adatforrás frissítése szolgáltatásban található kapcsolati sztringek új értékei Microsoft Entra ID hitelesítéssel és szerepkörökkel támogatják a kapcsolatokat a rögzített adatbázis-hitelesítő adatok vagy kulcsok helyett.

• A felügyelt identitás támogatása a Kulcstartó-kapcsolatok esetében is támogatott, olyan keresési megoldások esetében, amelyek kiegészítik az alapértelmezett titkosítást az ügyfél által felügyelt titkosítással.

• További nyelvek a szövegfordítás kognitív készségeihez.

• További lekérdezésAz Keresés Dokumentumok (előzetes verzió) szemantikai keresésére és helyesírására vonatkozó további információk.

• Egy feliratparaméter, a Keresés Dokumentumok (előzetes verzió) szemantikai kereséséből származó feliratok kéréséhez.

• A szemantikai konfigurációk Létrehozás vagy frissítési indexben vannak megadva. A szemantikai konfiguráció meghatározza, hogy mely mezőket kell használni a szemantikai rangsoroláshoz, a feliratokhoz, a kiemelésekhez és a válaszokhoz.

• SzemanticConfiguration paraméter, amely Keresés Dokumentumok (előzetes verzió) szemantikai lekérdezéseihez szükséges.

2020-06-30

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

• Azure-beli szerepköralapú hozzáférés-vezérlés adatsík-műveletekhez
• Relevanciapontozás (BM25)
• Tudástárak
• Indexelő adatforrás 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 Microsoft Entra ID

2020-06-30-preview

Ez az előzetes verzió tartalmazza a 2019-05-06-Preview 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
• A szöveg normalizálásának normalizáló tulajdonsága, kis- és nagybetűk megkülönböztetése, szűrése és rendezése esetén
• Az indexelőalapú indexelés dokumentumainak alaphelyzetbe állítása adott dokumentumok azonosító szerinti frissítéséhez
• Entitás ö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)

2019-05-06-Preview

• Indexelő adatforrás támogatása a Cosmos DB MongoDB API-hoz
• Indexelő adatforrás natív blob helyreállítható törléséhez a Blob Storage-ban
• featuresMode paraméter, amely részletes információkat ad vissza a relevanciapontszámról
• Az Azure Machine Learning (AML) kognitív készsége
• Személyes azonosítás észlelése kognitív képesség
• Bővített dokumentumok gyorsítótárazása a képfeldolgozás (és egyéb AI-bővítések) megőrzéséhez és újrafelhasználásához

Lásd még

• keresési szolgáltatás Létrehozás
• Rövid útmutató: Azure AI-Keresés index Létrehozás REST API-k használatával