Začínáme: Document Intelligence Studio
Tento obsah se vztahuje na: v4.0 (Preview) | Předchozí verze: v3.1 (GA) v3.0 (GA)
Document Intelligence Studio je online nástroj pro vizuální zkoumání, porozumění a integraci funkcí ze služby Document Intelligence ve vašich aplikacích. Můžete začít prozkoumáním předem natrénovaných modelů s ukázkovými nebo vlastními dokumenty. Můžete také vytvářet projekty pro vytváření vlastních modelů šablon a odkazovat na modely ve vašich aplikacích pomocí sady Python SDK a dalších rychlých startů.
Požadavky pro nové uživatele
Pokud chcete používat Document Intelligence Studio, potřebujete následující prostředky a nastavení:
Aktivní účet Azure Pokud žádné nemáte, můžete si vytvořit bezplatný účet.
Funkce Document Intelligence nebo prostředek s více službami .
Tip
Pokud plánujete přístup k více službám Azure AI v rámci jednoho koncového bodu nebo klíče, vytvořte prostředek služeb Azure AI. Pouze pro přístup k funkci Document Intelligence vytvořte prostředek Document Intelligence. Upozorňujeme, že pokud máte v úmyslu používat ověřování Microsoft Entra, budete potřebovat prostředek s jednou službou.
Funkce Document Intelligence teď při přístupu k prostředkům Document Intelligence a účtům úložiště podporuje ověřování pomocí tokenu AAD navíc k místnímu ověřování (založenému na klíčích). Při nastavování správných přístupových rolí nezapomeňte postupovat podle následujících pokynů, zejména pokud se vaše prostředky použijí se DisableLocalAuth
zásadami.
Přiřazení rolí Azure s odpovídajícím oborem pro analýzu dokumentů a předem připravené modely vyžadují následující přiřazení rolí pro různé scénáře.
Základní ✔️ uživatel služeb Cognitive Services: K zadání stránky analýzy potřebujete tuto roli k prostředku služby Document Intelligence nebo služeb Azure AI.
Pokročilý ✔️ přispěvatel: Tuto roli potřebujete k vytvoření skupiny prostředků, služby Document Intelligence nebo prostředku služeb Azure AI.
Další informace o autorizaci najdete v tématu Zásady autorizace nástroje Document Intelligence Studio.
Poznámka:
Pokud je pro váš prostředek služby Document Intelligence zakázané místní ověřování (založené na klíčích), nezapomeňte získat roli uživatele služeb Cognitive Services a token AAD se použije k ověřování požadavků v nástroji Document Intelligence Studio. Role Přispěvatel umožňuje pouze vypsat klíče, ale neuděluje vám oprávnění k používání prostředku, pokud je přístup ke klíči zakázaný.
Jakmile je váš prostředek nakonfigurovaný, můžete vyzkoušet různé modely nabízené nástrojem Document Intelligence Studio. Na úvodní stránce vyberte libovolný model Document Intelligence a zkuste ho použít bez kódu.
Pokud chcete otestovat některou z analýz dokumentů nebo předem vytvořených modelů, vyberte model a použijte jeden z ukázkových dokumentů nebo nahrajte vlastní dokument k analýze. Výsledek analýzy se zobrazí vpravo v okně s kódem content-result.
Vlastní modely je potřeba vytrénovat na dokumentech. Přehled vlastních modelů najdete v přehledu vlastních modelů.
Ověřování
Přejděte do sady Document Intelligence Studio. Pokud se přihlašujete poprvé, zobrazí se automaticky otevírané okno s výzvou ke konfiguraci prostředku služby. V souladu se zásadami vaší organizace máte jednu nebo dvě možnosti:
Ověřování Microsoft Entra: přístup podle prostředku (doporučeno).
Zvolte své stávající předplatné.
Vyberte existující skupinu prostředků v rámci předplatného nebo vytvořte novou.
Vyberte existující prostředek Document Intelligence nebo služby Azure AI.
Místní ověřování: přístup podle koncového bodu rozhraní API a klíče.
Načtěte svůj koncový bod a klíč z webu Azure Portal.
Přejděte na stránku přehledu vašeho prostředku a v levém navigačním panelu vyberte Klíče a koncový bod .
Zadejte hodnoty do příslušných polí.
Po ověření scénáře v sadě Document Intelligence Studio použijte klientské knihovny jazyka C#, Java, JavaScript nebo Python nebo rozhraní REST API, abyste mohli začít začlenit modely Document Intelligence do vlastních aplikací.
Další informace o jednotlivých modelech najdete na našich stránkách konceptů.
Zobrazení podrobností o prostředku
Pokud chcete zobrazit podrobnosti o prostředcích, jako je název a cenová úroveň, vyberte ikonu Nastavení v pravém horním rohu domovské stránky Aplikace Document Intelligence Studio a vyberte kartu Prostředek . Pokud máte přístup k jiným prostředkům, můžete také přepnout prostředky.
Přidání požadavků pro vlastní projekty
Kromě účtu Azure a prostředku služby Document Intelligence nebo azure AI potřebujete:
Kontejner Azure Blob Storage
Účet služby Azure Blob Storage úrovně Standard. Kontejnery vytvoříte pro ukládání a uspořádání trénovacích dokumentů v rámci účtu úložiště. Pokud nevíte, jak vytvořit účet úložiště Azure s kontejnerem, postupujte podle těchto rychlých startů:
- Vytvoření účtu úložiště Při vytváření účtu úložiště nezapomeňte v poli Podrobnosti instance → Výkon vybrat výkon úrovně Standard.
- Vytvořte kontejner. Při vytváření kontejneru nastavte pole Úrovně veřejného přístupu na Kontejner (anonymní přístup pro čtení kontejnerů a objektů blob) v okně Nový kontejner .
Přiřazení rolí Azure
Pro vlastní projekty jsou pro různé scénáře vyžadována následující přiřazení rolí.
Basic
- Uživatel služeb Cognitive Services: Tuto roli potřebujete pro prostředek Document Intelligence nebo služby Azure AI k trénování vlastního modelu nebo analýze pomocí natrénovaných modelů.
- Přispěvatel dat objektů blob úložiště: Pro účet úložiště potřebujete tuto roli k vytvoření projektu a označení dat.
Rozšířený
- Přispěvatel účtu úložiště: Tuto roli potřebujete pro účet úložiště k nastavení CORS (tato akce je jednorázová, pokud se stejný účet úložiště znovu použije).
- Přispěvatel: Tuto roli potřebujete k vytvoření skupiny prostředků a prostředků.
Poznámka:
Pokud je pro váš prostředek služby Document Intelligence a účet úložiště zakázané místní ověřování (založené na klíčích), ujistěte se, že získáte role Přispěvatel dat objektů blob služby Cognitive Services a Uživatelů služby Storage, abyste měli dostatečná oprávnění k používání nástroje Document Intelligence Studio. Role Přispěvatel a Přispěvatel účtu úložiště umožňují vypsat jenom klíče, ale neuděluje vám oprávnění používat prostředky, pokud je přístup k klíčům zakázaný.
Konfigurace CORS
CORS (sdílení prostředků mezi zdroji) musí být nakonfigurované ve vašem účtu úložiště Azure, aby byl přístupný z Document Intelligence Studia. Ke konfiguraci CORS na webu Azure Portal potřebujete přístup na kartu CORS vašeho účtu úložiště.
Vyberte kartu CORS pro účet úložiště.
Začněte vytvořením nové položky CORS ve službě Blob Service.
Nastavte povolený původ na
https://documentintelligence.ai.azure.com
hodnotu .Tip
Zástupný znak *můžete použít místo zadané domény, abyste umožnili všem počátečním doménám provádět žádosti prostřednictvím CORS.
Vyberte všechny dostupné 8 možností pro povolené metody.
Potvrďte všechna povolená záhlaví a vystavená záhlaví zadáním * do každého pole.
Nastavte maximální věk na 120 sekund nebo libovolnou přijatelnou hodnotu.
Pokud chcete změny uložit, vyberte tlačítko Uložit v horní části stránky.
CORS by teď mělo být nakonfigurované tak, aby používalo účet úložiště ze sady Document Intelligence Studio.
Sada ukázkových dokumentů
Přihlaste se k webu Azure Portal a přejděte na Kontejnery úložiště>dat účtu>úložiště.
Ze seznamu vyberte kontejner.
V nabídce v horní části stránky vyberte Nahrát .
Zobrazí se okno Nahrát objekt blob .
Vyberte soubory, které chcete nahrát.
Poznámka:
Ve výchozím nastavení bude Studio používat dokumenty, které jsou umístěné v kořenovém adresáři kontejneru. Data uspořádaná do složek však můžete použít zadáním cesty ke složce v krocích vytvoření projektu vlastního formuláře. Viz Uspořádání dat v podsložkách.
Další kroky
- Postupujte podle našeho průvodce migrací Document Intelligence v3.1 a seznamte se s rozdíly oproti předchozí verzi rozhraní REST API.
- Prozkoumejte naše rychlé starty sady SDK v4.0 a vyzkoušejte funkce v3.0 ve vašich aplikacích pomocí nových klientských knihoven.
- V našich rychlých startech k rozhraní REST API v4.0 si můžete vyzkoušet funkce v3.0 pomocí nového rozhraní REST API.