Prostředí sady Studio pro funkci Document Intelligence

Tento obsah se vztahuje na: v4.0 (GA) | Předchozí verze: v3.1 (GA) v3.0 (GA)

Studio je online nástroj, který vizuálně prozkoumává, rozumí, trénuje a integruje funkce ze služby Document Intelligence do vašich aplikací. Studio poskytuje platformu pro experimentování s různými modely Document Intelligence a interaktivním způsobem vrácená data, aniž byste museli psát kód. Studiové prostředí můžete využít k:

• Přečtěte si další informace o různých možnostech funkce Document Intelligence.
• Použijte prostředek Document Intelligence k testování modelů na ukázkových dokumentech nebo nahrání vlastních dokumentů.
• Experimentujte s různými funkcemi doplňku a verze Preview, abyste přizpůsobili výstup vašim potřebám.
• Trénujte vlastní klasifikační modely pro klasifikaci dokumentů.
• Trénujte vlastní modely extrakce pro extrakci polí z dokumentů.
• Získejte vzorový kód pro jazyk specifický SDKs pro integraci do vašich aplikací.

V současné době procházíme migrací funkcí ze sady Document Intelligence Studio na nový portál Azure AI Foundry. V nabídkách pro dvě studia existují určité rozdíly, které určují správné studio pro váš případ použití.

Volba správného prostředí studia

V současné době existují dvě studia, portál Azure AI Foundry a Sada Document Intelligence Studio pro vytváření a ověřování modelů Document Intelligence. Při migraci prostředí na nový portál Azure AI Foundry jsou některá prostředí dostupná v obou studiích, zatímco jiné prostředí/modely jsou k dispozici pouze v jednom z studií. Pokud chcete postupovat podle několika pokynů pro výběr prostředí studia pro vaše potřeby. Všechny naše předem připravené modely a obecné extrahovací modely jsou k dispozici v obou studiích.

Kdy použít Document Intelligence Studio

Document Intelligence Studio obsahuje všechny funkce vydané dne nebo před listopadem 2024. U některé z funkcí v2.1, v3.0 a v3.1 nadále používejte Sadu Document Intelligence Studio. Studia poskytují vizuální prostředí pro označování, trénování a ověřování vlastních modelů. Pro vlastní modely extrakce polí dokumentů použijte sadu Document Intelligence Studio pro šablony a neurální modely. Vlastní klasifikační modely je možné vytrénovat a používat pouze v nástroji Document Intelligence Studio. Pokud chcete vyzkoušet verze GA modelů z verze 3.0, v3.1 a v4.0, použijte Document Intelligence Studio.

Kdy použít portál Azure AI Foundry

Začněte s novou službou Azure AI Foundry a vyzkoušejte některý z předem připravených modelů dokumentů z 2024-02-29-preview verze, včetně obecných modelů extrakce, jako je čtení nebo rozložení.

Další informace o nástroji Document Intelligence Studio

Na následujících kartách vyberte prostředí studia, kde najdete další informace o každém studiu a o tom, jak můžete začít.

Document Intelligence Studio

Důležité

• Pro oblasti suverénního cloudu sady Document Intelligence Studio existují samostatné adresy URL.
• Azure for US Government: Document Intelligence Studio (cloud Azure Fairfax)
• Microsoft Azure provozovaný společností 21Vianet: Document Intelligence Studio (Azure v Číně)

Studio podporuje document intelligence v3.0 a novější verze rozhraní API pro analýzu modelů a vlastní trénování modelů. Dříve vytrénované modely v2.1 s označenými daty se podporují, ale ne trénování modelu v2.1. Podrobné informace o migraci z verze 2.1 na verzi 3.0 najdete v průvodci migrací rozhraní REST API.

Rychlý start k analýze dokumentů pomocí analýzy dokumentů nebo předem připravených modelů vám umožní rychlý start sady Document Intelligence Studio. Vytvářejte vlastní modely a odkazujte na modely ve svých aplikacích pomocí některého z jazyků specifických pro daný SDKsjazyk .

Požadavky

Pokud chcete použít Document Intelligence Studio, musíte na webu Azure Portal získat následující prostředky:

• Předplatné Azure - Vytvořte si ho zdarma.

