Ladění relací ve službě Azure AI Vyhledávač

Ladicí relace je vizuální editor, který pracuje s existující sadou dovedností na webu Azure Portal a zobrazuje strukturu a obsah jednoho rozšířeného dokumentu, protože je vytvořen indexerem a sadou dovedností po dobu trvání relace. Protože pracujete s živým dokumentem, relace je interaktivní – můžete identifikovat chyby, upravit a vyvolat provádění dovedností a ověřit výsledky v reálném čase. Pokud vaše změny problém vyřeší, můžete je potvrdit do publikované sady dovedností a použít opravy globálně.

Tento článek vysvětluje podporované scénáře a způsob uspořádání editoru. Karty a oddíly editoru rozbalí různé vrstvy sady dovedností, abyste mohli prozkoumat strukturu sady dovedností, tok a obsah, který generuje za běhu.

Podporované scénáře

Použijte ladicí relace k prozkoumání a vyřešení problémů s:

• Předdefinované dovednosti používané pro rozšiřování AI, jako je OCR, analýza obrázků, rozpoznávání entit a extrakce klíčových slov.

• Předdefinované dovednosti používané pro integrovanou vektorizaci s bloky dat prostřednictvím rozdělení textu a vektorizace prostřednictvím dovednosti vkládání.

• Vlastní dovednosti používané k integraci externího zpracování, které poskytujete.

Porovnejte následující obrázky z ladicích relací pro první dva scénáře. V obou scénářích ukazuje oblast povrchu průběh dovedností, které generují nebo transformují obsah na cestě ze zdrojového dokumentu do indexu vyhledávání. Tok obsahuje možnosti mapování indexů a můžete sledovat šipky, abyste následovali trasu zpracování. Podokno podrobností vpravo je citlivé na kontext. Zobrazuje reprezentaci rozšířeného dokumentu vytvořeného kanálem nebo podrobností dovednosti nebo mapování.

První obrázek ukazuje vzor použitého rozšiřování AI (bez vektorů). Dovednosti se můžou spouštět postupně nebo paralelně, pokud neexistují žádné závislosti. Mapování indexů ukazují, jak obohacený nebo vygenerovaný obsah putuje z datových struktur v paměti do polí v indexu. Obohacený dokument ukazuje datovou strukturu, kterou sada dovedností vytvoří.

Druhý obrázek znázorňuje typický vzor pro integrovanou vektorizaci. Dovednosti integrované vektorizace obvykle zahrnují dovednost Rozdělení textu a dovednosti vkládání. Dovednost Rozdělení textu rozdělí dokument na úseky. Dovednost vkládání volá vložené rozhraní API pro vektorizaci těchto bloků dat. Tato konkrétní sada dovedností obsahuje obsah do pole "stránek". U integrované vektorizace řídí mapování projekce způsob mapování bloků dat na pole v indexu.

Omezení

Ladicí relace fungují se všemi obecně dostupnými zdroji dat indexéru a s většinou zdrojů dat ve verzi Preview s následujícími výjimkami:

• Indexer SharePointu.

• Indexer služby Azure Cosmos DB pro MongoDB

• V případě, že řádek selže při indexování v databázi Azure Cosmos DB for NoSQL a neexistují odpovídající metainformace, nemusí ladicí relace vybrat správný řádek.

• Pokud byla kolekce SQL API služby Azure Cosmos DB dříve bez oddílů a nyní je rozdělena do oddílů, relace ladění dokument nenajde.

• Pro vlastní dovednosti se spravovaná identita přiřazená uživatelem nepodporuje pro připojení ladicí relace ke službě Azure Storage. Jak je uvedeno v požadavcích, můžete použít spravovanou identitu systému nebo zadat řetězec pro plný přístup, který obsahuje klíč. Další informace najdete v tématu Připojení vyhledávací služby k jiným prostředkům Azure pomocí spravované identity.

• Zdroje dat s povoleným šifrováním prostřednictvím klíčů spravovaných zákazníkem (CMK)

• Sdílené privátní odkazy nejsou podporovány. Pokud vaše vyhledávací služba využívá připojení přes privátní koncový bod pro přístup ke zdrojům dat nebo jiným prostředkům, ladicí relace nemohou k těmto prostředkům přistupovat. Alternativní řešení najdete v tématu Ladicí relace a privátní připojení.

• V současné době je možnost vybrat dokument, který se má ladit, není k dispozici. Toto omezení není trvalé a mělo by být brzy zrušeno. V tuto chvíli ladicí relace vybere první dokument ve zdrojovém kontejneru dat nebo složce.

Jak funguje ladicí relace

Při spuštění relace vytvoří vyhledávací služba kopii sady dovedností, indexeru a zdroje dat obsahujícího jeden dokument použitý k otestování sady dovedností. Služba Azure AI Vyhledávač ukládá veškerý stav relace do nového kontejneru blobů, který vytvoří v účtu Azure Storage, který zadáte. Vygenerovaný název kontejneru má předponu ms-az-cognitive-search-debugsession. Tato předpona snižuje riziko nechtěného exportu dat relace do jiného kontejneru ve vašem účtu.

