Munkamenetek hibakeresése az Azure AI Keresésben

A hibakereső munkamenet egy vizuális szerkesztő, amely az Azure portalon egy meglévő képességkészlettel működik együtt, és feltárja egyetlen bővített dokumentum struktúráját és tartalmát, ahogyan azt egy indexelő és egy képességkészlet a munkamenet alatt elkészíti. Mivel élő dokumentumokkal dolgozik, a munkamenet interaktív – azonosíthatja a hibákat, módosíthatja és meghívhatja a képesség végrehajtását, és valós időben ellenőrizheti az eredményeket. Ha a módosítások megoldják a problémát, véglegesítheti őket egy közzétett készségkészletben a javítások globális alkalmazásához.

Ez a cikk a támogatott forgatókönyveket és a szerkesztő rendszerezését ismerteti. A szerkesztő lapjai és szakaszai kibontják a készségkészlet különböző rétegeit, így megvizsgálhatja a készségkészlet struktúráját, folyamatát és a futásidőben generált tartalmat.

Támogatott esetek

Hibakeresési munkamenetek használata a következőkkel kapcsolatos problémák kivizsgálásához és megoldásához:

• Az AI-bővítéshez használt beépített készségek, például az OCR, a képelemzés, az entitásfelismerés és a kulcsszókinyerés.

• Beépített funkciók az integrált vektorizáláshoz, az adatok szövegfelosztással történő adatdarabolásával és vektorizálással egy beágyazási funkción keresztül.

• Az Ön által biztosított külső feldolgozás integrálásához használt egyéni készségek.

Hasonlítsa össze a következő hibakeresési munkamenet-rendszerképeket az első két forgatókönyv esetében. Mindkét forgatókönyv esetében a felület azon képességek előrehaladását mutatja, amelyek a forrásdokumentumból a keresési indexbe irányítva hoznak létre vagy alakítanak át tartalmat. A folyamat indexleképezési beállításokat tartalmaz, és a nyilakat követve követheti a feldolgozási folyamatot. A jobb oldali részletek panel környezetfüggő. Megjeleníti az adatfolyam által létrehozott gazdagított dokumentum ábrázolását, illetve egy képesség vagy leképezés részleteit.

Az első képen az alkalmazott AI-bővítés mintája látható (vektorok nélkül). A készségek egymás után vagy párhuzamosan is futtathatók, ha nincsenek függőségek. Az indexleképezések azt mutatják be, hogy a bővített vagy létrehozott tartalom hogyan halad át a memóriabeli adatstruktúráktól az index mezőiig. A bővített dokumentum a képességkészlet által létrehozott adatstruktúrát mutatja be.

A második képen egy tipikus minta látható az integrált vektorizáláshoz. Az integrált vektorizálási képességek általában tartalmaznak szövegfelosztási és beágyazási képességeket. A Szöveg felosztása képesség darabokra osztja a dokumentumokat. A beágyazási képesség beágyazási API-t hív meg ezeknek az adattömböknek a vektorizálásához. Ez az adott képességkészlet "lapok" tömbjeként osztja fel a tartalmat. Az integrált vektorizáláshoz a leképezések szabályozzák, hogy az adattömbök hogyan legyenek leképezve az index mezőire.

Korlátozások

A hibakeresési munkamenetek az összes általánosan elérhető indexelő adatforrással és a legtöbb előzetes verziójú adatforrással működnek, az alábbi kivételekkel:

• SharePoint-indexelő.

• Azure Cosmos DB for MongoDB indexelő.

• Az Azure Cosmos DB for NoSQL esetében, ha egy sor meghiúsul az index során, és nincsenek megfelelő metaadatok, előfordulhat, hogy a hibakeresési munkamenet nem a megfelelő sort választja.

• Az Azure Cosmos DB SQL API-ja esetében, ha egy particionált gyűjteményt korábban nem particionáltak, a hibakeresési munkamenet nem fogja megtalálni a dokumentumot.