• Služby Azure AI nebo prostředek Document Intelligence Jakmile budete mít předplatné Azure, vytvořte na webu Azure Portal prostředek s jednou službou nebo více službami, abyste získali klíč a koncový bod. K vyzkoušení služby použijte cenovou úroveňF0 Free a upgradujte ji později na placenou úroveň pro produkční prostředí.

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.

Existují další požadavky pro použití vlastních modelů v nástroji Document Intelligence Studio. Podrobné pokyny najdete v dokumentaci .

Zásady autorizace

Vaše organizace se může rozhodnout zakázat místní ověřování a vynutit ověřování Microsoft Entra (dříve Azure Active Directory) pro prostředky Azure Document Intelligence a Azure Blob Storage.

• Ověřování Microsoft Entra vyžaduje, aby byla autorizace založená na klíči zakázaná. Po zakázání přístupu ke klíči je ID Microsoft Entra jedinou dostupnou metodou autorizace.

• Microsoft Entra umožňuje udělit minimální oprávnění a podrobné řízení prostředků Azure.

Další informace najdete v následujících doprovodných materiálech:

• Zakažte místní ověřování pro služby Azure AI.
• Zabránění autorizaci sdíleného klíče pro účet služby Azure Storage

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ý.

• Navrhování přiřazení rolí Základní přístup k sadě Document Intelligence Studio vyžaduje roli Cognitive Services User . Další informace najdete v tématu Přiřazení rolí funkce Document Intelligence.

Důležité

• Při nastavování ověřování Entra se ujistěte, že máte roli uživatele služeb Cognitive Services, a ne roli Přispěvatel služeb Cognitive Services.
• ✔️ Uživatel služeb Cognitive Services: K zadání stránky analýzy potřebujete tuto roli pro prostředek služby Document Intelligence nebo služby Azure AI.
• ✔️ Přispěvatel: Tuto roli potřebujete k vytvoření skupiny prostředků, služby Document Intelligence nebo prostředku služeb Azure AI.
• V kontextu Azure může role Přispěvatel provádět akce pouze pro řízení a správu samotného prostředku, včetně výpisu přístupových klíčů.
• Uživatelské účty s přispěvatelem mají přístup pouze ke službě Document Intelligence voláním pomocí přístupových klíčů. Při nastavování přístupu pomocí ID Entra se však zakáže přístup ke klíči a pro účet, který bude používat prostředky, bude vyžadována role uživatele služby Cognitive Service.

Ověřování v sadě Studio

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í.

Podpora modelu Document Intelligence

K pochopení fungování jednotlivých funkcí použijte průvodce nápovědou, rozhraní popisků, krok trénování a interaktivní vizualizace.

• Přečtěte si: Vyzkoušejte si funkci Čtení v sadě Document Intelligence s ukázkovými dokumenty nebo vlastními dokumenty a extrahujte textové čáry, slova, rozpoznané jazyky a ručně psaný styl, pokud se zjistí. Další informace najdete v tématu Přehled pro čtení.

• Rozložení: Vyzkoušejte si funkci Rozložení sady Document Intelligence s ukázkovými dokumenty nebo vlastními dokumenty a extrahujte text, tabulky, značky výběru a informace o struktuře. Další informace najdete v tématu Přehled rozložení.

• Předem připravené modely: Předem připravené modely funkce Document Intelligence umožňují přidat do aplikací a toků inteligentní zpracování dokumentů, aniž byste museli trénovat a vytvářet vlastní modely. Začněte například funkcí Faktura za studio. Další informace najdete v tématu Přehled modelů.

• Vlastní modely extrakce: Funkce vlastních modelů Document Intelligence umožňuje extrahovat pole a hodnoty z modelů natrénovaných s vašimi daty, které jsou přizpůsobené vašim formulářům a dokumentům. Pokud chcete extrahovat data z více typů formulářů, vytvořte samostatné vlastní modely nebo zkombinujte dva nebo více vlastních modelů a vytvořte složený model. Otestujte vlastní model pomocí ukázkových dokumentů a iterujte ho a vylepšete ho. Další informace najdete v přehledu vlastních modelů.

• Vlastní klasifikační modely: Klasifikace dokumentů je nový scénář podporovaný funkcí Document Intelligence. Rozhraní API klasifikátoru dokumentů podporuje scénáře klasifikace a rozdělení. Trénování klasifikačního modelu pro identifikaci různých typů dokumentů, které vaše aplikace podporuje. Vstupní soubor klasifikačního modelu může obsahovat více dokumentů a klasifikuje každý dokument v přidruženém rozsahu stránek. Další informace najdete v modelech vlastní klasifikace.

