Munkamenetek hibakeresése az Azure AI Searchben

A hibakeresési munkamenetek olyan vizuális szerkesztők, amelyek az Azure Portalon egy meglévő képességkészlettel működnek együtt, és egyetlen bővített dokumentum struktúráját és tartalmát vizsgáljuk meg, ahogyan azt egy indexelő és egy képességkészlet a munkamenet időtartamára készíti el. 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 csomagolják ki a készségkészlet különböző rétegeit, hogy megvizsgálhassa a képességkészlet struktúráját, folyamatát és a futtatáskor létrehozott 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 képességek az integrált vektorizáláshoz, az adatok szövegfelosztáson keresztüli adatbeosztásával, valamint vektorizálással egy beágyazási képességen 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 a folyamat által létrehozott bővített dokumentumot, 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 alakítja át 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 Online-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.

• Jelenleg nem lehet kiválasztani, hogy melyik dokumentumot szeretné hibakeresésre. Ez a korlátozás nem állandó, és hamarosan megszűnik. 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 rendszer minden munkamenet-állapotot egy új blobtárolóba ment, amelyet az Azure AI Search szolgáltatás hozott létre egy Ön által megadott Azure Storage-fiókban. A létrehozott tároló neve a következő előtaggal rendelkezik ms-az-cognitive-search-debugsession: . Az előtagra azért van szükség, mert 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.

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 csak akkor érintik a közzétett készségeket, ha véglegesíti őket. A módosítások véglegesítése felülírja az éles képessé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.

Munkamenet-elrendezés hibakeresése

A vizualizációszerkesztő egy olyan felületre van rendezve, amely a műveletek előrehaladását mutatja, kezdve a dokumentumok repedésével, majd a készségekkel, a leképezésekkel és az indexekkel.

Jelöljön ki bármilyen jártasságot vagy leképezést, és megnyílik egy 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 emberi olvasható ábrázolása, 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.