Inizia: Document Intelligence Studio

Azure Document Intelligence in Foundry Tools Studio è uno strumento online che è possibile usare per esplorare, comprendere e integrare visivamente le funzionalità del servizio Document Intelligence nelle applicazioni. È possibile iniziare esplorando i modelli preaddestrati con esempi o i propri documenti. È anche possibile creare progetti per compilare modelli di modello personalizzati e fare riferimento ai modelli nelle applicazioni.

Prerequisiti

  • Sottoscrizione Azure. Crearne uno gratuitamente.
  • Una risorsa di Document Intelligence Azure. Dopo aver ottenuto una sottoscrizione di Azure, creare una risorsa a servizio singolo o multiservizio di Azure nel portale di Azure, per ottenere la chiave e l'endpoint.
  • Per provare il servizio, usare il piano tariffario gratuito (F0). È possibile eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

Suggerimento

Creare una risorsa Microsoft Foundry se si prevede di accedere a più strumenti Foundry con un singolo endpoint/chiave. Solo per l'accesso a Document Intelligence, creare una risorsa di Document Intelligence. Se si intende usare Microsoft Entra l'autenticazione è necessaria una risorsa a servizio singolo.

Document Intelligence supporta ora l'autenticazione tramite token di Microsoft Entra ID, oltre all'autenticazione locale (basata su chiave), quando si accedono alle risorse e agli account di archiviazione di Document Intelligence. Seguire le istruzioni per configurare i ruoli di accesso corretti, soprattutto se le risorse sono applicate con il criterio DisableLocalAuth.

Sono stati aggiunti i prerequisiti per l'uso di modelli personalizzati in Document Intelligence Studio. Per indicazioni dettagliate, vedere Progetti personalizzati di Document Intelligence Studio.

Criteri di autorizzazione

L'organizzazione può scegliere di disabilitare l'autenticazione locale e applicare l'autenticazione Microsoft Entra (in precedenza Azure Active Directory) per le risorse di Document Intelligence e Archiviazione BLOB di Azure.

  • L'autenticazione di Microsoft Entra richiede che l'autorizzazione basata su chiave sia disabilitata. Dopo aver disabilitato l'accesso alla chiave, Microsoft Entra ID è l'unico metodo di autorizzazione disponibile.
  • Microsoft Entra consente di concedere privilegi minimi e un controllo granulare per le risorse Azure.

Per altre informazioni, vedere le indicazioni seguenti:

Se l'autenticazione locale (basata su chiave) è disabilitata per la risorsa del servizio Document Intelligence, assicurarsi di ottenere il ruolo utente di Servizi cognitivi e il token Microsoft Entra ID per autenticare le richieste in Document Intelligence Studio. Il ruolo Collaboratore consente di elencare solo le chiavi, ma non di concedere l'autorizzazione per usare la risorsa quando l'accesso alla chiave è disabilitato.

Designare le assegnazioni di ruolo

L'accesso di base di Document Intelligence Studio richiede il ruolo utente di Servizi cognitivi . Per altre informazioni, vedere Assegnazioni di ruolo di Intelligence sui documenti.

  • Assicurarsi di disporre del ruolo di Utente dei Servizi cognitivi e non del ruolo di Collaboratore dei Servizi cognitivi quando si configura l'autenticazione di Microsoft Entra ID.

    • Utente di Servizi cognitivi: è necessario questo ruolo per la risorsa Document Intelligence o Microsoft Foundry per immettere la pagina di analisi.
    • Contributor: è necessario questo ruolo per creare un gruppo di risorse, un servizio Document Intelligence o una risorsa Microsoft Foundry.

  • In Azure contesto, il ruolo Collaboratore può eseguire azioni solo per controllare e gestire la risorsa stessa, incluso l'elenco delle chiavi di accesso.

  • Gli account utente con un ruolo Collaboratore possono accedere al servizio Document Intelligence solo chiamando con chiavi di accesso. Quando si configura l'accesso con Microsoft Entra ID, l'accesso alla chiave è disabilitato e per usare le risorse è necessario il ruolo Utente servizi cognitivi.

Autenticazione in Document Intelligence Studio

Passare a Document Intelligence Studio. Se è la prima volta che si accede, viene richiesto di configurare la risorsa del servizio. In conformità ai criteri dell'organizzazione, sono disponibili le opzioni seguenti:

  • autenticazione Microsoft Entra: accesso per risorsa (scelta consigliata)

    1. Selezionare la sottoscrizione esistente.

    2. Selezionare un gruppo di risorse esistente all'interno della sottoscrizione o crearne uno nuovo.

    3. Seleziona la risorsa Document Intelligence esistente o Microsoft Foundry.

      Screenshot che mostra la configurazione di una risorsa del servizio in Document Intelligence Studio.

  • Autenticazione locale: accesso tramite endpoint API e chiave

    1. Recuperare l'endpoint e la chiave dal portale di Azure.

    2. Vai alla pagina di panoramica per la tua risorsa e nel riquadro sinistro seleziona Chiavi ed endpoint.

    3. Immettere i valori nei campi appropriati.

      Screenshot che mostra la pagina Chiavi ed Endpoint del portale di Azure.

  • Dopo aver convalidato lo scenario in Document Intelligence Studio, usare il C#Java, JavaScript o Python o l'API REST per incorporare modelli di Document Intelligence nelle proprie applicazioni.

