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

Oktatóanyag: Képességkészlet javítása hibakeresési munkamenetek használatával

  • Cikk

Az Azure AI Searchben egy képességkészlet koordinálja a kereshető tartalmakat elemző, átalakító vagy létrehozó készségek műveleteit. Az egyik képesség kimenete gyakran egy másik bemenete lesz. Ha a bemenetek kimenettől függenek, a képességkészlet-definíciókban és a mezőtársításokban előforduló hibák hibás műveleteket és adatokat eredményezhetnek.

A hibakeresési munkamenetek egy Azure Portal-eszköz, amely holisztikus vizualizációt biztosít egy, az Azure AI Searchben futó képességkészletről. Ezzel az eszközzel lehatolódhat bizonyos lépésekre, hogy könnyen megállapíthassa, hol eshet le egy művelet.

Ebben a cikkben a Hibakeresési munkamenetek használatával keresse meg és javítsa ki a hiányzó bemeneteket és kimeneteket. Az oktatóanyag teljes körű. Mintaadatokat, objektumokat létrehozó REST-fájlt, valamint útmutatást nyújt a képességkészlet hibáinak elhárításához.

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

  • Azure AI Search. Hozzon létre egy szolgáltatást , vagy keressen egy meglévő szolgáltatást az aktuális előfizetése alatt. Ehhez az oktatóanyaghoz ingyenes szolgáltatást használhat. Az ingyenes szint nem nyújt felügyelt identitástámogatást az Azure AI-Search szolgáltatás. Az Azure Storage-hoz való kapcsolatokhoz kulcsokat kell használnia.

  • Azure Storage-fiók blobtárolóval, mintaadatok tárolására és a hibakeresési munkamenet során létrehozott gyorsítótárazott adatok megőrzésére szolgál. Ha ingyenes keresési szolgáltatást használ, a tárfióknak engedélyeznie kell a közös hozzáférési kulcsokat, és engedélyeznie kell a nyilvános hálózati hozzáférést.

  • Visual Studio Code REST-ügyféllel.

  • Pdf-minta (klinikai vizsgálatok).

  • Minta debug-sessions.rest fájl a bővítési folyamat létrehozásához.

Feljegyzés

Ez az oktatóanyag az Azure AI-szolgáltatásokat is használja a nyelvfelismeréshez, az entitásfelismeréshez és a kulcskifejezés-kinyeréshez. Mivel a számítási feladat olyan kicsi, az Azure AI-szolgáltatások a színfalak mögött leképezve akár 20 tranzakció ingyenes feldolgozására is használhatóak. Ez azt jelenti, hogy ezt a gyakorlatot anélkül végezheti el, hogy számlázható Azure AI-szolgáltatási erőforrást kellene létrehoznia.

A mintaadatok beállítása

Ez a szakasz létrehozza a mintaadatkészletet az Azure Blob Storage-ban, hogy az indexelő és a képességkészlet működjön együtt tartalommal.

  1. Töltse le a mintaadatokat (clinical-trials-pdf-19), amely 19 fájlból áll.

  2. Hozzon létre egy Azure Storage-fiókot , vagy keressen egy meglévő fiókot.

    • A sávszélesség-díjak elkerülése érdekében válassza ki ugyanazt a régiót, mint az Azure AI Search.

    • Válassza ki a StorageV2 (általános célú V2) fióktípust.

  3. Lépjen az Azure Storage-szolgáltatások lapjaira az Azure Portalon, és hozzon létre egy Blob-tárolót. Az ajánlott eljárás a "privát" hozzáférési szint megadása. Nevezze el a tárolót clinicaltrialdataset.

  4. A tárolóban válassza a Feltöltés lehetőséget a letöltött és az első lépésben kibontott mintafájlok feltöltéséhez.

  5. Az Azure Portalon másolja ki az Azure Storage kapcsolati sztring. A kapcsolati sztring az Azure Portal Beállítások>hozzáférési kulcsaiból szerezheti be.

