Instal dan menjalankan kontainer

Artikel
01/17/2024

Dukungan untuk kontainer saat ini tersedia dengan versi 2022-08-31 (GA) Kecerdasan Dokumen untuk semua model dan 2023-07-31 (GA) hanya untuk Baca dan Tata Letak:

✔️ Lihat Menginstal dan menjalankan kontainer Kecerdasan Dokumen v3.0 untuk dokumentasi kontainer yang didukung.

Konten ini berlaku untuk:v3.0 (GA)v3.1 (GA)

Azure AI Document Intelligence adalah layanan Azure AI yang memungkinkan Anda membangun perangkat lunak pemrosesan data otomatis menggunakan teknologi pembelajaran mesin. Kecerdasan Dokumen memungkinkan Anda mengidentifikasi dan mengekstrak teks, pasangan kunci/nilai, tanda pilihan, data tabel, dan lainnya dari dokumen Anda. Hasilnya dikirimkan sebagai data terstruktur yang .. /menyertakan hubungan dalam file asli.

Dalam artikel ini Anda mempelajari cara mengunduh, menginstal, dan menjalankan kontainer Kecerdasan Dokumen. Kontainer memungkinkan Anda menjalankan layanan Kecerdasan Dokumen di lingkungan Anda sendiri. Kontainer sangat bagus untuk persyaratan keamanan dan tata kelola data tertentu.

Model Baca, dan Tata Letak didukung oleh kontainer Kecerdasan Dokumen v3.1.
Model Baca, Tata Letak, Dokumen Umum, Dokumen ID, Tanda Terima, Faktur, Kartu Nama, dan Kustom didukung oleh kontainer Kecerdasan Dokumen v3.0.
Model Kartu Nama saat ini hanya didukung dalam kontainer v2.1.

Prasyarat

Untuk memulai, Anda memerlukan akun Azure aktif. Jika Anda tidak memilikinya, Anda dapat membuat akun gratis.

Anda juga memerlukan hal berikut untuk menggunakan kontainer Kecerdasan Dokumen:

Wajib	Tujuan
Keakraban dengan Docker	Anda harus memiliki pemahaman dasar tentang konsep Docker, seperti registri, repositori, kontainer, dan gambar kontainer, serta pengetahuan tentang `docker`terminologi dan perintah dasar.
Docker Engine terinstal	Anda memerlukan Docker Engine yang diinstal pada komputer host. Docker menyediakan paket yang mengonfigurasi lingkungan Docker di macOS, Windows, dan Linux. Untuk primer tentang Docker dan dasar kontainer, lihat Gambaran umum Docker. Docker harus dikonfigurasi agar kontainer dapat terhubung dengan dan mengirim data tagihan ke Azure. Di Windows, Docker juga harus dikonfigurasi agar mendukung kontainer Linux.
Sumber daya Kecerdasan Dokumen	Kecerdasan Dokumen Azure AI layanan tunggal atau sumber daya multi-layanan di portal Azure. Untuk menggunakan kontainer, Anda harus memiliki kunci terkait dan URI titik akhir. Kedua nilai tersedia di halaman portal Azure Kunci Kecerdasan Dokumen dan Titik Akhir: {FORM_RECOGNIZER_KEY}: salah satu dari dua kunci sumber daya yang tersedia. FORM_RECOGNIZER_ENDPOINT_URI: titik akhir untuk sumber daya yang digunakan untuk melacak informasi penagihan.

Opsional	Tujuan
Azure CLI (antarmuka baris perintah)	Azure CLI memungkinkan Anda menggunakan serangkaian perintah online untuk membuat dan mengelola sumber daya Azure. Ini tersedia untuk dipasang di lingkungan Windows, macOS, dan Linux dan dapat dijalankan dalam kontainer Docker dan Azure Cloud Shell.

Persyaratan komputer host

Host adalah komputer berbasis x64 yang menjalankan kontainer Docker. Ini bisa menjadi komputer lokal Anda atau layanan hosting Docker di Azure, seperti:

Azure Kubernetes Service.
Azure Container Instances.
Kluster Kubernetes yang disebarkan ke Azure Stack. Untuk mengetahui informasi selengkapnya, lihat Menyebarkan Kube ke Azure Stack.

Persyaratan dan rekomendasi kontainer

Kontainer pendukung yang diperlukan

Tabel berikut mencantumkan kontainer pendukung untuk setiap kontainer Kecerdasan Dokumen yang Anda unduh. Untuk informasi selengkapnya, lihat bagian Penagihan.

Kontainer fitur	Kontainer pendukung
Baca	Tidak diperlukan
Tata letak	Tidak diperlukan
Kartu Nama	Baca
Dokumen Umum	Tata letak
Faktur	Tata letak
Tanda terima	Baca atau Tata Letak
ID Dokumen	Baca
Templat Kustom	Tata letak

Core dan memori CPU yang direkomendasikan

Catatan

Nilai minimum dan yang direkomendasikan didasarkan pada batas Docker dan bukan sumber daya komputer host.

Kontainer Kecerdasan Dokumen

Kontainer	Minimum	Disarankan
`Read`	`8` core, memori 10 GB	`8` core, memori 24 GB
`Layout`	`8` core, memori 16 GB	`8` core, memori 24 GB
`Business Card`	`8` core, memori 16 GB	`8` core, memori 24 GB
`General Document`	`8` core, memori 12 GB	`8` core, memori 24 GB
`ID Document`	`8` core, memori 8 GB	`8` core, memori 24 GB
`Invoice`	`8` core, memori 16 GB	`8` core, memori 24 GB
`Receipt`	`8` core, memori 11 GB	`8` core, memori 24 GB
`Custom Template`	`8` core, memori 16 GB	`8` core, memori 24 GB

Setiap core harus setidaknya 2,6 gigahertz (GHz) atau lebih cepat.
Inti dan memori sesuai dengan pengaturan --cpus dan --memory, yang digunakan sebagai bagian dari perintah docker compose atau docker run.

Tip

Anda dapat menggunakan perintah gambar docker untuk mencantumkan gambar kontainer yang diunduh. Misalnya, perintah berikut mencantumkan ID, repositori, dan tag dari setiap gambar kontainer yang diunduh, yang diformat sebagai tabel:

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

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

Jalankan kontainer dengan perintah docker-compose up

Ganti nilai {ENDPOINT URL} dan {API KEY} dengan URI Titik Akhir sumber daya Anda dan kunci dari halaman sumber daya Azure.
Pastikan bahwa nilai EULA diatur untuk menerima.
Nilai EULA, Billing, dan ApiKey harus ditentukan; jika tidak, kontainer tidak dapat dimulai.

Penting

Kunci digunakan untuk mengakses sumber daya Kecerdasan Dokumen Anda. Jangan bagikan kunci Anda. Simpan dengan aman, misalnya menggunakan Azure Key Vault. Sebaiknya Anda meregenerasi kunci ini secara rutin. Hanya satu kunci yang diperlukan untuk melakukan panggilan API. Saat membuat ulang kunci pertama, Anda dapat menggunakan kunci kedua untuk akses berkelanjutan ke layanan.

Sampel kode berikut adalah contoh mandiri docker compose untuk menjalankan kontainer Tata Letak Kecerdasan Dokumen. Dengan docker compose, Anda menggunakan file YAML untuk mengonfigurasi layanan aplikasi. Kemudian, dengan docker-compose up perintah , Anda membuat dan memulai semua layanan dari konfigurasi Anda. Masukkan nilai {FORM_RECOGNIZER_ENDPOINT_URI} dan {FORM_RECOGNIZER_KEY} untuk instans kontainer Tata Letak Anda.

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