• Egyéni képességek esetén a felhasználó által hozzárendelt felügyelt identitások nem támogatottak az Azure Storage-hoz való hibakeresési munkamenet-kapcsolat esetében. Az előfeltételekben leírtaknak megfelelően használhatja a rendszer által felügyelt identitást, vagy megadhat egy kulcsokat tartalmazó teljes hozzáférésű kapcsolati sztring. További információ: Keresési szolgáltatás csatlakoztatása más Azure-erőforrásokhoz felügyelt identitás használatával.

• Az ügyfél által felügyelt kulcsokkal (CMK) engedélyezett titkosítással rendelkező adatforrások.

• A megosztott privát hivatkozások nem támogatottak. Ha a keresési szolgáltatás privát végpontkapcsolatot használ az adatforrások vagy más erőforrások eléréséhez, a hibakeresési munkamenetek nem férhetnek hozzá ezekhez az erőforrásokhoz. Kerülő megoldásért tekintse meg a hibakeresési munkameneteket és a privát kapcsolatokat.

• Jelenleg nem lehet kiválasztani, hogy melyik dokumentumot szeretné hibakeresésre. Ez a korlátozás nem állandó, ezért hamarosan fel kell oldani. A Hibakeresési munkamenetek ekkor kiválasztja a forrásadattároló vagy -mappa első dokumentumát.

Hibakeresési munkamenet működése

Amikor elindít egy munkamenetet, a keresési szolgáltatás létrehoz egy másolatot a képességkészletről, az indexelőről és egy adatforrásról, amely egyetlen dokumentumot tartalmaz a képességkészlet teszteléséhez. A Azure AI Keresés szolgáltatás minden munkamenet-állapotot egy új blobtárolóba ment, amelyet egy ön által megadott Azure Storage-fiókban hoz létre. A létrehozott tárolónév a következő előtaggal rendelkezik ms-az-cognitive-search-debugsession: . Ez az előtag csökkenti annak az esélyét, hogy véletlenül exportálja a munkamenet-adatokat egy másik tárolóba a fiókjában.

Ha felügyelt identitással konfigurálja a tárfiók-kapcsolatot, rendelje hozzá a szerepkört a Storage Blob Data Contributor keresési szolgáltatás identitásához a tárfiókon. A tárfiókban engedélyezze a megbízható szolgáltatásokat a Azure AI Keresés írási hozzáférésének engedélyezéséhez.

A bővített dokumentum és képességkészlet gyorsítótárazott másolata betöltődik a vizualizációszerkesztőbe, így megvizsgálhatja a bővített dokumentum tartalmát és metaadatait, és ellenőrizheti az egyes dokumentumcsomópontokat, és szerkesztheti a képességkészlet definíciójának bármely aspektusát. A munkameneten belül végrehajtott módosítások gyorsítótárazva lesznek. Ezek a módosítások nem érintik a közzétett készségeket, hacsak nem hajtja végre őket. A módosítások véglegesítése felülírja a termelésbeli készségkészletet.

Ha a bővítési folyamat nem rendelkezik hibával, a hibakeresési munkamenet segítségével növekményesen bővítheti a dokumentumokat, tesztelheti és ellenőrizheti az egyes módosításokat a módosítások véglegesítése előtt.

A hibakeresési munkamenetek az adatok, a készségbemenetek és a kimenetek, valamint a mezőleképezések elemzésével segítenek azonosítani a hibák vagy figyelmeztetések kiváltó okát. A képesség részletei panelen megvizsgálhatja, hogy az egyes képességek mit kapnak bemenetként, és mit eredményeznek kimenetként. Ez az ellenőrzés segít ellenőrizni, hogy a képességdefiníciók, kifejezések és mezőleképezések megfelelően vannak-e formázva. Ha az indexelő konfigurációs problémákat tapasztal, például helytelen hálózatbeállítást vagy engedélyekkel kapcsolatos hozzáférési hibákat, tekintse át az adott hibaüzenetet és a csatolt dokumentációt. Hibaelhárítási útmutatásért tekintse meg az indexelők gyakori hibáit és figyelmeztetéseit.