Kulcs és URL másolása

Ez az oktatóanyag API-kulcsokat használ a hitelesítéshez és az engedélyezéshez. Szüksége van a keresési szolgáltatás végpontjára és egy API-kulcsra, amelyet az Azure Portalról szerezhet be.

  1. Jelentkezzen be az Azure Portalra, lépjen az Áttekintés lapra, és másolja ki az URL-címet. A végpontok például a következőképpen nézhetnek ki: https://mydemo.search.windows.net.

  2. A Beállítások>kulcsok területen másolja ki a rendszergazdai kulcsot. A rendszergazdai kulcsok objektumok hozzáadására, módosítására és törlésére szolgálnak. Két felcserélhető rendszergazdai kulcs van. Másolja valamelyiket.

    Képernyőkép az Azure Portal URL-címéről és API-kulcsáról.

Az érvényes API-kulcs kérésenként megbízhatóságot hoz létre a kérelmet küldő alkalmazás és az azt kezelő keresési szolgáltatás között.

Adatforrás, képességkészlet, index és indexelő létrehozása

Ebben a szakaszban hozzon létre egy "hibás" munkafolyamatot, amelyet ebben az oktatóanyagban kijavíthat.

  1. Indítsa el a Visual Studio Code-ot, és nyissa meg a debug-sessions.rest fájlt.

  2. Adja meg a következő változókat: keresési szolgáltatás URL-címe, keresési szolgáltatások rendszergazdai API-kulcsa, tárolási kapcsolati sztring, valamint a PDF-fájlokat tároló blobtároló neve.

  3. Küldje el egymás után az egyes kéréseket. Az indexelő létrehozása több percet vesz igénybe.

  4. Zárja be a fájlt.

Eredmények ellenőrzése az Azure Portalon

A mintakód szándékosan létrehoz egy hibás indexet a képességkészlet végrehajtása során felmerülő problémák következtében. A probléma az, hogy az indexből hiányoznak adatok.

  1. Az Azure Portal keresési szolgáltatás áttekintési lapján válassza az Indexek lapot.

  2. Válassza ki a klinikai kísérleteket.

  3. Adja meg ezt a JSON-lekérdezési sztringet a Kereséskezelő JSON-nézetében. Adott dokumentumok mezőit adja vissza (az egyedi metadata_storage_path mező azonosítja).

    "search": "*",
"select": "metadata_storage_path, organizations, locations",
"count": true

  4. Futtassa a lekérdezést. Üres értékeknek kell megjelennie a következőhöz organizations : és locations.

    Ezeket a mezőket a képességkészlet Entitásfelismerési képességével kellett kitölteni, amellyel a blob tartalmán belül bárhol észlelhet szervezeteket és helyeket. A következő gyakorlatban hibakeresést fog végezni a képességkészletben, hogy megállapítsa, mi történt.

A hibák és figyelmeztetések vizsgálatának másik módja az Azure Portal.

  1. Nyissa meg az Indexelők lapot, és válassza a clinical-trials-idxr elemet.

    Figyelje meg, hogy bár az indexelő feladat összességében sikeres volt, figyelmeztetések voltak.

  2. Válassza a Siker lehetőséget a figyelmeztetések megtekintéséhez (ha többnyire hibák jelentkeztek, a részletes hivatkozás sikertelen lesz). Az indexelő által kibocsátott figyelmeztetések hosszú listája jelenik meg.

    Képernyőkép a megtekintési figyelmeztetésekről.

