Configurare i contenitori di Document Intelligence

Articolo
12/15/2023

Il supporto per i contenitori è attualmente disponibile con la versione 2022-08-31 (GA) di Document Intelligence per tutti i modelli e 2023-07-31 (GA) solo per lettura e layout:

✔️ Vedere Configurare i contenitori di Document Intelligence v3.0 per la documentazione del contenitore supportata.

Questo contenuto si applica a:v3.0 (GA)v3.1 (GA)

Con i contenitori di Document Intelligence è possibile creare un'architettura dell'applicazione ottimizzata per sfruttare sia funzionalità cloud affidabili che la località perimetrale. I contenitori offrono un ambiente minimalista e isolato che può essere facilmente distribuito in locale e nel cloud. In questo articolo viene illustrato come configurare l'ambiente di runtime del contenitore di Document Intelligence usando gli argomenti del docker compose comando. Le funzionalità di Business Intelligence per i documenti sono supportate da sette contenitori di funzionalità di Business Intelligence: lettura, layout, biglietto da visita, documento ID, ricevuta, fattura, personalizzata. Questi contenitori hanno impostazioni sia obbligatorie che facoltative. Per alcuni esempi, vedere la sezione Esempio docker-compose.yml file .

Impostazioni di configurazione

Ogni contenitore ha le impostazioni di configurazione seguenti:

Richiesto	Impostazione	Purpose
Sì	Chiave	Tiene traccia delle informazioni di fatturazione.
Sì	Fatturazione	Specifica l'URI dell'endpoint della risorsa del servizio in Azure. Per altre informazioni, vedereFatturazione. Per altre informazioni e un elenco completo degli endpoint a livello di area, vedereNomi di sottodomini personalizzati per i servizi di intelligenza artificiale di Azure.
Sì	Eula	Indica che è la licenza per il contenitore è stata accettata.
No	ApplicationInsights	Consente di aggiungere app Azure lication Insights al supporto clienti per il contenitore.
No	Fluentd	Scrive il log e, facoltativamente, i dati delle metriche in un server Fluentd.
No	Proxy HTTP	Configura un proxy HTTP per le richieste in uscita.
No	Registrazione	Fornisce il supporto di registrazione ASP.NET Core per il contenitore.

Importante

Le impostazioni Key, Billing e Eula vengono usate insieme. È necessario fornire valori validi per tutte e tre le impostazioni; in caso contrario, i contenitori non verranno avviati. Per altre informazioni sull'uso di queste impostazioni di configurazione per creare un'istanza di un contenitore, vedere Billing (Fatturazione).

Impostazione di configurazione chiave e fatturazione

L'impostazione Key specifica la chiave di risorsa di Azure usata per tenere traccia delle informazioni di fatturazione per il contenitore. Il valore della chiave deve essere una chiave valida per la risorsa specificata nella Billing sezione "Impostazione di configurazione fatturazione".

L'impostazione Billing specifica l'URI dell'endpoint della risorsa in Azure usato per misurare le informazioni di fatturazione per il contenitore. Il valore per questa impostazione di configurazione deve essere un URI dell'endpoint valido per una risorsa in Azure. Il contenitore segnala l'utilizzo ogni 10-15 minuti.

Queste impostazioni sono disponibili nella portale di Azure nella pagina Chiavi ed endpoint.

Screenshot of Azure portal keys and endpoint page.

Impostazione del contratto di licenza

L'impostazione Eula indica che è stata accettata la licenza per il contenitore. È necessario specificare un valore per questa impostazione di configurazione e tale valore deve essere impostato su accept.

Obbligatoria	Nome	Tipo di dati	Descrizione
Sì	`Eula`	String	Accettazione della licenza Esempio: `Eula=accept`

