Kapsayıcıları yükleme ve çalıştırma

Makale
01/17/2024

Kapsayıcılar için destek şu anda tüm modeller için Belge Yönetim Bilgileri sürümüyle 2022-08-31 (GA) ve 2023-07-31 (GA) yalnızca Okuma ve Düzen için kullanılabilir:

✔️ Desteklenen kapsayıcı belgeleri için bkz . Document Intelligence v3.0 kapsayıcılarını yükleme ve çalıştırma.

Bu içerik şunlar için geçerlidir: v3.0 (GA)v3.1 (GA)

Azure AI Belge Zekası, makine öğrenmesi teknolojisini kullanarak otomatik veri işleme yazılımı oluşturmanıza olanak tanıyan bir Azure yapay zeka hizmetidir. Belge Zekası, belgelerinizdeki metinleri, anahtar/değer çiftlerini, seçim işaretlerini, tablo verilerini ve daha fazlasını tanımlamanızı ve ayıklamanızı sağlar. Sonuçlar, .. /, özgün dosyadaki ilişkileri içerir.

Bu makalede, Belge Yönetim Bilgileri kapsayıcılarını indirmeyi, yüklemeyi ve çalıştırmayı öğreneceksiniz. Kapsayıcılar, Belge Yönetim Bilgileri hizmetini kendi ortamınızda çalıştırmanıza olanak tanır. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır.

Okuma ve Düzen modelleri, Belge Zekası v3.1 kapsayıcıları tarafından desteklenir.
Okuma, Düzen, Genel Belge, Kimlik Belgesi, Makbuz, Fatura, Kartvizit ve Özel modeller, Belge Yönetim Bilgileri v3.0 kapsayıcıları tarafından desteklenir.
Kartvizit modeli şu anda yalnızca v2.1 kapsayıcılarında desteklenmektedir.

Önkoşullar

Başlamak için etkin bir Azure hesabınız olmalıdır. Hesabınız yoksa ücretsiz bir hesap oluşturabilirsiniz.

Ayrıca, Belge Yönetim Bilgileri kapsayıcılarını kullanmak için aşağıdakilere de ihtiyacınız vardır:

Zorunlu	Purpose
Docker hakkında bilgi	Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel `docker`terminoloji ve komutlar hakkında bilgi sahibi olmanız gerekir.
Docker Altyapısı yüklü	Docker Altyapısı'nın bir ana bilgisayarda yüklü olması gerekir. Docker, macOS, Windows ve Linux üzerinde Docker ortamını yapılandıran paketler sağlar. Docker ve kapsayıcı temel bilgileri ile ilgili giriş yapmak için Docker’a genel bakış bölümüne bakın. Docker, kapsayıcıların Azure'a bağlanmasına ve faturalama verileri göndermesine izin verecek şekilde yapılandırılmalıdır. Windows'da Docker,Linux kapsayıcılarını destekleyecek şekilde de yapılandırılmalıdır.
Belge Yönetim Bilgileri kaynağı	Azure portalında tek hizmetli bir Azure AI Belge Zekası veya çok hizmetli kaynak. Kapsayıcıları kullanmak için ilişkili anahtara ve uç nokta URI'sine sahip olmanız gerekir. Her iki değer de Azure portalı Belge Yönetim Bilgileri Anahtarları ve Uç Nokta sayfasında bulunur: {FORM_RECOGNIZER_KEY}: kullanılabilir iki kaynak anahtarından biri. {FORM_RECOGNIZER_ENDPOINT_URI}: Faturalama bilgilerini izlemek için kullanılan kaynağın uç noktası.

İsteğe bağlı	Purpose
Azure CLI (komut satırı arabirimi)	Azure CLI, Azure kaynaklarını oluşturmak ve yönetmek için bir dizi çevrimiçi komut kullanmanıza olanak tanır. Windows, macOS ve Linux ortamlarında yüklenebilir ve Docker kapsayıcısında ve Azure Cloud Shell'de çalıştırılabilir.