Hibakeresési munkamenetek és privát kapcsolat

A hibakeresési munkamenetek nem támogatják a megosztott privát hivatkozásokat. Ha az éles keresési szolgáltatás privát végpontkapcsolatot használ az adatforrásokhoz vagy más erőforrásokhoz való hozzáféréshez, a hibakeresési munkamenetek nem futtathatók a szolgáltatáson.

Megkerülő megoldás: tesztkeresési szolgáltatás használata

A képességkészlet hibakereséséhez hozzon létre egy külön Azure AI Keresés szolgáltatást privát kapcsolati korlátozások nélkül. Annak érdekében, hogy az éles adatok és a séma részletei ne kerüljenek nem privát környezetbe, szintetikus dokumentumokkal alakítsa ki a tesztkörnyezetet:

• Hozzon létre olyan tesztdokumentumokat, amelyek megfelelnek az éles környezetben használt adatok mezőtípusainak és szerkezetének, de valós adatok helyett általános mezőneveket (például content, title, category) és helyőrző értékeket használnak. A készségkészlet logikája a tartalomtípusoktól és a szerkezettől függ, nem pedig a konkrét mezőnevektől.
• Másolja ki a készségkészlet JSON-ját az éles szolgáltatásból. Ha a készségek bemenetei az éles környezetben használt mezőnevekre hivatkoznak, frissítse ezeket a hivatkozásokat úgy, hogy megfeleljenek az általános tesztmezőneveknek. A tesztindexelő mezőleképezéseivel igazíthatja a tesztmezőneveket a képességkészlet bemeneteihez.
• Indexelő konfigurálása a tesztadatforráson való futtatáshoz.

Futtassa a hibakeresési munkamenetet a tesztszolgáltatásban a képességbemenetek és -kimenetek vizsgálatához, a képességkifejezések és a mezőleképezések ellenőrzéséhez, valamint a hibák azonosításához. Miután érvényesítette a módosításokat, állítsa vissza az eredeti, éles környezetben használt mezőnév-hivatkozásokat a képességkészlet JSON-fájljában, majd alkalmazza újra azt az éles szolgáltatásban.

Munkamenet-elrendezés hibakeresése

A vizuális szerkesztő egy olyan felületre van rendezve, amely a műveletek előrehaladását mutatja, kezdve a dokumentumok feltörésével, majd a képességekkel, a leképezésekkel és az indexekkel.

Jelöljön ki bármilyen készséget vagy leképezést, és megnyílik egy oldalsó ablaktábla, amelyen a releváns információk láthatók.

Kövesse az alábbi hivatkozásokat a készségek feldolgozásának további részletezéséhez. Az alábbi képernyőképen például a Szöveg felosztása képesség első iterációjának kimenete látható.

Képesség részletei panel

A Szakértelem részletei panel a következő szakaszokból áll:

• Iterációk: Megmutatja, hogy egy képesség hányszor hajt végre. Mindegyik bemenetét és kimenetét ellenőrizheti.
• Képességbeállítások: A JSON-képességkészlet definíciójának megtekintése vagy szerkesztése.
• Hibák és figyelmeztetések: Az adott képességhez tartozó hibákat vagy figyelmeztetéseket jeleníti meg.

Bővített adatszerkezet panel

A Bővített adatszerkezet panel a kék megjelenítés vagy a nyíl szimbólum elrejtésekor kicsúszik az oldalára. Ez egy ember által olvasható változata annak, amit a bővített dokumentum tartalmaz. A cikk korábbi képernyőképei példákat mutatnak a bővített adatstruktúrára.

Következő lépések

Most, hogy megismerte a hibakeresési munkamenetek elemeit, indítsa el az első hibakeresési munkamenetet egy meglévő készségkészleten.