Ladění relací ve službě Azure AI Search
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
Pomocí ladicích relací můžete zkoumat a řešit problémy 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í image ladicí relace 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, které sledují trasu zpracování. Podokno podrobností vpravo je citlivé na kontext. Zobrazuje reprezentaci rozšířeného dokumentu nebo podrobnosti dovednosti nebo mapování.
První obrázek znázorňuje vzor použitého rozšiřování AI. Dovednosti se můžou spouštět postupně nebo paralelně, pokud neexistují žádné závislosti. Mapování výstupních polí odesílají rozšířené nebo generované obsahy z datových struktur v paměti do polí v indexu.
Druhý obrázek znázorňuje typický vzor pro integrovanou vektorizaci. Dovednosti pro integrovanou vektorizaci obvykle zahrnují rozdělení textu a dovednosti vkládání. Text Split skill chunks a document into pages. Dovednosti vkládání poskytují vektorizaci. Mapování projekce řídí, jak se bloky obsahu indexují. Tato konkrétní sada dovedností přeskočí nadřazený index a vytvoří index pouze blokovaného obsahu pomocí metadat k identifikaci zdroje bloku dat.
Omezení
Ladicí relace fungují se všemi obecně dostupnými zdroji dat indexeru a většina zdrojů dat ve verzi Preview s následujícími výjimkami:
Indexer SharePointu Online
Indexer služby Azure Cosmos DB pro MongoDB
V případě selhání řádku během indexu ve službě Azure Cosmos DB for NoSQL a neexistuje žádná odpovídající metadata, nemusí ladicí relace vybrat správný řádek.
Pokud byla dříve dělená kolekce rozdělená do oddílů, relace ladění pro rozhraní SQL API služby Azure Cosmos DB nenajde dokument.
Pro vlastní dovednosti se spravovaná identita přiřazená uživatelem nepodporuje pro připojení relace ladění ke službě Azure Storage. Jak je uvedeno v požadavcích, můžete použít spravovanou identitu systému nebo zadat úplný přístup připojovací řetězec, 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.
V současné době je možnost vybrat dokument, který se má ladit, není k dispozici. Toto omezení není trvalé a brzy bude 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í. Veškerý stav relace se uloží do nového kontejneru objektů blob vytvořeného službou Azure AI Search v účtu azure Storage, který zadáte. Název vygenerovaného kontejneru má předponu ms-az-cognitive-search-debugsession. Předpona je povinná, protože snižuje pravděpodobnost náhodného exportu dat relace do jiného kontejneru ve vašem účtu.
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. Potvrzení změn přepíše sadu produkčních dovedností.
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.
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.
Podokno podrobností o dovednostech
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. Je to čitelné znázornění toho, co obohacený dokument obsahuje. Předchozí snímky obrazovky v tomto článku ukazují příklady rozšířené datové struktury.
Další kroky
Teď, když rozumíte prvkům ladicích relací, spusťte první ladicí relaci u existující sady dovedností.