Dela via

Studio-upplevelse för Dokumentinformation

  • Artikel

Det här innehållet gäller för:Bockmarkering v4.0 (GA) | Tidigare versioner: blå bockmarkering v3.1 (GA)blå bockmarkering v3.0 (GA)

Studion är ett onlineverktyg för att visuellt utforska, förstå, träna och integrera funktioner från dokumentinformationstjänsten i dina program. Studion tillhandahåller en plattform där du kan experimentera med de olika modellerna för dokumentinformation och exempel returnerade data på ett interaktivt sätt utan att behöva skriva kod. Du kan använda studioupplevelsen för att:

  • Läs mer om de olika funktionerna i Dokumentinformation.
  • Använd dokumentinformationsresursen för att testa modeller på exempeldokument eller ladda upp dina egna dokument.
  • Experimentera med olika tilläggs- och förhandsversionsfunktioner för att anpassa utdata efter dina behov.
  • Träna anpassade klassificeringsmodeller för att klassificera dokument.
  • Träna anpassade extraheringsmodeller för att extrahera fält från dokument.
  • Hämta exempelkod för det språk som är specifikt SDKs för integrering i dina program.

För närvarande genomgår vi migrering av funktioner från Document Intelligence Studio till den nya Azure AI Foundry-portalen. Det finns vissa skillnader i erbjudandena för de två studiorna, som bestämmer rätt studio för ditt användningsfall.

Välja rätt studioupplevelse

Det finns för närvarande två studior, Azure AI Foundry-portalen och Document Intelligence Studio för att skapa och validera dokumentinformationsmodeller. När upplevelserna migreras till den nya Azure AI Foundry-portalen är vissa upplevelser tillgängliga i båda studiorna, medan andra upplevelser/modeller endast är tillgängliga i en av studiorna. Att följa är några riktlinjer för att välja Studio-upplevelsen för dina behov. Alla våra fördefinierade modeller och allmänna extraheringsmodeller finns i båda studiorna.

När du ska använda Document Intelligence Studio

Document Intelligence Studio innehåller alla funktioner som släpptes den eller före november 2024. För någon av funktionerna v2.1, v3.0, v3.1 fortsätter du att använda Document Intelligence Studio. Studior ger en visuell upplevelse för etikettering, utbildning och validering av anpassade modeller. För extraheringsmodeller för anpassade dokumentfält använder du Document Intelligence Studio för mallar och neurala modeller. Anpassade klassificeringsmodeller kan endast tränas och användas i Document Intelligence Studio. Använd Document Intelligence Studio om du vill testa GA-versioner av modellerna från version v3.0, v3.1 och v4.0.

När du ska använda Azure AI Foundry-portalen

Börja med den nya Azure AI Foundry och prova någon av de fördefinierade dokumentmodellerna från 2024-02-29-preview versionen, inklusive allmänna extraheringsmodeller som Läs eller Layout.

Läs mer om Document Intelligence Studio

Välj studioupplevelsen från följande flikar för att lära dig mer om varje studio och hur du kan komma igång.

Viktigt!

Studion stöder Document Intelligence v3.0 och senare API-versioner för modellanalys och anpassad modellträning. Tidigare tränade v2.1-modeller med märkta data stöds, men inte v2.1-modellträning. Mer information om migrering från v2.1 till v3.0 finns i REST API-migreringsguiden .

Använd snabbstarten för Document Intelligence Studio för att komma igång med att analysera dokument med dokumentanalys eller fördefinierade modeller. Skapa anpassade modeller och referera till modellerna i dina program med något av språkspecifika SDKs.

Förutsättningar

Om du vill använda Document Intelligence Studio måste du hämta följande tillgångar från Azure Portal:

  • En Azure-prenumeration - Skapa en kostnadsfritt.

  • En Azure AI-tjänst eller dokumentinformationsresurs. När du har din Azure-prenumeration skapar du en resurs med en enda tjänst eller flera tjänster i Azure Portal för att hämta din nyckel och slutpunkt. Använd den kostnadsfria prisnivån (F0) för att prova tjänsten och uppgradera senare till en betald nivå för produktion.

Dricks

Skapa en Azure AI-tjänstresurs om du planerar att komma åt flera Azure AI-tjänster under en enda slutpunkt/nyckel. För endast åtkomst till dokumentinformation skapar du en dokumentinformationsresurs. Observera att du behöver en resurs med en enda tjänst om du tänker använda Microsoft Entra-autentisering.

Dokumentinformation stöder nu AAD-tokenautentisering utöver lokal (nyckelbaserad) autentisering vid åtkomst till dokumentinformationsresurser och lagringskonton. Se till att följa anvisningarna nedan för att konfigurera rätt åtkomstroller, särskilt om dina resurser tillämpas med DisableLocalAuth principen.