I contenitori dei servizi di intelligenza artificiale di Azure sono concessi in licenza con il contratto che regola l'uso di Azure. Se non si dispone di tale contratto, si acconsente che l'uso di Azure sia disciplinato dal Contratto di Sottoscrizione Microsoft Online, in cui sono incluse le condizioni per l'utilizzo dei Servizi Online. Per le anteprime si accettano inoltre le Condizioni Supplementari per l'Utilizzo delle Anteprime di Microsoft Azure. Con l'uso del contenitore si acconsente a rispettare tali condizioni.

Impostazione ApplicationInsights

L'impostazione ApplicationInsights consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights. Application Insights offre funzionalità di monitoraggio avanzate del contenitore. È possibile monitorare con facilità la disponibilità, le prestazioni e l'utilizzo del contenitore. È anche possibile identificare e diagnosticare rapidamente gli errori nel contenitore.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione ApplicationInsights.

Obbligatoria	Nome	Tipo di dati	Descrizione
No	`InstrumentationKey`	String	Chiave di strumentazione dell'istanza di Application Insights a cui vengono inviati i dati di telemetria per il contenitore. Per altre informazioni, vedere Application Insights per ASP.NET Core. Esempio: `InstrumentationKey=123456789`

Impostazioni Fluentd

Fluentd è un agente di raccolta dati open source per la registrazione unificata. Le impostazioni Fluentd gestiscono la connessione del contenitore a un server Fluentd. Il contenitore include un provider di registrazione di Fluentd che consente al contenitore di scrivere log e, facoltativamente, dati delle metriche in un server di Fluentd.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione Fluentd.

Nome	Tipo di dati	Descrizione
`Host`	Stringa	Indirizzo IP o nome host DNS del server Fluentd.
`Port`	Intero	Porta del server Fluentd. Il valore predefinito è 24224.
`HeartbeatMs`	Intero	Intervallo di heartbeat, espresso in millisecondi. Se prima della scadenza di questo intervallo è non stato inviato alcun traffico dell'evento, viene inviato un heartbeat al server Fluentd. Il valore predefinito è 60000 millisecondi (1 minuto).
`SendBufferSize`	Intero	Spazio di buffer di rete, espresso in byte, allocato per le operazioni di invio. Il valore predefinito è 32768 byte (32 kilobyte).
`TlsConnectionEstablishmentTimeoutMs`	Intero	Timeout, espresso in millisecondi, per stabilire una connessione SSL/TLS con il server Fluentd. Il valore predefinito è 10000 millisecondi (10 secondi). Se `UseTLS` è impostato su false, questo valore viene ignorato.
`UseTLS`	Booleano	Indica se il contenitore deve usare SSL/TLS per comunicare con il server Fluentd. Il valore predefinito è false.

Impostazioni delle credenziali del proxy HTTP

Se è necessario configurare un proxy HTTP per eseguire le richieste in uscita, usare questi due argomenti:

Nome	Tipo di dati	Descrizione
HTTP_PROXY	string	Il proxy da usare, ad esempio, `http://proxy:8888` `<proxy-url>`
HTTP_PROXY_CREDS	string	Tutte le credenziali necessarie per l'autenticazione nel proxy, `username:password`ad esempio . Questo valore deve essere in lettere minuscole.
`<proxy-user>`	string	L'utente per il proxy.
`<proxy-password>`	string	La password associata a `<proxy-user>` per il proxy.

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \

Impostazioni di registrazione

Le impostazioni Logging gestiscono il supporto di registrazione di ASP.NET Core per il contenitore. È possibile usare le stesse impostazioni di configurazione e gli stessi valori per il contenitore che si usano per un'applicazione ASP.NET Core.

I provider di registrazione seguenti sono supportati dal contenitore:

Provider	Scopo
Console	Provider di registrazione `Console` di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Debug	Provider di registrazione `Debug` di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Disco	Provider di registrazione JSON. Questo provider di registrazione scrive i dati di log nel montaggio di output.

Questo comando del contenitore archivia informazioni di registrazione nel formato JSON al montaggio di output:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output

Questo comando del contenitore visualizza informazioni di debug, con il prefisso dbug, durante l'esecuzione del contenitore:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug

Registrazione su disco