Pokud nakonfigurujete připojení účtu úložiště pomocí spravované identity, přiřaďte Storage Blob Data Contributor tuto roli identitě vyhledávací služby v účtu úložiště. V účtu úložiště povolte důvěryhodným službám povolit přístup k zápisu z Azure AI Vyhledávač.

Do editoru vizuálů se načte kopie rozšířeného dokumentu a sady dovedností v mezipaměti, takže můžete zkontrolovat obsah a metadata rozšířeného dokumentu a zkontrolovat každý uzel dokumentu a upravit jakýkoli aspekt definice sady dovedností. Všechny změny provedené v rámci relace se ukládají do mezipaměti. Tyto změny nebudou mít vliv na publikovanou sadu dovedností, pokud je nezapíšete. Zavedení změn přepíše produkční konfiguraci.

Pokud kanál rozšiřování neobsahuje žádné chyby, můžete pomocí ladicí relace přírůstkově rozšířit dokument, otestovat a ověřit každou změnu před potvrzením změn.

Ladicí relace pomáhají identifikovat původní příčinu chyb nebo upozornění analýzou dat, vstupů dovedností a výstupů a mapování polí. V podokně podrobností dovedností můžete zkontrolovat, co každá dovednost přijímá jako vstup a vytváří se jako výstup. Tato kontrola pomáhá ověřit, že definice dovedností, výrazy a mapování polí jsou správně vytvořeny. Pokud indexer narazí na problémy s konfigurací, jako jsou nesprávné nastavení sítě nebo chyby přístupu související s oprávněními, zkontrolujte konkrétní chybovou zprávu a propojenou dokumentaci. Pokyny k řešení potíží najdete v tématu Běžné chyby a upozornění indexeru.

Ladění relací a privátního připojení

Ladicí relace nepodporují sdílené privátní odkazy. Pokud vaše produkční vyhledávací služba používá připojení privátního koncového bodu pro přístup ke zdrojům dat nebo jiným prostředkům, relace ladění se na této službě nedají spustit.

Alternativní řešení: Použití testovací vyhledávací služby

Pokud chcete ladit sadu dovedností, vytvořte samostatnou službu Azure AI Vyhledávač bez omezení privátního připojení. Pokud chcete zachovat podrobnosti o produkčních datech a schématu mimo soukromé prostředí, sestavte testovací nastavení pomocí syntetických dokumentů:

• Vytvořte testovací dokumenty, které odpovídají typům polí a struktuře produkčních dat, ale místo skutečných dat použijte obecné názvy polí (například content, title, category) a zástupné hodnoty. Logika sady dovedností závisí na typech obsahu a struktuře, nikoli na konkrétních názvech polí.
• Zkopírujte JSON sady dovedností z produkční služby. Pokud vstupy dovedností odkazují na názvy produkčních polí, aktualizujte tyto odkazy tak, aby odpovídaly názvům obecných testovacích polí. Pomocí mapování polí v indexeru testů zarovnejte názvy testovacích polí se vstupy sady dovedností.
• Nakonfigurujte indexer, který se má spustit proti testovacímu zdroji dat.

Spuštěním ladicí relace v testovací službě zkontrolujte vstupy a výstupy dovedností, ověřte výrazy dovedností a mapování polí a identifikujte chyby. Po ověření změn obnovte v JSON sady dovedností původní odkazy na názvy polí v produkčním prostředí a znovu ho nasaďte do produkční služby.

Ladění rozložení relace

Editor vizuálů je uspořádaný do oblasti povrchu, který znázorňuje průběh operací, počínaje prasknutím dokumentu, následovanými dovednostmi, mapováními a indexem.

Vyberte libovolnou dovednost nebo mapování a otevře se podokno se zobrazenými relevantními informacemi.

Pokud chcete přejít k podrobnostem o zpracování dovedností, postupujte podle odkazů. Například následující snímek obrazovky ukazuje výstup první iterace dovednosti Rozdělení textu.

Okno detailů dovedností

Podokno podrobností o dovednostech obsahuje následující části:

• Iterace: Ukazuje, kolikrát se dovednost provádí. Můžete zkontrolovat vstupy a výstupy každého z nich.
• Nastavení dovedností: Zobrazení nebo úprava definice sady dovedností JSON
• Chyby a upozornění: Zobrazuje chyby nebo upozornění specifická pro tuto dovednost.

Podokno Rozšířené datové struktury

Podokno Rozšířená datová struktura se posune na stranu, když vyberete modrý symbol šipky nebo ho skryjete. Představuje lidsky čitelné znázornění obsahu obohaceného dokumentu. Předchozí snímky obrazovky v tomto článku ukazují příklady rozšířené datové struktury.

Další kroky

Nyní, když rozumíte prvkům ladicích relací, spusťte první ladicí relaci u existující dovednostní sady.