Det finns ytterligare förutsättningar för att använda anpassade modeller i Document Intelligence Studio. I dokumentationen finns stegvisa anvisningar.

Auktoriseringsprinciper

Din organisation kan välja att inaktivera lokal autentisering och framtvinga Microsoft Entra-autentisering (tidigare Azure Active Directory) för Azure AI Document Intelligence-resurser och Azure Blob Storage.

  • Microsoft Entra-autentisering kräver att nyckelbaserad auktorisering är inaktiverad. När nyckelåtkomst har inaktiverats är Microsoft Entra-ID den enda tillgängliga auktoriseringsmetoden.

  • Med Microsoft Entra kan du bevilja minsta möjliga behörighet och detaljerad kontroll för Azure-resurser.

Mer information finns i följande vägledning:

Kommentar

Om lokal (nyckelbaserad) autentisering är inaktiverad för din dokumentinformationstjänstresurs måste du skaffa användarrollen Cognitive Services och AAD-token används för att autentisera begäranden i Document Intelligence Studio. Deltagarrollen tillåter bara att du listar nycklar men inte ger dig behörighet att använda resursen när nyckelåtkomst är inaktiverad.

Viktigt!

  • Kontrollera att du har rollen Cognitive Services-användare och inte rollen Cognitive Services-deltagare när du konfigurerar Entra-autentisering.
  • ✔️ Cognitive Services-användare: du behöver den här rollen för att dokumentera intelligens eller Azure AI-tjänster för att komma in på analyssidan.
  • ✔️ Deltagare: du behöver den här rollen för att skapa resursgruppen, document intelligence-tjänsten eller Azure AI-tjänstresursen.
  • I Azure-kontext kan deltagarrollen endast utföra åtgärder för att styra och hantera själva resursen, inklusive att visa åtkomstnycklarna.
  • Användarkonton med en deltagare kan bara komma åt dokumentinformationstjänsten genom att anropa med åtkomstnycklar. Men när du konfigurerar åtkomst med Entra-ID inaktiveras nyckelåtkomst och cognitive service-användarrollen krävs för att ett konto ska kunna använda resurserna.

Autentisering i Studio

Gå till Document Intelligence Studio. Om det är första gången du loggar in visas ett popup-fönster där du uppmanas att konfigurera tjänstresursen. I enlighet med organisationens princip har du ett eller två alternativ:

  • Microsoft Entra-autentisering: åtkomst efter resurs (rekommenderas).

    • Välj din befintliga prenumeration.

    • Välj en befintlig resursgrupp i din prenumeration eller skapa en ny.

    • Välj din befintliga dokumentinformations- eller Azure AI-tjänstresurs.

      Skärmbild av konfigurera tjänstresursformulär från Document Intelligence Studio.

  • Lokal autentisering: åtkomst via API-slutpunkt och nyckel.

    • Hämta slutpunkten och nyckeln från Azure Portal.

    • Gå till översiktssidan för resursen och välj Nycklar och slutpunkt i det vänstra navigeringsfältet.

    • Ange värdena i lämpliga fält.

      Skärmbild av nycklar och slutpunktssidan i Azure Portal.

  • När du har verifierat scenariot i Document Intelligence Studio använder du klientbiblioteken C#, Java, JavaScript eller Python eller REST-API:et för att komma igång med att införliva dokumentinformationsmodeller i dina egna program.

Stöd för dokumentinformationsmodell

Använd hjälpguiden, etiketteringsgränssnittet, träningssteget och interaktiva visualiseringar för att förstå hur varje funktion fungerar.

  • Läs: Prova funktionen För dokumentinformations studioläsning med exempeldokument eller egna dokument och extrahera textrader, ord, identifierade språk och handskriven stil om det upptäcks. Mer information finns i Läs översikt.

  • Layout: Prova funktionen För dokumentinformations studiolayout med exempeldokument eller egna dokument och extrahera text, tabeller, markeringsmarkeringar och strukturinformation. Mer information finns i Layoutöversikt.

  • Fördefinierade modeller: Med dokumentinformationens fördefinierade modeller kan du lägga till intelligent dokumentbearbetning i dina appar och flöden utan att behöva träna och skapa egna modeller. Börja till exempel med funktionen Studio-faktura. Mer information finns i Översikt över modeller.

  • Anpassade extraheringsmodeller: Med funktionen Anpassade Studio-modeller i Dokumentinformation kan du extrahera fält och värden från modeller som tränats med dina data, skräddarsydda för dina formulär och dokument. Om du vill extrahera data från flera formulärtyper skapar du fristående anpassade modeller eller kombinerar två eller flera anpassade modeller och skapar en sammansatt modell. Testa den anpassade modellen med dina exempeldokument och iterera för att förbättra modellen. Mer information finns i översikten över anpassade modeller.

  • Anpassade klassificeringsmodeller: Dokumentklassificering är ett nytt scenario som stöds av Dokumentinformation. API:et för dokumentklassificerare stöder klassificerings- och delningsscenarier. Träna en klassificeringsmodell för att identifiera de olika typer av dokument som programmet stöder. Indatafilen för klassificeringsmodellen kan innehålla flera dokument och klassificera varje dokument inom ett associerat sidintervall. Mer information finns i anpassade klassificeringsmodeller.

  • Tilläggsfunktioner: Dokumentinformation stöder mer avancerade analysfunktioner. Dessa valfria funktioner kan aktiveras och inaktiveras i studion med hjälp av Analyze Options knappen på varje modellsida. Det finns fyra tillgängliga tilläggsfunktioner: highResolution, formula, fontoch barcode extraction funktioner. Mer information finns i Tilläggsfunktioner.