• Možnosti doplňku: Funkce Document Intelligence podporuje sofistikovanější možnosti analýzy. Tyto volitelné funkce je možné povolit a zakázat v sadě Studio pomocí Analyze Options tlačítka na každé stránce modelu. K dispozici jsou čtyři možnosti doplňku: highResolution, formulafont, a barcode extraction možnosti. Další informace najdete v tématu Možnosti doplňku.

Vyzkoušení modelu document intelligence

• 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ů.

• 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í.

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.

Díky funkci Document Intelligence můžete rychle automatizovat zpracování dat v aplikacích a pracovních postupech, snadno vylepšovat strategie řízené daty a zručně obohatit možnosti hledání dokumentů.

Řešení problému

Scénář	Příčina	Řešení
Při otevření vlastního projektu se zobrazí chybová zpráva Form Recognizer Not Found.	Zdroj Document Intelligence, svázaný s vlastním projektem, byl odstraněn nebo přesunut do jiné skupiny prostředků.	Tento problém lze vyřešit dvěma způsoby: • Znovu vytvořte prostředek Document Intelligence ve stejném předplatném a skupině prostředků se stejným názvem. • Znovu vytvořte vlastní projekt s migrovaným prostředkem Document Intelligence a zadejte stejný účet úložiště.
Při použití předem připravených aplikací nebo otevření vlastního projektu se zobrazí chybová zpráva PermissionDenied.	Objekt zabezpečení nemá přístup k rozhraní API nebo operaci při analýze předpřipravených modelů nebo otevření vlastního projektu. Je pravděpodobné, že místní ověřování (založené na klíči) pro prostředek Document Intelligence nemá dostatečná oprávnění pro přístup k prostředku.	Referenční přiřazení rolí Azure ke konfiguraci přístupových rolí
Při otevření vlastního projektu se zobrazí chybová zpráva AuthorizationPermissionMismatch.	Požadavek nemá oprávnění k provedení operace pomocí určeného oprávnění. Je pravděpodobné, že pro váš účet úložiště je zakázané místní ověřování (založené na klíčích) a nemáte udělené oprávnění pro přístup k datům objektů blob.	Referenční přiřazení rolí Azure ke konfiguraci přístupových rolí
Nemůžete se přihlásit k nástroji Document Intelligence Studio a zobrazit chybovou zprávu InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in	Je pravděpodobné, že váš prohlížeč blokuje soubory cookie třetích stran, takže se nemůžete úspěšně přihlásit.	Pokud chcete tento problém vyřešit, přečtěte si téma Správa nastavení třetích stran pro váš prohlížeč.

Správa nastavení třetích stran pro přístup k sadě Studio

Edge:

• Přejít na Nastavení pro Microsoft Edge
• Vyhledejte "třetí*stranu".
• Přejděte na Správa a odstranění souborů cookie a dat webu.
• Vypnutí nastavení Blokovat soubory cookie třetích stran

Chrome:

• Přejít na Nastavení pro Chrome
• Vyhledejte "Třetí*strana".
• V části Výchozí chování vyberte Povolit soubory cookie třetích stran.

Firefox:

• Přejít na Nastavení firefoxu
• Vyhledejte "soubory cookie"
• V části Rozšířená ochrana sledování vyberte Spravovat výjimky.
• Přidání výjimky pro https://documentintelligence.ai.azure.com adresu URL sady Document Intelligence Studio pro vaše prostředí

Safari:

• Zvolte Předvolby Safari.>
• Vybrat ochranu osobních údajů
• Zrušit výběr blokování všech souborů cookie

Portál Azure AI Foundry

Funkce Document Intelligence je součástí nabídek služeb Azure AI na portálu Azure AI Foundry. Každá služba Azure AI pomáhá vývojářům a organizacím rychle vytvářet inteligentní, špičkové, připravené a zodpovědné aplikace s předem připravenými a předem připravenými a přizpůsobitelnými rozhraními API a modely.

Zjistěte, jak propojit centrum služeb AI se službami AI a začít používat funkci Document Intelligence.

Další kroky

• Navštivte Document Intelligence Studio.
• Navštivte portál Azure AI Foundry.
• Začínáme s rychlým startem pro Document Intelligence Studio