Configurare contenitori di Informazioni sui documenti

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) per i modelli lettura, layout, fattura, ricevuta e documento ID:

• API REST2022-08-31 (GA)
• API REST2023-07-31 (GA)
• Destinazione delle librerie client REST API 2022-08-31 (GA)
• Destinazione delle librerie client REST API 2023-07-31 (GA)

✔️ Vedere Configurare contenitori di Informazioni sui documenti v3.0 per la documentazione dei contenitori supportati.

Questo contenuto si applica a: v3.0 (disponibilità generale) v3.1 (disponibilità generale)

I contenitori di Informazioni sui documenti consentono di creare un'architettura per le applicazioni ottimizzata per sfruttare i vantaggi delle funzionalità cloud avanzate e della posizione fisica dei dispositivi perimetrali. 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 dei contenitori di Informazioni sui documenti usando gli argomenti del comando docker compose. Le funzionalità di Informazioni sui documenti sono supportate da sette contenitori di funzionalità di Informazioni sui documenti: Lettura, Layout, Biglietto da visita, Documento di identità, Ricevuta, Fattura e Personalizzato. Questi contenitori prevedono impostazioni sia obbligatorie che facoltative. Per alcuni esempi, vedere la sezione File docker-compose.yml di esempio.

Impostazioni di configurazione

Le impostazioni di configurazione di ogni contenitore sono le seguenti:

Impostazione di configurazione Key e Billing

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

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

È possibile trovare queste impostazioni nella pagina Chiavi ed endpoint del portale di Azure.

Impostazione di EULA

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.

I contenitori di Servizi di Azure AI sono concessi in licenza in base al contratto che disciplina 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.

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.

Impostazioni delle credenziali del proxy HTTP

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

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:

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:

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

Impostazioni dei volumi

Usare i volumi per leggere e scrivere dati da e verso il contenitore. I volumi sono gli elementi 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 di Informazioni sui documenti richiede un volume di input e un volume di output. Il volume di input può essere di sola lettura (ro) ed è necessario per accedere ai dati usati per il training e l'assegnazione di punteggi. Il volume di output deve essere accessibile in scrittura e viene usato per archiviare i modelli e i dati temporanei.

La sintassi esatta della posizione del volume host varia a seconda del sistema operativo host. Inoltre, la posizione 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 della posizione di montaggio dell'host.

File docker-compose.yml di esempio

Il metodo docker compose viene creato in tre passaggi:

1. Creare un Dockerfile.
2. Definire i servizi in un file docker-compose.yml in modo che possano essere eseguiti insieme in un ambiente isolato.
3. 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 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 Ricevuta e Lettura 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 Lettura di Visione di Azure AI.

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

• Procedura per l'istanza di contenitore di Azure