Hibakeresési munkamenet indítása

  1. A keresési szolgáltatás bal oldali navigációs paneljén, a Kereséskezelés csoportban válassza a Hibakeresési munkamenetek lehetőséget.

  2. Válassza a + Hibakeresési munkamenet hozzáadása lehetőséget.

  3. Adjon nevet a munkamenetnek.

  4. Az Indexer-sablonban adja meg az indexelő nevét. Az indexelő hivatkozik az adatforrásra, a képességkészletre és az indexre.

  5. Válassza ki a tárfiókot.

  6. Mentse a munkamenetet.

    Képernyőkép a hibakeresési munkamenet definíciós oldaláról.

  7. Megnyílik egy hibakeresési munkamenet a beállítások lapjára. Módosíthatja a kezdeti konfigurációt, és felülbírálhatja az alapértelmezett beállításokat. A hibakeresési munkamenetek csak egyetlen dokumentummal működnek. Az alapértelmezett beállítás a gyűjtemény első dokumentumának elfogadása a hibakeresési munkamenetek alapjaként. Kiválaszthat egy adott dokumentumot a hibakereséshez , ha megadja az URI-t az Azure Storage-ban.

  8. Amikor a hibakeresési munkamenet befejeződött az inicializálással, látnia kell egy leképezéseket és keresési indexet tartalmazó készség-munkafolyamatot. A bővített dokumentumadat-struktúra megjelenik egy részletpanelen az oldalon. Az alábbi képernyőképen kizártuk, hogy többet láthass a munkafolyamatból.

    Képernyőkép a Hibakeresési munkamenet vizualizációszerkesztőről.

A készségkészlettel kapcsolatos problémák keresése

Az indexelő által jelentett problémák hibaüzenetként és figyelmeztetésként jelennek meg.

Figyelje meg, hogy a hibák és figyelmeztetések száma sokkal kisebb, mint a korábban megjelenített lista, mivel ez a lista csak egyetlen dokumentum hibáit részletezi. Az indexelő által megjelenített listához hasonlóan kiválaszthat egy figyelmeztető üzenetet, és megtekintheti a figyelmeztetés részleteit.

Az értesítések áttekintéséhez válassza a Figyelmeztetések lehetőséget. Négynek kell megjelennie:

  • "Nem sikerült végrehajtani a képességet, mert egy vagy több készségbemenet érvénytelen volt. Hiányzik a szükséges készségbevitel. Név: "szöveg", Forrás: '/document/content'."

  • "A kimeneti mező "helyek" nem képezhető le keresési indexre. Ellenőrizze az indexelő "outputFieldMappings" tulajdonságát. Hiányzik a "/document/merged_content/locations" érték."

  • "A "szervezetek" kimeneti mező nem képezhető le keresési indexre. Ellenőrizze az indexelő "outputFieldMappings" tulajdonságát. Hiányzik a "/document/merged_content/organizations" érték."

  • "A képesség végrehajtásra került, de lehet, hogy nem várt eredményt ad, mert egy vagy több készségbemenet érvénytelen volt. Hiányzik az opcionális készségbemenet. Név: 'languageCode', Forrás: '/document/languageCode'. Kifejezésnyelv-elemzési problémák: Hiányzik a "/document/languageCode" érték."

Sok készség rendelkezik "languageCode" paraméterrel. A művelet vizsgálatával láthatja, hogy ez a nyelvi kódbevitel hiányzik az EntityRecognitionSkill.#1entitásfelismerési képességből, amely problémákat okoz a "helyek" és a "szervezetek" kimenetével.

Mivel mind a négy értesítés erről a képességről szól, a következő lépés a képesség hibakeresése. Ha lehetséges, először a bemeneti problémák megoldásával kezdje, mielőtt továbblépne a kimeneti problémákra.

