Form Tanıma v2.1 kapsayıcılarını yükleme ve çalıştırma

Bu makale:Form Tanıma v2.1 onay işaretiForm Tanıma v2.1 için geçerlidir.

Azure Form Tanıma, makine öğrenmesi teknolojisini kullanarak otomatik veri işleme yazılımı oluşturmanıza olanak tanıyan bir Azure Uygulamalı Yapay Zeka Hizmetidir. Form Tanıma form belgelerinizden 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çeren yapılandırılmış veriler olarak teslim edilir.

Bu makalede, Form Tanıma kapsayıcıları indirmeyi, yüklemeyi ve çalıştırmayı öğreneceksiniz. Kapsayıcılar, Form Tanıma hizmetini kendi ortamınızda çalıştırmanızı sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır. Form Tanıma özellikleri altı Form Tanıma özellik kapsayıcısı tarafından desteklenir: Düzen, Kartvizit, Kimlik Belgesi, Makbuz, Fatura ve Özel (Makbuz, Kartvizit ve Kimlik Belgesi kapsayıcıları için de Okuma OCR kapsayıcısı gerekir).

Önemli

Önkoşullar

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

Form Tanıma kapsayıcılarını kullanmak için de aşağıdakilere ihtiyacınız olacaktır:

Gerekli Amaç
Docker hakkında bilgi Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Temel Docker kavramlarının yanı sıra temel dockerterminoloji ve komutlar hakkında bilgi sahibi olmanız gerekir.
Docker Altyapısı yüklü
  • Docker Altyapısı'nın bir konak 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.
Form Tanıma kaynağı Azure portal tek hizmetli bir Azure Form Tanıma veya çok hizmetli Bilişsel Hizmetler kaynağı. 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 Form Tanıma 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ı.
API kaynağını Görüntü İşleme Kartvizitleri, kimlik belgelerini veya Makbuzları işlemek için bir Görüntü İşleme kaynağı gerekir.
  • Metni Tanıma özelliğine Azure kaynağı (REST API veya SDK) veya bilişsel hizmetler-tanıma metinkapsayıcısı olarak erişebilirsiniz. Normal faturalama ücretleri geçerlidir.
  • Bilişsel-hizmetler-tanıma-metin kapsayıcısını kullanıyorsanız, Form Tanıma kapsayıcısı için Görüntü İşleme anahtarınızın bilişsel hizmetler-tanıma-metin kapsayıcısı için Görüntü İşleme docker run veya docker compose komutta belirtilen anahtar olduğundan ve faturalama uç noktanızın kapsayıcının uç noktası (örneğin, http://localhost:5000) olduğundan emin olun. Aynı konakta hem Görüntü İşleme kapsayıcısını hem de Form Tanıma kapsayıcıyı birlikte kullanırsanız, ikisi de varsayılan 5000 bağlantı noktasıyla başlatılamaz.

Görüntü İşleme Azure bulutunuzun veya Bilişsel Hizmetler kapsayıcınızın hem anahtarını hem de uç noktalarını geçirin:
  • {COMPUTER_VISION_KEY}: kullanılabilir iki kaynak anahtarından biri.
  • {COMPUTER_VISION_ENDPOINT_URI}: Faturalama bilgilerini izlemek için kullanılan kaynağın uç noktası.
İsteğe Bağlı Amaç
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 çalıştırılabilir.

Kapsayıcıyı çalıştırmak için onay isteme

Kapsayıcıya erişim istemek için Geçitli Hizmetler için Azure Bilişsel Hizmetler Uygulamasını tamamlayın ve gönderin.

Form, siz, şirketiniz ve kapsayıcıyı kullanacağınız kullanıcı senaryosu hakkında bilgi istemektedir. Formu gönderdikten sonra Azure Bilişsel Hizmetler ekibi formu inceler ve 10 iş günü içinde size bir karar e-posta ile gönderir.

Önemli

  • Formda, Azure abonelik kimliğiyle ilişkilendirilmiş bir e-posta adresi kullanmanız gerekir.
  • Kapsayıcıyı çalıştırmak için kullandığınız Azure kaynağının onaylı Azure abonelik kimliğiyle oluşturulmuş olması gerekir.
  • Microsoft'tan uygulamanızın durumuyla ilgili güncelleştirmeler için e-postanızı (gelen kutusu ve gereksiz klasörler) denetleyin.

Onayladıktan sonra, kapsayıcıyı makalenin ilerleyen bölümlerinde açıklanan Microsoft Container Registry'den (MCR) indirdikten sonra çalıştırabilirsiniz.

Azure aboneliğiniz onaylanmamışsa kapsayıcıyı çalıştıramazsınız.

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:

Kapsayıcı gereksinimleri ve önerileri

Gerekli destekleyici kapsayıcılar

Aşağıdaki tabloda, indirdiğiniz her Form Tanıma kapsayıcı 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
Düzen Hiçbiri
Kartvizit okuma Görüntü İşleme
Kimlik Belgesi okuma Görüntü İşleme
Fatura Düzen
Makbuz okuma Görüntü İşleme
Özel Özel API, Özel Denetimli, Düzen

Not

En düşük ve önerilen değerler, konak makine kaynaklarını değil Docker sınırlarını temel alır.

Okuma, Düzen ve Önceden Oluşturulmuş kapsayıcılar
Kapsayıcı Minimum Önerilen
Okuma 3.2 8 çekirdekler, 16 GB bellek 8 çekirdekler, 24 GB bellek
Düzen 2.1 8 çekirdekler, 16 GB bellek 8 çekirdekler, 24 GB bellek
Kartvizit 2.1 2 çekirdekler, 4 GB bellek 4 çekirdekler, 4 GB bellek
Kimlik Belgesi 2.1 1 çekirdek, 2 GB bellek 2 çekirdekler, 2 GB bellek
Fatura 2.1 4 çekirdekler, 8 GB bellek 8 çekirdekler, 8 GB bellek
Makbuz 2.1 4 çekirdekler, 8 GB bellek 8 çekirdekler, 8 GB bellek
Özel kapsayıcılar

İstekleri eğitmek ve analiz etmek için aşağıdaki konak makine gereksinimleri geçerlidir:

Kapsayıcı Minimum Önerilen
Özel API 0,5 çekirdek, 0,5 GB bellek 1 çekirdek, 1 GB bellek
Özel Denetimli 4 çekirdekler, 2 GB bellek 8 çekirdekler, 4 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

İndirilen kapsayıcı görüntülerinizi 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.

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

  • EULA değerinin "accept" olarak ayarlandığından emin olun.

  • EULA, Billingve Key değerleri belirtilmelidir; aksi takdirde kapsayıcı başlatılmaz.

Önemli

Anahtarlar Form Tanıma 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. Ayrıca bu anahtarları düzenli olarak yeniden oluşturmanızı öneririz. API çağrısı yapmak için yalnızca bir anahtar gereklidir. İlk anahtarı yeniden oluştururken hizmete sürekli erişim için ikinci anahtarı kullanabilirsiniz.

Aşağıdaki kod örneği, Form Tanıma 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-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}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge

