Aracılığıyla paylaş


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

Bu içerik şunlar için geçerlidir: Checkmark v3.0 (GA) Checkmark 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. Kapsayıcılar yalnızca kendilerine sağlanan verileri işler ve yalnızca erişim izni verilen kaynakları kullanır. Kapsayıcılar diğer bölgelerdeki verileri işleyemez.

Bu makalede, Belge Yönetim Bilgileri kapsayıcılarını indirmeyi, yüklemeyi ve çalıştırmayı öğrenebilirsiniz. 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, Düzen, Kimlik Belgesi, Makbuz ve Fatura modelleri, Belge Yönetim Bilgileri v3.1 kapsayıcıları tarafından desteklenir.

  • Okuma, Düzen, Genel Belge, Kartvizit ve Özel modeller, Belge Zekası v3.0 kapsayıcıları tarafından desteklenir.

Sürüm desteği

Kapsayıcılar için destek şu anda tüm modeller v3.1 2023-07-31 (GA) ve Okuma, Düzen, Kimlik Belgesi, Makbuz ve Fatura modelleri için Belge Yönetim Bilgileri sürümüyle v3.0: 2022-08-31 (GA) kullanılabilir:

Ö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:

Not

Studio kapsayıcısı Azure Kubernetes Service'te dağıtılamaz ve çalıştırılamaz. Studio kapsayıcısı yalnızca yerel makinede çalıştırılması desteklenir.

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 bir veya daha fazla destekleyici kapsayıcı listelanmaktadır. 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

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.

    Azure portalı anahtarları ve uç nokta sayfasının ekran görüntüsü.

  • Değerin kabul etmek üzere ayarlandığından EULA 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.1
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000:5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge

Şimdi docker compose komutuyla hizmeti başlatabilirsiniz:

docker-compose up

Hizmetin çalıştığını doğrulama

Kapsayıcının çalıştığını doğrulamanın birkaç yolu vardır:

  • Kapsayıcı, kapsayıcının çalıştığı görsel doğrulama olarak adresinde \ bir giriş sayfası sağlar.

  • Sık kullandığınız web tarayıcısını açabilir ve söz konusu kapsayıcının dış IP adresine ve kullanıma sunulan bağlantı noktasına gidebilirsiniz. Kapsayıcının çalıştığını doğrulamak için listelenen istek URL'lerini kullanın. Listelenen örnek istek URL'leri şeklindedir http://localhost:5000, ancak kapsayıcınız farklılık gösterebilir. Kapsayıcınızın Dış IP adresine ve kullanıma sunulan bağlantı noktasına gitmekte olduğunuzu unutmayın.

    İstek URL’si Purpose
    http:// localhost:5000/ Kapsayıcı bir giriş sayfası sağlar.
    http:// localhost:5000/ready GET ile istenen bu istek, kapsayıcının modele yönelik bir sorguyu kabul etmeye hazır olduğunu belirten bir doğrulama sağlar. Bu istek Kubernetes canlılığı ve hazır olma yoklamaları için kullanılabilir.
    http:// localhost:5000/status GET ile istenen bu istek, kapsayıcıyı başlatmak için kullanılan api anahtarının uç nokta sorgusuna neden olmadan geçerli olup olmadığını doğrular. Bu istek Kubernetes canlılığı ve hazır olma yoklamaları için kullanılabilir.
    http:// localhost:5000/swagger Kapsayıcı uç noktalar için tüm belgeleri ve bir de Deneyin özelliği sağlar. Bu özellik sayesinde, ayarlarınızı web tabanlı bir HTML formuna girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu yapabilirsiniz. Sorgu döndürüldikten sonra, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır.

Azure kapsayıcıları karşılama sayfasının ekran görüntüsü.

Kapsayıcıları durdurma

Kapsayıcıları durdurmak için aşağıdaki komutu kullanın:

docker-compose down

Faturalandırma

Belge Yönetim Bilgileri kapsayıcıları, Azure hesabınızda bir Belge Yönetim Bilgileri kaynağı kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular, API Keyiçin kullanılan Azure kaynağının fiyatlandırma katmanında faturalandırılır. Faturalama, belgelerinizi ve görüntülerinizi işlemek için kullanılan her kapsayıcı örneği için hesaplanır.

Şu hatayı alırsanız: Kapsayıcı geçerli durumda değil. Abonelik doğrulaması 'OutOfQuota' API anahtarı kota dışında durumuyla başarısız oldu. Bu, kapsayıcılarınızın faturalama uç noktasıyla iletişim kurmadığını gösteren bir göstergedir.

Azure'a bağlanma

Kapsayıcının çalışması için faturalama bağımsız değişkeni değerleri gerekir. Bu değerler kapsayıcının faturalama uç noktasına bağlanmasına olanak sağlar. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir. Kapsayıcı izin verilen zaman penceresinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder, ancak faturalama uç noktası geri yüklenene kadar sorgular sunmaz. Bağlantı, 10 ile 15 dakika aynı zaman aralığında 10 kez denenir. 10 denemede faturalama uç noktasına bağlanamazsa kapsayıcı isteklerin sunulmasını durdurur. Faturalama için Microsoft'a gönderilen bilgilerin bir örneği için bkz. Azure AI kapsayıcısı hakkında SSS .

Faturalama bağımsız değişkenleri

Docker-compose up komutu, aşağıdaki seçeneklerin üçü de geçerli değerlerle sağlandığında kapsayıcıyı başlatır:

Seçenek Açıklama
ApiKey Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının anahtarı.
Bu seçeneğin değeri, içinde Billingbelirtilen sağlanan kaynak için bir anahtara ayarlanmalıdır.
Billing Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının uç noktası.
Bu seçeneğin değeri, sağlanan bir Azure kaynağının uç nokta URI'sine ayarlanmalıdır.
Eula Kapsayıcının lisansını kabul ettiğinizi gösterir.
Bu seçeneğin değeri kabul edilecek şekilde ayarlanmalıdır.

Bu seçenekler hakkında daha fazla bilgi için bkz . Kapsayıcıları yapılandırma.

Özet

İşte hepsi bu! Bu makalede, Belge Yönetim Bilgileri kapsayıcılarını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışlarını öğrendiniz. Özet olarak:

  • Document Intelligence, Docker için yedi Linux kapsayıcısı sağlar.
  • Kapsayıcı görüntüleri mcr'den indirilir.
  • Kapsayıcı görüntüleri Docker'da çalışır.
  • Bir kapsayıcı örneği oluştururken faturalama bilgileri belirtilmelidir.

Önemli

Azure yapay zeka kapsayıcıları, ölçüm için Azure'a bağlanmadan çalıştırılma lisansına sahip değildir. Müşterilerin, kapsayıcıların faturalama bilgilerini ölçüm hizmetiyle her zaman iletmesini sağlaması gerekir. Azure AI kapsayıcıları müşteri verilerini (örneğin, analiz edilen görüntü veya metin) Microsoft'a göndermez.

Sonraki adımlar