Hiányzó készségbeviteli értékek javítása

  1. A munkafelületen válassza ki azt a képességet, amely a figyelmeztetéseket jelenti. Ebben az oktatóanyagban ez az entitásfelismerési képesség.

  2. A Szakértelem részletei panel jobbra nyílik meg az iterációkhoz és azok bemeneteihez és kimeneteihez tartozó szakaszokkal, a képesség JSON-definíciójához tartozó képességbeállításokkal, valamint az e képesség által kibocsátott hibákra és figyelmeztetésekre vonatkozó üzenetekkel.

    Képernyőkép a képesség részletei panelről.

  3. Mutasson az egyes bemenetek fölé (vagy válasszon ki egy bemenetet) az értékek megjelenítéséhez a Kifejezés kiértékelőjében. Figyelje meg, hogy a bemenet megjelenített eredménye nem úgy néz ki, mint egy szövegbevitel. Szöveg helyett új vonalkarakterek \n \n\n\n\n sorozatának tűnik. A szöveg hiánya azt jelenti, hogy nem azonosíthatók entitások, ezért vagy ez a dokumentum nem felel meg a képesség előfeltételeinek, vagy egy másik bemenetet kell használni.

    A null értékeket megjelenítő készségbemenet képernyőképe.

  4. Váltson vissza a bővített adatstruktúrára, és tekintse át a dokumentum bővítési csomópontjait. Figyelje meg, hogy a \n \n\n\n\n "tartalom" nem tartalmaz forrást, de a "merged_content" másik értéke OCR-kimenettel rendelkezik. Bár nincs jelzés, ennek a PDF-fájlnak a tartalma JPEG-fájlnak tűnik, amit a kinyert és feldolgozott szöveg is bizonyít a "merged_content" fájlban.

    A bővített adatstruktúra képernyőképe.

  5. Váltson vissza a képességre, és válassza a Skillset-beállításokat a JSON-definíció megnyitásához.

  6. Módosítsa a kifejezést a másikra /document/content/document/merged_content, majd válassza a Mentés lehetőséget. Figyelje meg, hogy a figyelmeztetés már nem szerepel a listában.

    Képernyőkép a kifejezésértékelőről a rögzített merged_content bemenethez.

  7. Válassza a Futtatás lehetőséget a munkamenet ablakmenüjében. Ez elindítja a készségkészlet újabb végrehajtását a dokumentum használatával.

  8. Miután a hibakeresési munkamenet végrehajtása befejeződött, figyelje meg, hogy a figyelmeztetések száma eggyel csökkent. A figyelmeztetések azt mutatják, hogy a szövegbeviteli hiba eltűnt, de a többi figyelmeztetés továbbra is megmarad. A következő lépés a hiányzó vagy üres értékre /document/languageCodevonatkozó figyelmeztetés kezelése.

    A frissített hibák és figyelmeztetések képernyőképe.

  9. Válassza ki a képességet, és mutasson az egérmutatóra /document/languageCode. Ennek a bemenetnek az értéke null, ami nem érvényes bemenet.

  10. Az előző problémához hasonlóan először is tekintse át a bővített adatstruktúrát a csomópontok bizonyítékaiért. Figyelje meg, hogy nincs "languageCode" csomópont, de van egy a "language" kifejezéshez. Szóval, van egy elírás a képességbeállításokban.

  11. Másolja ki a kifejezést /document/language.

  12. A Szakértelem részletei panelen válassza az 1. képesség képességbeállításai lehetőséget, és illessze be az új értéket. /document/language

  13. Válassza a Mentés lehetőséget.

  14. Válassza a Futtatás lehetőséget.

  15. A hibakeresési munkamenet végrehajtása után az eredményeket a Szakértelem részletei panelen ellenőrizheti. A rámutatáskor /document/languagea Kifejezésértékelőben az értéknek kell megjelennieen.

Figyelje meg, hogy a bemeneti figyelmeztetések eltűntek. Most már csak a két figyelmeztetés marad a szervezetek és helyek kimeneti mezőivel kapcsolatban.

Hiányzó képességkimeneti értékek javítása