Provare un modello di Business Intelligence per i documenti

Per altre informazioni sui modelli di Document Intelligence disponibili, vedere Supporto dei modelli di Business Intelligence per i documenti.

  • Provare i diversi modelli offerti da Document Intelligence Studio dopo aver configurato la risorsa. Selezionare un modello di Intelligence per i documenti da usare con un approccio senza codice.
  • Testare uno dei modelli predefiniti o di analisi dei documenti. Selezionare il modello e usare uno dei documenti di esempio o caricare il proprio documento da analizzare. Il risultato dell'analisi viene visualizzato nel riquadro a destra che mostra il codice dei risultati del contenuto.
  • Eseguire il training dei modelli personalizzati nei documenti. Per una panoramica dei modelli personalizzati, vedere Panoramica dei modelli personalizzati.
  • Convalidare lo scenario in Document Intelligence Studio. Usare quindi C#Java, JavaScript o Python librerie client o l'API REST per incorporare modelli di Document Intelligence nelle proprie applicazioni.

Visualizzare i dettagli delle risorse

Per visualizzare i dettagli delle risorse, ad esempio nome e piano tariffario, selezionare l'icona Impostazioni nell'angolo superiore destro della home page di Document Intelligence Studio e quindi selezionare la scheda Risorsa . Se si ha accesso ad altre risorse, è anche possibile cambiare le risorse.

Screenshot che mostra la scheda Risorsa della pagina Impostazioni.

Grazie a Document Intelligence, è possibile automatizzare rapidamente l'elaborazione dei dati in applicazioni e flussi di lavoro, migliorare facilmente le strategie guidate dai dati e arricchire in modo efficiente le funzionalità di ricerca dei documenti.

Gestire le impostazioni non Microsoft per l'accesso a Document Intelligence Studio

Microsoft Edge
  1. Passare a Impostazioni per Microsoft Edge.
  2. Cercare Terze parti.
  3. Passare a Gestisci ed eliminare cookie e dati del sito.
  4. Disattivare l'impostazione Blocca cookie di terze parti.
Chrome
  1. Passare a Impostazioni per Chrome.
  2. Cercare Terze parti.
  3. In Comportamento predefinito selezionare Consenti cookie di terze parti.
Firefox
  1. Vai a Impostazioni per Firefox.
  2. Cercare cookies.
  3. In Protezione avanzata rilevamento selezionare Gestisci eccezioni.
  4. Aggiungere un'eccezione per https://documentintelligence.ai.azure.com o l'URL dell'ambiente di Document Intelligence Studio.
Safari
  1. Selezionare Safari>Preferenze.
  2. Selezionare Privacy.
  3. Deselezionare Blocca tutti i cookie.

Risoluzione dei problemi

Scenario Causa Risoluzione
Viene visualizzato il messaggio di errore
Riconoscimento modulo Not Found quando si apre un progetto personalizzato.		 La risorsa di Document Intelligence, associata al progetto personalizzato, è stata eliminata o spostata in un altro gruppo di risorse. Esistono due modi per risolvere questo problema:
• Ricreare la risorsa di Document Intelligence nella stessa sottoscrizione e nello stesso gruppo di risorse con lo stesso nome.
• Ricreare un progetto personalizzato con la risorsa document intelligence migrata e specificare lo stesso account di archiviazione.
Viene visualizzato il messaggio
PermissionDenied di errore quando si usano app predefinite o si apre un progetto personalizzato.		 Il principale non ha accesso all'API o al funzionamento quando analizza contro modelli predefiniti o apre un progetto personalizzato. È probabile che l'autenticazione locale (basata su chiave) sia disabilitata per la risorsa di Document Intelligence e che non si disponga di autorizzazioni sufficienti per accedere alla risorsa. Per configurare i ruoli di accesso, vedere Azure assegnazioni di ruolo.
Viene visualizzato il messaggio di
AuthorizationPermissionMismatch errore quando si apre un progetto personalizzato.		 La richiesta non è autorizzata a eseguire l'operazione usando l'autorizzazione designata. È probabile che l'autenticazione locale (basata su chiave) sia disabilitata per l'account di archiviazione e che non si disponga dell'autorizzazione concessa per accedere ai dati BLOB. Per configurare i ruoli di accesso, vedere Azure assegnazioni di ruolo.
Non è possibile accedere a Document Intelligence Studio e ricevere il messaggio
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in di errore.		 È probabile che il browser stia bloccando i cookie non Microsoft, quindi non è possibile accedere correttamente. Per risolvere questo problema, vedere Gestire le impostazioni non Microsoft per il browser.

Contenuto correlato

  • Last updated on