Il provider di registrazione Disk supporta le impostazioni di configurazione seguenti:

Nome	Tipo di dati	Descrizione
`Format`	Stringa	Formato di output dei file di log. Nota: per abilitare il provider di registrazione, questo valore deve essere impostato su `json`. Se questo valore viene specificato senza specificare anche un montaggio di output durante la creazione di un'istanza di un contenitore, si verifica un errore.
`MaxFileSize`	Intero	Dimensione massima, espressa in megabyte (MB), di un file di log. Quando la dimensione del file di log corrente corrisponde a questo valore o lo supera, il provider di registrazione avvia un nuovo file di log. Se viene specificato -1, la dimensione del file di log è limitata solo dalla dimensione massima del file del montaggio di output eventualmente presente. Il valore predefinito è 1.

Per altre informazioni sulla configurazione del supporto di registrazione di ASP.NET Core, vedere Registrazione in ASP.NET Core.

Impostazioni del volume

Usare i volumi per leggere e scrivere dati da e verso il contenitore. I volumi sono i preferiti per rendere persistenti i dati generati e usati dai contenitori Docker. È possibile specificare un montaggio di input o un montaggio di output includendo l'opzione volumes e specificando type (binding), source (percorso della cartella) e target (parametro del percorso del file).

Il contenitore document intelligence richiede un volume di input e un volume di output. Il volume di input può essere di sola lettura (ro) ed è necessario per l'accesso ai dati usati per il training e l'assegnazione dei punteggi. Il volume di output deve essere scrivibile e lo si usa per archiviare i modelli e i dati temporanei.

La sintassi esatta del percorso del volume host varia a seconda del sistema operativo host. Inoltre, il percorso del volume del computer host potrebbe non essere accessibile a causa di un conflitto tra le autorizzazioni dell'account del servizio Docker e le autorizzazioni del percorso di montaggio host.

File docker-compose.yml di esempio

Il metodo docker compose viene creato da tre passaggi:

Creare un Dockerfile.
Definire i servizi in un docker-compose.yml in modo che possano essere eseguiti insieme in un ambiente isolato.
Eseguire docker-compose up per avviare ed eseguire i servizi.

Esempio di contenitore singolo

In questo esempio immettere i valori {FORM_RECOGNIZER_ENDPOINT_URI} e {FORM_RECOGNIZER_KEY} per l'istanza del contenitore Layout.

Contenitore di layout

version: "3.9"
services:
  azure-cognitive-service-layout:
    container_name: azure-cognitive-service-layout
    image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - key={FORM_RECOGNIZER_KEY}

    ports:
      - "5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge

Esempio di più contenitori

Contenitori di lettura ricevuta e OCR

In questo esempio immettere i valori {FORM_RECOGNIZER_ENDPOINT_URI} e {FORM_RECOGNIZER_KEY} per il contenitore Ricevuta e i valori {COMPUTER_VISION_ENDPOINT_URI} e {COMPUTER_VISION_KEY} per il contenitore di lettura di Visione artificiale di Azure.

version: "3"
services:
  azure-cognitive-service-receipt:
    container_name: azure-cognitive-service-receipt
    image: cognitiveservicespreview.azurecr.io/microsoft/cognitive-services-form-recognizer-receipt:2.1
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - key={FORM_RECOGNIZER_KEY}
      - AzureCognitiveServiceReadHost=http://azure-cognitive-service-read:5000
    ports:
      - "5000:5050"
    networks:
      - ocrvnet
  azure-cognitive-service-read:
    container_name: azure-cognitive-service-read
    image: mcr.microsoft.com/azure-cognitive-services/vision/read:3.2
    environment:
      - EULA=accept
      - billing={COMPUTER_VISION_ENDPOINT_URI}
      - key={COMPUTER_VISION_KEY}
    networks:
      - ocrvnet

networks:
  ocrvnet:
    driver: bridge

Passaggi successivi

Altre informazioni sull'esecuzione di più contenitori e sul comando docker compose

Ricetta dell'istanza di Contenitore di Azure