Konak bilgisayar gereksinimleri

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'da Docker barındırma hizmeti olabilir, örneğin:

Azure Kubernetes Service.
Azure Container Instances.
Azure Stack'e dağıtılan bir Kubernetes kümesi. Daha fazla bilgi için bkz . Kubernetes'i Azure Stack'e dağıtma.

Kapsayıcı gereksinimleri ve önerileri

Gerekli destekleyici kapsayıcılar

Aşağıdaki tabloda, indirdiğiniz her Belge Yönetim Bilgileri kapsayıcısı için destekleyici kapsayıcılar listeleniyor. Daha fazla bilgi için Faturalama bölümüne bakın.

Özellik kapsayıcısı	Destekleyici kapsayıcılar
Okuma	Gerekli değil
Düzen	Gerekli değil
Kartvizit	Okuma
Genel Belge	Düzen
Fatura	Düzen
Makbuz	Okuma veya Düzen
Kimlik Belgesi	Okuma
Özel Şablon	Düzen

Önerilen CPU çekirdekleri ve bellek

Not

En düşük ve önerilen değerler konak makine kaynaklarına değil Docker sınırlarına bağlıdır.

Belge Yönetim Bilgileri kapsayıcıları

Kapsayıcı	En Küçük	Önerilen
`Read`	`8` çekirdekler, 10 GB bellek	`8` çekirdekler, 24 GB bellek
`Layout`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek
`Business Card`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek
`General Document`	`8` çekirdekler, 12 GB bellek	`8` çekirdekler, 24 GB bellek
`ID Document`	`8` çekirdekler, 8 GB bellek	`8` çekirdekler, 24 GB bellek
`Invoice`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek
`Receipt`	`8` çekirdekler, 11 GB bellek	`8` çekirdekler, 24 GB bellek
`Custom Template`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek

Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.
Çekirdek ve bellek, veya docker run komutunun --cpus bir parçası olarak kullanılan ve --memory ayarlarına docker compose karşılık gelir.

İpucu

İndirdiğiniz kapsayıcı görüntülerini listelemek için docker images komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut indirilen her kapsayıcı görüntüsünün kimliğini, deposunu ve etiketini tablo olarak biçimlendirilmiş olarak listeler:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Docker-compose up komutuyla kapsayıcıyı çalıştırma

{ENDPOINT_URI} ve {API_KEY} değerlerini kaynak Uç Nokta URI'nizle ve Azure kaynak sayfasındaki anahtarla değiştirin.
EULA değerinin kabul etmek üzere ayarlandığından emin olun.
EULA, Billingve ApiKey değerleri belirtilmelidir; aksi takdirde kapsayıcı başlatılamaz.

Önemli

Anahtarlar, Belge Yönetim Bilgileri kaynağınıza erişmek için kullanılır. Anahtarlarınızı paylaşmayın. Bunları, örneğin Azure Key Vault kullanarak güvenli bir şekilde depolayın. Bu anahtarları düzenli olarak yeniden oluşturmanızı öneririz. API çağrısı yapmak için yalnızca bir anahtar gerekir. İlk anahtarı yeniden oluştururken hizmete sürekli olarak erişebilmek için ikinci anahtarı kullanabilirsiniz.

Aşağıdaki kod örneği, Belge Yönetim Bilgileri Düzeni kapsayıcısını çalıştırmak için bağımsız docker compose bir örnektir. ile docker compose, uygulamanızın hizmetlerini yapılandırmak için bir YAML dosyası kullanırsınız. Ardından komutuyla docker-compose up tüm hizmetleri yapılandırmanızdan oluşturup başlatırsınız. Düzen kapsayıcı örneğiniz için {FORM_RECOGNIZER_ENDPOINT_URI} ve {FORM_RECOGNIZER_KEY} değerlerini girin.

version: "3.9"
services:
  azure-form-recognizer-read:
    container_name: azure-form-recognizer-read
    image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/read-3.0
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000:5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge