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.
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 |
|---|---|---|
2024-05-01-preview (legújabb) |
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
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, így skaláris kvantálást, szűk adattípusokat és tárolási lehetőségeket is bevezet az adott verzióban.
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 szeretné használni, a 2023.10.01. után létrehozott indexet kell használnia.
Indexlétrehozása vagy frissítése:
vectorSearchalgorithms,profilesésvectorizersdefiníciókkal rendelkezik:algorithmstovábbra is támogatja ahnsw, és mostantól aeknnis 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-previewvectorSearchtulajdonságon belülialgorithmConfigurationshelyettesíti.profilesegy ú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.vectorizersegy 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. AvectorSearchProfiletulajdonsá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
vectorSearchProfilemegadásához, feltéve, hogy a profil pontosan ugyanazt az algoritmust adja meg, amelyet korábban avectorSearchConfiguration. 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.
-
vectorQueries2023-07-01-previewvectorscseréli le -
vectorQueries.vectors2023-07-01-previewvectors.valueshelyettesíti. - A vektoros lekérdezés ma már polimorfikus struktúra.
kindmeg 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. - A
vectorFilterModeegy új paraméter az előszűrés megadásához (a 2023-10-01 után létrehozott indexek alapértelmezett értéke) vagy a lekérdezés utáni szűrés (az előző indexek alapértelmezett értéke) megadásához.
É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.
- Hozzáadtunk egy
Collection(Edm.Single)adattípust olyan mezőkhöz, amelyek egy pontosságú lebegőpontos számokat tartalmazó tömböt tartalmaznak. Ez a vektorok adattípusa, amely dokumentummezőnként egy generált beágyazás tárolására szolgál. A keresési index a vektorkonfiguráció tulajdonságait is meghatározza. Lásd Index létrehozása vagy frissítése ezen API-khoz. - Frissítettük az indexelési számítási feladatokat a vektoradatok elfogadásához. Lásd: Dokumentumok hozzáadása, frissítése vagy törlése.
- Lekérdezési paraméterek hozzáadva a vektorkereséshez. Ezekről a paraméterekről a Keresési dokumentumok című témakörben olvashat.
- Szolgáltatásstatisztikák lekérése: a vektorindex kvótát és a szolgáltatás használatát adja vissza.
- Indexstatisztika lekérése: a keresési index vektorindex-kvótát és használatát adja vissza.
- É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.
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:
- index aliasa egy másodlagos nevet ad hozzá, amely a lekérdezési és indexelési kérelmek indexeinek hivatkozására szolgál. 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.
- kimenő kapcsolatok felügyelt identitásai. Az adatforrás létrehozása vagy frissítése kapcsolati sztringjeinek új értékei a Microsoft Entra ID-hitelesítést és szerepköröket használó kapcsolatokat támogatják a nem rögzített adatbázis-hitelesítő adatok vagy kulcsok helyett.
- A felügyelt identitás támogatása a Key Vault-kapcsolatok esetében is támogatott, olyan keresési megoldások esetében, amelyek kiegészítik az alapértelmezett titkosítást ügyfél által felügyelt titkosítási.
- További nyelvek a szövegfordítás kognitív készségeihez.
- További queryLanguages szemantikai kereséshez és helyesírás-ellenőrzőhöz Keresési dokumentumok (előzetes verzió).
- Feliratparaméter, a Keresési dokumentumok (előzetes verzió)szemantikai keresésből származó feliratok kéréséhez.
- szemantikai konfigurációkatIndex létrehozása vagy frissítése. 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ési dokumentumok (előzetes verzió)szemantikai lekérdezéseihez szükséges.
- É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
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
- Entity Linking cognitive skill (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-előzetes verzió
- 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.