Az üzenetek azt mondják, hogy ellenőrizze az indexelő "outputFieldMappings" tulajdonságát, ezért kezdjük ott.

  1. Válassza ki a kimeneti mezőleképezéseket a munkafelületen. Figyelje meg, hogy a kimeneti mezőleképezések hiányoznak.

    Képernyőkép a kimeneti mező leképezéséről.

  2. Első lépésként győződjön meg arról, hogy a keresési index a várt mezőkkel rendelkezik. Ebben az esetben az index a "helyek" és a "szervezetek" mezőket tartalmaz.

  3. Ha nincs probléma az indexpel, a következő lépés a képességkimenetek ellenőrzése. A korábbiakhoz hasonlóan válassza a Bővített adatstruktúrát, és görgessen a csomópontok között a "helyek" és a "szervezetek" megkereséséhez. Figyelje meg, hogy a szülő "tartalom" a "merged_content" helyett. A környezet helytelen.

  4. Váltson vissza a Képesség részletei panelre az entitásfelismerési képességhez.

  5. A Képességbeállítások területen váltson a context következőre document/merged_content: . Ezen a ponton három módosítással kell rendelkeznie a képességdefinícióban.

    Képernyőkép a képességdefinícióról az összes módosítással együtt.

  6. Válassza a Mentés lehetőséget.

  7. Válassza a Futtatás lehetőséget.

Az összes hiba megoldódott.

A képességkészlet módosításainak véglegesítése

A hibakeresési munkamenet indításakor a keresési szolgáltatás létrehozta a készségkészlet másolatát. Ez azért történt, hogy megvédje az eredeti készségeket a keresési szolgáltatásban. Most, hogy befejezte a képességkészlet hibakeresését, a javítások véglegesíthetők (felülírhatják az eredeti készségkészletet).

Ha nem áll készen a módosítások véglegesítésére, mentheti a hibakeresési munkamenetet, és később újra megnyithatja.

  1. Válassza a Módosítások véglegesítése lehetőséget a hibakeresési munkamenetek fő menüjében.

  2. Az OK gombra kattintva ellenőrizheti, hogy frissíteni szeretné-e a készségkészletet.

  3. Zárja be a hibakeresési munkamenetet, és nyissa meg az Indexelőket a bal oldali navigációs panelen.

  4. Válassza a "clinical-trials-idxr" lehetőséget.

  5. Válassza az Alaphelyzetbe állítás lehetőséget.

  6. Válassza a Futtatás lehetőséget.

  7. Válassza a Frissítés lehetőséget az alaphelyzetbe állítási és futtatási parancsok állapotának megjelenítéséhez.

Ha az indexelő futása befejeződött, a Végrehajtás előzményei lapon a legutóbbi futtatás időbélyege mellett egy zöld pipának és a Sikeres szónak kell lennie. A módosítások alkalmazásának biztosítása:

  1. A bal oldali navigációs panelen nyissa meg az Indexeket.

  2. Válassza a "klinikai vizsgálatok" indexet, és a Kereséskezelő lapon adja meg ezt a lekérdezési sztringet: $select=metadata_storage_path, organizations, locations&$count=true adott dokumentumok mezőinek visszaadásához (amelyeket az egyedi metadata_storage_path mező azonosít).

  3. Válassza a Keresés lehetőséget.

Az eredményeknek azt kell mutatniuk, hogy a szervezetek és a helyek mostantól a várt értékekkel vannak feltöltve.

Az erőforrások eltávolítása

Ha a saját előfizetésében dolgozik, érdemes az egyes projektek végén eldöntenie, hogy szüksége lesz-e még a létrehozott erőforrásokra. A továbbra is futó erőforrások költségekkel járhatnak. Az erőforrásokat törölheti egyesével, vagy az erőforráscsoport törlésével eltávolíthatja a benne lévő összes erőforrást is.

Az erőforrásokat az Azure Portalon, a bal oldali navigációs panel Minden erőforrás vagy erőforráscsoport hivatkozásával keresheti meg és kezelheti.

Az ingyenes szolgáltatás három indexre, indexelőre és adatforrásra korlátozódik. Az Azure Portalon törölheti az egyes elemeket, hogy a korlát alatt maradjon.

Következő lépések

Ez az oktatóanyag a készségkészlet meghatározásának és feldolgozásának különböző aspektusait érintette. A fogalmakkal és munkafolyamatokkal kapcsolatos további információkért tekintse meg az alábbi cikkeket: