Configurar contêineres de Document Intelligence

O suporte para contêineres está atualmente disponível com a versão 2022-08-31 (GA) Document Intelligence para todos os modelos e 2023-07-31 (GA) para os modelos de Documento de Leitura, Layout, Fatura, Recibo e ID:

• API REST 2022-08-31 (GA)
• API REST 2023-07-31 (GA)
• Segmentação de bibliotecas de clientes REST API 2022-08-31 (GA)
• Segmentação de bibliotecas de clientes REST API 2023-07-31 (GA)

✔️ Consulte Configurar contêineres do Document Intelligence v3.0 para obter a documentação de contêiner suportada.

Este conteúdo aplica-se a: v3.0 (GA) v3.1 (GA)

Com os contêineres de Document Intelligence, você pode criar uma arquitetura de aplicativo otimizada para aproveitar os recursos robustos da nuvem e a localidade de borda. Os contêineres fornecem um ambiente minimalista e isolado que pode ser facilmente implantado no local e na nuvem. Neste artigo, mostramos como configurar o ambiente de tempo de execução do contêiner do Document Intelligence usando os argumentos de docker compose comando. Os recursos de Document Intelligence são suportados por sete contêineres de recursos de Document Intelligence — Leitura, Layout, Cartão de Visita, Documento de ID, Recibo, Fatura, Personalizado. Esses contêineres têm configurações obrigatórias e opcionais. Para obter alguns exemplos, consulte a seção Exemplo docker-compose.yml arquivo .

Definições de configuração

Cada contêiner tem as seguintes definições de configuração:

Definição de configuração de chave e faturamento

A Key configuração especifica a chave de recurso do Azure que é usada para controlar as informações de cobrança do contêiner. O valor da chave deve ser uma chave válida para o recurso especificado Billing na seção "Definição de configuração de faturamento".

A Billing configuração especifica o URI do ponto de extremidade do recurso no Azure que é usado para medir as informações de cobrança do contêiner. O valor para essa definição de configuração deve ser um URI de ponto de extremidade válido para um recurso no Azure. O contêiner relata o uso a cada 10 a 15 minutos.

Você pode encontrar essas configurações no portal do Azure na página Chaves e Ponto de Extremidade .

EULA Cenário

A Eula configuração indica que você aceitou a licença para o contêiner. Você deve especificar um valor para essa definição de configuração e o valor deve ser definido como accept.

Os contêineres de serviços de IA do Azure são licenciados sob seu contrato que rege seu uso do Azure. Se não tiver um contrato existente que regule a sua utilização do Azure, concorda que o seu contrato que rege a utilização do Azure é o Contrato de Subscrição Online da Microsoft, que incorpora os Termos dos Serviços Online. Para visualizações, você também concorda com os Termos de Uso Suplementares para Visualizações do Microsoft Azure. Ao usar o contêiner, você concorda com estes termos.

Configuração do ApplicationInsights

A ApplicationInsights configuração permite que você adicione suporte à telemetria do Azure Application Insights ao seu contêiner. O Application Insights fornece monitoramento detalhado do seu contêiner. Você pode facilmente monitorar seu contêiner quanto à disponibilidade, desempenho e uso. Você também pode identificar e diagnosticar rapidamente erros em seu contêiner.

A tabela a seguir descreve as definições de configuração suportadas ApplicationInsights na seção .

Configurações fluentes

Fluentd é um coletor de dados de código aberto para registro em log unificado. As Fluentd configurações gerenciam a conexão do contêiner com um servidor Fluentd . O contêiner inclui um provedor de registro em log Fluentd, que permite que seu contêiner grave logs e, opcionalmente, dados métricos em um servidor Fluentd.

A tabela a seguir descreve as definições de configuração suportadas Fluentd na seção .

Configurações de credenciais de proxy HTTP

Se você precisar configurar um proxy HTTP para fazer solicitações de saída, use estes dois argumentos:

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> \

Definições de registo

As Logging configurações gerenciam ASP.NET suporte de log principal para seu contêiner. Você pode usar as mesmas definições de configuração e valores para seu contêiner que você usa para um aplicativo ASP.NET Core.

Os seguintes provedores de log são suportados pelo contêiner:

Este comando container armazena informações de log no formato JSON para a montagem de saída:

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

Este comando container mostra informações de depuração, prefixadas com dbug, enquanto o contêiner está em execução:

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

Registo de discos

O Disk provedor de log suporta as seguintes definições de configuração:

Para obter mais informações sobre como configurar ASP.NET suporte ao log principal, consulte Configuração do arquivo de configurações.

Configurações de volume

Use volumes para ler e gravar dados de e para o contêiner. Os volumes são os preferidos para dados persistentes gerados e usados por contêineres do Docker. Você pode especificar uma montagem de entrada ou uma montagem de saída incluindo a volumes opção e especificando type (bind), source (caminho para a pasta) e target (parâmetro de caminho de arquivo).

O contêiner Document Intelligence requer um volume de entrada e um volume de saída. O volume de entrada pode ser somente leitura (ro) e é necessário para acessar os dados usados para treinamento e pontuação. O volume de saída deve ser gravável e você usá-lo para armazenar os modelos e dados temporários.

A sintaxe exata do local do volume do host varia dependendo do sistema operacional do host. Além disso, o local do volume do computador host pode não estar acessível devido a um conflito entre as permissões da conta de serviço do Docker e as permissões do local de montagem do host.

Exemplo docker-compose.yml arquivo

O método de composição docker é construído a partir de três etapas:

1. Crie um Dockerfile.
2. Defina os serviços em um docker-compose.yml para que possam ser executados juntos em um ambiente isolado.
3. Execute docker-compose up para iniciar e executar seus serviços.

Exemplo de contêiner único

Neste exemplo, insira os valores {FORM_RECOGNIZER_ENDPOINT_URI} e {FORM_RECOGNIZER_KEY} para sua instância de contêiner Layout.

Contêiner de 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

Exemplo de vários contêineres

Recipientes de recebimento e leitura de OCR

Neste exemplo, insira os valores {FORM_RECOGNIZER_ENDPOINT_URI} e {FORM_RECOGNIZER_KEY} para o contêiner Recibo e os valores {COMPUTER_VISION_ENDPOINT_URI} e {COMPUTER_VISION_KEY} para o contêiner Azure AI Vision Read.

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

Próximos passos

• Receita de instância de contêiner do Azure