Şimdi docker compose komutuyla hizmeti başlatabilirsiniz:

docker-compose up

Örnek Etiketleme aracı ve Azure Container Instances (ACI)

Azure Container Instance ile Örnek Etiketleme aracını kullanmayı öğrenmek için bkz. Örnek Etiketleme aracını dağıtma.

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ığına ilişkin görsel doğrulama olarak adresinde \ bir giriş sayfası sağlar.

  • Sık kullandığınız web tarayıcısını açıp dış IP adresine ve söz konusu kapsayıcının 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 gidildiğini unutmayın.

    İstek URL’si Amaç
    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ğuna ilişkin 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ürdüğünde, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır.

Ekran görüntüsü: Azure kapsayıcısı karşılama sayfası.

Kapsayıcıları durdurma

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

docker-compose down

Faturalandırma

Form Tanıma kapsayıcıları, Azure hesabınızdaki bir Form Tanıma kaynağı kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular için kullanılan Azure kaynağının fiyatlandırma katmanında Keyfaturalandırılır. Belgelerinizi ve görüntülerinizi işlemek için kullanılan her kapsayıcı örneği için faturalandırılırsınız. Bu nedenle kartvizit özelliğini kullanırsanız Form Tanıma BusinessCard ve Computer Vision Read kapsayıcı örnekleri için faturalandırılırsınız. Fatura özelliği için Form Tanıma Invoice ve Layout kapsayıcı örnekleri için faturalandırılırsınız. Bkz. Okuma özelliği kapsayıcısı fiyatlandırmasını Form Tanıma ve Görüntü İşleme.

Azure Bilişsel Hizmetler kapsayıcıları, ölçüm/faturalama uç noktasına bağlanmadan çalıştırılma lisansına sahip değildir. Faturalama bilgilerini her zaman faturalama uç noktasıyla iletişim kurmak için kapsayıcıların etkinleştirilmesi gerekir. Bilişsel Hizmetler kapsayıcıları, analiz edilen görüntü veya metin gibi müşteri verilerini Microsoft'a göndermez.

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 penceresi içinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder, ancak faturalama uç noktası geri yüklenene kadar sorgu 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. Bilişsel Hizmetler 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
Key Faturalama bilgilerini izlemek için kullanılan Bilişsel Hizmetler 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 Bilişsel Hizmetler 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 bu kadar! Bu makalede, Form Tanıma kapsayıcılarını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışlarını öğrendiniz. Özet:

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

Önemli

Bilişsel Hizmetler 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. Bilişsel Hizmetler kapsayıcıları müşteri verilerini (örneğin, analiz edilen görüntü veya metin) Microsoft'a göndermez.

Sonraki adımlar