Prova en dokumentinformationsmodell

  • När resursen har konfigurerats kan du prova de olika modeller som erbjuds av Document Intelligence Studio. På första sidan väljer du valfri dokumentinformationsmodell för att försöka använda med en metod utan kod.

  • Om du vill testa någon av dokumentanalyserna eller de fördefinierade modellerna väljer du modellen och använder ett av exempeldokumenten eller laddar upp ett eget dokument för att analysera. Analysresultatet visas till höger i fönstret content-result-code.

  • Anpassade modeller måste tränas på dina dokument. Se översikten över anpassade modeller för en översikt över anpassade modeller.

  • När du har verifierat scenariot i Document Intelligence Studio använder du klientbiblioteken C#, Java, JavaScript eller Python eller REST-API:et för att komma igång med att införliva dokumentinformationsmodeller i dina egna program.

Visa resursinformation

Om du vill visa resursinformation som namn och prisnivå väljer du ikonen Inställningar i det övre högra hörnet på startsidan för Document Intelligence Studio och väljer fliken Resurs . Om du har åtkomst till andra resurser kan du också byta resurser.

Skärmbild av resursfliken för studioinställningar.

Med Dokumentinformation kan du snabbt automatisera databearbetningen i program och arbetsflöden, enkelt förbättra datadrivna strategier och på ett skickligt sätt utöka funktionerna för dokumentsökning.

Felsökning

Scenario Orsak Åtgärd
Du får felmeddelandet
Form Recognizer Not Found när du öppnar ett anpassat projekt.		 Dokumentinformationsresursen, som är bunden till det anpassade projektet, har tagits bort eller flyttats till en annan resursgrupp. Det finns två sätt att lösa det här problemet:
• Återskapa dokumentinformationsresursen under samma prenumeration och resursgrupp med samma namn.
• Återskapa ett anpassat projekt med den migrerade dokumentinformationsresursen och ange samma lagringskonto.
Du får felmeddelandet
PermissionDenied när du använder fördefinierade appar eller öppnar ett anpassat projekt.		 Huvudnamnet har inte åtkomst till API/Operation" när du analyserar mot fördefinierade modeller eller öppnar ett anpassat projekt. Det är troligt att den lokala (nyckelbaserade) autentiseringen är inaktiverad för att dokumentinformationsresursen inte har tillräcklig behörighet för att komma åt resursen. Referera till Azure-rolltilldelningar för att konfigurera dina åtkomstroller.
Du får felmeddelandet
AuthorizationPermissionMismatch när du öppnar ett anpassat projekt.		 Begäran har inte behörighet att utföra åtgärden med den avsedda behörigheten. Det är troligt att den lokala (nyckelbaserade) autentiseringen är inaktiverad för ditt lagringskonto och du har inte behörighet att komma åt blobdata. Referera till Azure-rolltilldelningar för att konfigurera dina åtkomstroller.
Du kan inte logga in på Document Intelligence Studio och få felmeddelandet
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in		 Det är troligt att webbläsaren blockerar cookies från tredje part så att du inte kan logga in. Information om hur du löser problemet finns i Hantera inställningar från tredje part för webbläsaren.

Hantera inställningar från tredje part för Studio-åtkomst

Edge:

  • Gå till Inställningar för Microsoft Edge
  • Sök efter "tredje*part"
  • Gå till Hantera och ta bort cookies och webbplatsdata
  • Inaktivera inställningen Blockera cookies från tredje part

Chrome:

  • Gå till Inställningar för Chrome
  • Sök efter "Tredje*part"
  • Under Standardbeteende väljer du Tillåt cookies från tredje part

Firefox:

  • Gå till Inställningar för Firefox
  • Sök efter "cookies"
  • Under Utökat spårningsskydd väljer du Hantera undantag
  • Lägg till undantag för https://documentintelligence.ai.azure.com eller url:en för Document Intelligence Studio för din miljö

Safari:

  • Välj Safari-inställningar>
  • Välj Sekretess
  • Avmarkera Blockera alla cookies