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

Azure AI Search REST API-referencia

Az Azure AI Search (korábbi nevén Azure Cognitive Search) egy teljes mértékben felügyelt felhőbeli keresési szolgáltatás, amely a felhasználó tulajdonában lévő tartalmakon keresztül nyújt információt.

Az adatsík REST API-jait indexelési és lekérdezési munkafolyamatokhoz használjuk, és ebben a szakaszban dokumentáljuk.

A szolgáltatásfelügyelet vezérlősík-műveleteit egy külön Search Management REST API fedi le.

Verziószámozott API-dokumentumok

Amikor kiválaszt egy API-referenciacikket, megjelenik egy verzióválasztó a tartalomjegyzék felett. A választó akkor válik elérhetővé, ha kiválaszt egy oldalt a Referenciaadatsík > mappából.

Képernyőkép a verzióválasztóról.

Főbb fogalmak

Az Azure AI Search a keresési szolgáltatások, indexek, dokumentumok, indexelők, adatforrások, készségkészletek és szinonimatérképek fogalmait használja.

  • A keresési szolgáltatás indexeket, indexelőket, adatforrásokat, képességkészleteket és szinonimákat tárol legfelső szintű objektumokként.
  • A keresési index állandó tárterületet biztosít a keresési dokumentumokhoz. A keresési dokumentumok a mezők gyűjteményeként tagolt, külső forrásokból betöltött és indexbe leküldött adatok, hogy kereshetőek legyenek.
  • A keresési indexelő automatizálást ad hozzá, natív formátumban olvas adatokat, és szerializálja őket JSON-ra.
  • Az indexelő adatforrással rendelkezik, és egy indexre mutat.
  • Az indexelők olyan képességkészlettel is rendelkezhetnek, amely AI-bővítést és integrált vektorizációt ad hozzá az indexelési folyamathoz. A képességkészletek mindig indexelőhöz vannak csatolva. Gépi tanulást indítanak szöveg kinyerésére vagy darabolására, tartalom vektorizálására, szolgáltatások következtetésére vagy szerkezet hozzáadására a tartalomhoz a keresési szolgáltatás által történő jobb indexelés érdekében.

Összességében a következő objektumokat hozhatja létre egy keresési szolgáltatásban:

Objektumok Leírás
Adatforrások Az indexelő által az indexeléshez használt dokumentumok lekéréséhez és frissítéséhez használt adatforrás-kapcsolat. Az adatforrások rendelkeznek .type Használhatja a Microsoft által biztosított kapcsolatokat az Azure-hoz vagy partnerösszekötőkhöz. A teljes listát az Adatforrások gyűjteményben találja.
Dokumentumok A dokumentum elméletileg egy entitás az indexben. Ezt a fogalmat jobban ismert adatbázis-megfelelőkre kell leképeznie: a keresési indexek egy táblával egyenértékűek, a dokumentumok pedig nagyjából egyenértékűek a tábla soraival. A dokumentumok csak egy indexben léteznek, és csak az index dokumentumgyűjteményét (/docs) megcélzott lekérdezésekkel kérik le. A gyűjteményen végrehajtott összes művelet, például a dokumentumok feltöltése, egyesítése, törlése vagy lekérdezése egyetlen index kontextusában történik, így az URL-formátum dokumentumműveletei mindig egy adott indexnévhez tartoznak /indexes/[index name]/docs .
Indexek Az indexek a keresési szolgáltatásban vannak tárolva, és JSON-dokumentumokkal vannak feltöltve, amelyek indexeltek és jogkivonatosak az információk lekéréséhez. Az index mezőgyűjteménye határozza meg a keresési dokumentum struktúráját. A mezők névvel, adattípusokkal és attribútumokkal rendelkeznek, amelyek meghatározzák a használatot. A mezőket például searchable teljes szöveges keresésben használják, és így tokenizálva vannak az indexelés során. Az index más szerkezeteket is meghatároz, például pontozási profilokat a relevanciahangoláshoz, javaslattevőket, szemantikai konfigurációkat és egyéni elemzőket.
Indexelők Az indexelők biztosítják az indexelés automatizálását. Az indexelő csatlakozik egy adatforráshoz, beolvassa az adatokat, és átadja azt egy keresőmotornak, hogy indexeljen egy célkeresési indexbe. Az indexelők egy külső forrásból olvasnak egy adatforrás kapcsolati adataival, és szerializálják a bejövő adatokat JSON-keresési dokumentumokba. Az adatforráson kívül az indexelőknek indexre is szükség van. Az index a keresési dokumentumok mezőit és attribútumait határozza meg.
Készségkészletek A képességkészlet külső feldolgozási lépéseket ad hozzá az indexelők végrehajtásához, és AI- vagy mélytanulási modellek alkalmazásával elemzi vagy átalakítja a tartalmakat az indexek jobb kereshetősége érdekében. A készségkészlet tartalma egy vagy több képesség, amely a Microsoft által létrehozott beépített készségek , egyéni készségek vagy mindkettő kombinációja lehet. Beépített képességek léteznek a képelemzéshez, beleértve az OCR-t és a természetes nyelvi feldolgozást. A beépített képességek további példái közé tartozik többek között az entitásfelismerés, a kulcskifejezések kinyerése, a szöveg logikai oldalakba való beírása. A képességkészletek olyan magas szintű önálló objektumok, amelyek indexekkel, indexelőkkel és adatforrásokkal egyenértékű szinten léteznek, de csak az indexelő feldolgozása során működnek. Magas szintű objektumként egyszer tervezhet meg egy készségkészletet, majd hivatkozhat rá több indexelőben.
Szinonimák térképei A szinonimák leképezése szolgáltatásszintű objektum, amely felhasználó által definiált szinonimákat tartalmaz. Ez az objektum a keresési indexektől függetlenül marad fenn. A feltöltés után bármely kereshető mezőt a szinonimatérképre irányíthat (mezőnként egyet).

Engedélyek és hozzáférés-vezérlés

Kulcsalapú hitelesítést vagy szerepköralapú hitelesítést használhat a Microsoft Entra-azonosítón keresztül.

  • A kulcsalapú hitelesítés a keresési szolgáltatáshoz létrehozott API-kulcsokra támaszkodik. Az érvényes kulcs kérésenként megbízhatóságot hoz létre a kérelmet küldő alkalmazás és az azt kezelő szolgáltatás között. Az olvasási-írási műveletekhez rendszergazdai API-kulcsot vagy lekérdezési API-kulcsot használhat a keresési index dokumentumgyűjteményéhez való olvasáshoz.

  • A Microsoft Entra ID-hitelesítéshez és a szerepköralapú hozzáférés-vezérléshez rendelkeznie kell egy, a Microsoft Entra ID-ban létrehozott bérlővel, biztonsági tagokkal és szerepkör-hozzárendelésekkel. Az alábbi szerepkörök tagjai adatsík-hozzáféréssel rendelkeznek. Egyéni szerepköröket akkor hozhat létre, ha a beépített szerepkörök nem elegendőek.

Amikor szerepköröket használ a kapcsolaton, az ügyfélalkalmazás egy tulajdonosi jogkivonatot jelenít meg az engedélyezési fejlécben. A beállítással kapcsolatos segítségért tekintse meg a keresési alkalmazáshoz való hozzáférés engedélyezése a Microsoft Entra-azonosítóval című témakört.

Letilthatja a kulcsalapú hitelesítést vagy a szerepköralapú hitelesítést. Ha letiltja a szerepköralapú hitelesítést, az csak az adatsík-műveletekre vonatkozik. A vezérlősík-műveletek, például a szolgáltatásfelügyelet, mindig szerepköralapú hitelesítést használnak. Részletekért tekintse meg a Microsoft Entra ID-hitelesítést és a szerepköralapú hozzáférés-vezérlést az Azure AI Search szolgáltatásban.

Az API-k meghívása

Az ebben a szakaszban dokumentált API-k hozzáférést biztosítanak a keresési adatokon végzett műveletekhez, például az indexek létrehozásához és populációjához, a dokumentumok feltöltéséhez és a lekérdezésekhez. API-k hívásakor tartsa szem előtt a következő szempontokat:

  • A kérelmeket HTTPS-en keresztül kell kiállítani (az alapértelmezett 443-as porton).

  • A kérelem URI-jainak tartalmazniuk kell az api-verziót. Az értéket egy támogatott verzióra kell állítani, a példában látható módon formázva: GET https://[search service name].search.windows.net/indexes?api-version=2024-07-01

  • A kérelemfejléceknek tartalmazniuk kell egy api-kulcsot vagy egy tulajdonosi jogkivonatot a hitelesített kapcsolatokhoz. Tetszés szerint beállíthatja a HTTP-fejléc elfogadása lehetőséget. Ha a tartalomtípus fejléce nincs beállítva, akkor a rendszer az alapértelmezett értéket application/jsonfeltételezi.

Lásd még:

  • Last updated on