Share via

Azure AI Çeviri kapsayıcısı yükleme ve çalıştırma

  • Makale

Kapsayıcılar, Azure AI Çeviri API'sini kendi altyapınızda barındırmanıza olanak tanır. Kapsayıcı görüntüsü, bir uygulamayı herhangi bir özel, genel veya kişisel bilgi işlem ortamında tutarlı bir şekilde çalıştırmak için gereken tüm kitaplıkları, araçları ve bağımlılıkları içerir. Azure AI Çeviri API'sini uzaktan çağırarak güvenlik veya veri idare gereksinimleriniz karşılanamazsa kapsayıcılar iyi bir seçenektir.

Bu makalede, Docker API ile Çeviri kapsayıcısını çevrimiçi olarak yüklemeyi ve çalıştırmayı öğrenin. Azure AI Çeviri kapsayıcısı aşağıdaki işlemleri destekler:

  • Metin Çevirisi. Sözcüklerin veya tümceciklerin bağlamsal anlamını desteklenen sourcetarget dilden gerçek zamanlı olarak çevirin. Daha fazla bilgi için bkz. Kapsayıcı: metni çevirme.

  • 🆕 Metin Çevirisi. Metni bir dil betiğinden veya yazma sisteminden başka bir dil betiğine veya yazma sistemine gerçek zamanlı olarak dönüştürün. Daha fazla bilgi için bkz. Container: transliterate text.

  • 🆕 Belge çevirisi (önizleme). Yapıyı ve biçimi gerçek zamanlı olarak korurken belgeleri zaman uyumlu bir şekilde çevirin. Daha fazla bilgi için bkz. Container:translate documents.

Önkoşullar

Başlamak için aşağıdaki kaynaklara, geçitli erişim onayına ve araçlara ihtiyacınız vardır:

Azure kaynakları

  • Etkin bir Azure aboneliği. Hesabınız yoksa 12 aylık ücretsiz bir hesap oluşturabilirsiniz.

  • Çeviri bağlı bir kapsayıcıya veya bağlantısı kesilmiş Çeviri kapsayıcıya onaylanan erişim isteği.

  • Onaylanan abonelik kimliği altında oluşturulmuş bir Azure AI Çeviri kaynağı (çok hizmetli bir Azure AI hizmetleri kaynağı değil). Kaynağınızla ilişkili API anahtarına ve uç nokta URI'sine ihtiyacınız vardır. Kapsayıcıyı başlatmak için her iki değer de gereklidir ve Azure portalındaki kaynağa genel bakış sayfasında bulunabilir.

    • bağlı Çeviri kapsayıcılar için fiyatlandırma katmanını S1 seçin.

      Bağlı Çeviri kapsayıcı için fiyatlandırma katmanı seçiminin ekran görüntüsü.

    • Bağlantısı kesilmiş Çeviri kapsayıcılar için fiyatlandırma katmanı olarak öğesini seçinCommitment tier disconnected containers. Yalnızca bağlantısı kesilmiş kapsayıcı erişim isteğiniz onaylandıysa taahhüt katmanı satın alma seçeneğini görürsünüz.

      Azure portalında kaynak oluşturmayı gösteren ekran görüntüsü.

Docker araçları

Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel dockerterminoloji ve komutlar hakkında bilgi sahibi olmanız gerekir. Docker ve kapsayıcı temel bilgileri ile ilgili giriş yapmak için Docker’a genel bakış bölümüne bakın.

İpucu

Bilgi işlem ortamınıza Docker Desktop eklemeyi göz önünde bulundurun. Docker Desktop, kapsayıcılı uygulamaları doğrudan masaüstünüzden oluşturmanıza, çalıştırmanıza ve paylaşmanıza olanak tanıyan bir grafik kullanıcı arabirimidir (GUI).

DockerDesktop Docker Altyapısı, Docker CLI istemcisi, Docker Compose içerir ve Docker'ı tercih ettiğiniz işletim sistemi için yapılandıran paketler sağlar:

Araç Açıklama Koşul
Docker Altyapısı Docker Altyapısı, Docker kapsayıcılama platformunun temel bileşenidir. Kapsayıcılarınızı oluşturmanızı, çalıştırmanızı ve yönetmenizi sağlamak için bir konak bilgisayara yüklenmelidir. Tüm işlemler için gereklidir .
Docker Compose Docker Compose aracı, çok kapsayıcılı uygulamaları tanımlamak ve çalıştırmak için kullanılır. Kapsayıcıları desteklemek için gereklidir.
Docker CLI Docker komut satırı arabirimi Docker Altyapısı ile etkileşim kurmanızı ve Docker kapsayıcılarını doğrudan yerel makinenizden yönetmenizi sağlar. Önerilir
Konak bilgisayar gereksinimleri

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'daki şu Docker barındırma hizmetlerinden biri olabilir:

İşletim Sistemi Sistem gereksinimleri
Windows • Windows 10 veya Windows 11 yüklü
• 64 bit işlemci
• En az 4 GB RAM
• Windows Hyper-V ve Kapsayıcı özellikleri ve BIOS düzeyinde donanım sanallaştırma
• Daha fazla bilgi için bkz. Docker Desktop'ı Windows'a yükleme
Mac • 2010 bilgisayar modeli veya üzeri
• İşletim sistemi 10.13 veya üzeri
• En az 4 GB RAM
• Daha fazla bilgi için bkz. Mac'te Docker Desktop'ı yükleme
Linux • Ubuntu'nun 64 bit sürümü (en son LTS (uzun vadeli destek) sürümü veya mevcut LTS olmayan sürüm), Debian 12, Fedora 38 veya Fedora 39
• Sanallaştırma için CPU desteği
• En az 4 GB RAM
• Daha fazla bilgi için bkz. Docker Desktop'ı Linux'a yükleme

Not

Minimum ve önerilen belirtimler konak makine kaynaklarını değil Docker sınırlarını temel alır.

Aşağıdaki tabloda, her kapsayıcı için en düşük ve önerilen belirtimler ile saniye başına izin verilen İşlemler (TPS) açıklanmaktadır.

İşlev Önerilen en düşük değer Notlar
Metin çevirisi 4 Çekirdek, 4 GB bellek
Metin çevirisi 4 Çekirdek, 2 GB bellek
Belge çevirisi 4 Çekirdek, 6 GB bellek Eşzamanlı olarak işlenebilen belge sayısı şu formülle hesaplanabilir: [en az (n-2), (m-6)/4)].
• n CPU çekirdeği sayısıdır.
• m GB bellektir.
• Örnek: 8 Çekirdek, 32 GB bellek altı (6) eşzamanlı belgeyi işleyebilir [en az (8-2), (36-6)/4)].

  • Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.

  • Her dil çifti için 2 GB bellek önerilir.

  • Temel gereksinimlere ek olarak, her eşzamanlı belge işleme için 4 GB bellek.

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

Gerekli giriş

Tüm Azure AI kapsayıcıları aşağıdaki giriş değerlerini gerektirir:

  • EULA kabul ayarı. değeriyle Eula=acceptayarlanmış bir son kullanıcı lisans sözleşmeniz (EULA) olmalıdır.

  • API anahtarı ve Uç Nokta URL'si. API anahtarı kapsayıcıyı başlatmak için kullanılır. Azure AI Çeviri kaynak Anahtarları ve Uç Nokta sayfanıza gidip simgeyi seçerek API anahtarı ve Uç Nokta URL'si Copy to clipboard değerlerini alabilirsiniz.

  • Belgeleri çeviriyorsanız, belge çevirisi uç noktasını kullandığınızdan emin olun.

Önemli

  • Anahtarlar, Azure AI 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.

Faturalandırma

  • Kapsayıcıya yönelik sorgular, API Keyiçin kullanılan Azure kaynağının fiyatlandırma katmanında faturalandı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.

  • Docker run komutu Microsoft Yapıt Kayıt Defteri'dan bir görüntü indirir ve 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.

Azure'a Bağlan

  • Kapsayıcı faturalama bağımsız değişkeni değerleri, kapsayıcının faturalama uç noktasına bağlanmasına ve çalıştırılması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.

  • 10 ile 15 dakika aynı zaman aralığında 10 kez bağlantı 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 .

Kapsayıcı görüntüleri ve etiketleri

Azure AI hizmetleri kapsayıcı görüntüleri Microsoft Yapıt Kayıt Defteri kataloğunda bulunabilir. Azure AI Çeviri kapsayıcısı azure-cognitive-services/translator deposunda bulunur ve olarak adlandırılırtext-translation. Tam kapsayıcı görüntüsü adıdır mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest.

Kapsayıcının en son sürümünü kullanmak için en son etiketi kullanın. MCR'de Azure AI hizmetlerinin Metin Çevirisi sürüm etiketlerinin tam listesini görüntüleyebilirsiniz.

Kapsayıcıları kullanma

Azure AI Çeviri kapsayıcı ortamınızı seçmek için bir sekme seçin:

Azure AI Çeviri kapsayıcıları, Azure AI Çeviri hizmetini on-premise kendi ortamınızda çalıştırmanıza olanak tanır. Bağlan kapsayıcılar yerel olarak çalışır ve kullanım bilgilerini faturalama için buluta gönderir.

Kapsayıcı görüntüsünü indirme ve çalıştırma

Docker run komutu Microsoft Yapıt Kayıt Defteri'dan bir görüntü indirir ve kapsayıcıyı başlatır.

Önemli

  • Aşağıdaki bölümlerde yer alan docker komutları, \satır devamlılığı karakteri olarak ters eğik çizgi kullanır. Bunu konak işletim sisteminizin gereksinimlerine göre değiştirin veya kaldırın.
  • Kapsayıcıyı EULAçalıştırmak için , Billingve ApiKey seçenekleri belirtilmelidir; aksi takdirde kapsayıcı başlatılmaz.
  • Belgeleri çeviriyorsanız, belge çevirisi uç noktasını kullandığınızdan emin olun.
docker run --rm -it -p 5000:5000 --memory 12g --cpus 4 \
-v /mnt/d/TranslatorContainer:/usr/local/models \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru  \
mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest

Yukarıdaki komut:

  • İndirilen bir kapsayıcı görüntüsünden çalışan bir Çeviri kapsayıcısı oluşturur.
  • 12 gigabayt (GB) bellek ve dört CPU çekirdeği ayırır.
  • İletim denetimi protokolü (TCP) bağlantı noktası 5000'i kullanıma sunar ve kapsayıcı için bir sahte TTY ayırır. Adres artık localhost konak makinenizi değil kapsayıcının kendisini işaret ediyor.
  • Son kullanıcı sözleşmesini (EULA) kabul eder.
  • Faturalama uç noktasını yapılandırıyor.
  • İngilizce, Fransızca, İspanyolca, Arapça ve Rusça diller için çeviri modellerini indirir.
  • Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.

İpucu

Ek Docker komutu:

  • docker ps çalışan kapsayıcıları listeler.
  • docker pause {your-container name} çalışan bir kapsayıcıyı duraklatır.
  • docker unpause {your-container-name} duraklatılmış bir kapsayıcıyı duraklatır.
  • docker restart {your-container-name} çalışan bir kapsayıcıyı yeniden başlatır.
  • docker exec, çalışan bir kapsayıcıda ortam değişkenlerini ayırmak veya ayarlamak için lto komutlarını yürütmenizi sağlar.

Daha fazla bilgi için bkz. docker CLI başvurusu.

Aynı konakta birden çok kapsayıcı çalıştırma

Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmayı planlıyorsanız, her kapsayıcıyı farklı bir kullanıma sunulan bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, ilk kapsayıcıyı 5000 numaralı bağlantı noktasında, ikinci kapsayıcıyı da 5001 numaralı bağlantı noktasında çalıştırın.

Bu kapsayıcıyı ve HOST üzerinde çalışan farklı bir Azure AI kapsayıcısını birlikte kullanabilirsiniz. Aynı Azure AI kapsayıcısının birden çok kapsayıcısını da çalıştırabilirsiniz.

Çeviri kapsayıcı uç noktasını sorgulama

Kapsayıcı REST tabanlı Çeviri uç nokta API'sini sağlar. Kaynak dili (from=en) belirtilmiş örnek bir istek aşağıda verilmişti:

  curl -X POST "http://localhost:5000/translate?api-version=3.0&from=en&to=zh-HANS" -H "Content-Type: application/json" -d "[{'Text':'Hello, what is your name?'}]"

Not

  • Kaynak dil algılama için ek bir kapsayıcı gerekir. Daha fazla bilgi için bkz. Destekleyici kapsayıcılar

  • cURL POST isteği bir Service is temporarily unavailable yanıt döndürürse kapsayıcı hazır değildir. Birkaç dakika bekleyin ve yeniden deneyin.

Kapsayıcının ç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 aşağıdaki istek URL'lerini kullanın. Listelenen örnek istek URL'leri öğesini işaret eder 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 istendi. Kapsayıcının modele karşı sorgu 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 istendi. 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.

Kapsayıcı giriş sayfasının ekran görüntüsü.

Azure AI hizmetleri kapsayıcısını çalıştırırken sorun yaşıyorsanız Microsoft tanılama kapsayıcısını kullanmayı deneyebilirsiniz. Dağıtım ortamınızda Azure AI kapsayıcılarının beklendiği gibi çalışmasını engelleyebilecek yaygın hataları tanılamak için bu kapsayıcıyı kullanın.

Kapsayıcıyı almak için aşağıdaki docker pull komutu kullanın:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ardından kapsayıcıyı çalıştırın. değerini {ENDPOINT_URI} uç noktanızla değiştirin ve değerini kaynağınızın anahtarıyla değiştirin {API_KEY} :

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Kapsayıcı, faturalama uç noktasına ağ bağlantısı için sınar.

Kapsayıcıyı durdurma

Kapsayıcıyı kapatmak için, kapsayıcının çalıştığı komut satırı ortamında Ctrl+C tuşlarına basın.

Kapsayıcıları desteklemek için kullanım örnekleri

Bazı Çeviri sorguları, işlemlerin başarıyla tamamlanması için destekleyici kapsayıcılar gerektirir. Office belgeleri kullanıyorsanız ve kaynak dil algılaması gerekmiyorsa, yalnızca Çeviri kapsayıcısı gereklidir. Ancak kaynak dil algılama gerekiyorsa veya taranmış PDF belgeleri kullanıyorsanız destekleyici kapsayıcılar gereklidir:

Aşağıdaki tabloda, metin ve belge çevirisi işlemleriniz için gerekli destekleyici kapsayıcılar listelanmaktadır. Çeviri kapsayıcısı, Azure hesabınızdaki Azure AI Çeviri kaynağı aracılığıyla faturalama bilgilerini Azure'a gönderir.

İşlem İstek sorgusu Document type Destekleyici kapsayıcılar
•Metin çevirisi
• Belge Çevirisi		 from Belirtilen. Office belgeleri Hiçbiri
•Metin çevirisi
• Belge Çevirisi		 from belirtilmemiş. Kaynak dili belirlemek için otomatik dil algılama gerektirir. Office belgeleri ✔️ Metin analizi:dil kapsayıcısı
•Metin çevirisi
• Belge Çevirisi		 from Belirtilen. Taranan PDF belgeleri ✔️ Görüntü İşleme:kapsayıcıyı okuma
•Metin çevirisi
• Belge Çevirisi		 from kaynak dili belirlemek için otomatik dil algılama gerektiren belirtilmedi. Taranan PDF belgeleri ✔️ Metin analizi:dil kapsayıcısı

✔️ Görüntü İşleme:kapsayıcıyı okuma

Destekleyici kapsayıcıları ile çalıştırma docker compose

Docker compose, genellikle adlı compose.yamltek bir YAML dosyası kullanarak çok kapsayıcılı uygulamaları yapılandırmanızı sağlayan bir araçtır. docker compose up Kapsayıcı uygulamanızı başlatmak için komutunu ve docker compose down kapsayıcılarınızı durdurup kaldırmak için komutunu kullanın.

Docker Desktop CLI'yı yüklediyseniz Docker oluşturma ve önkoşullarını içerir. Docker Desktop'larınız yoksa Docker Compose'u Yüklemeye genel bakış bölümüne bakın.

Uygulamanızı oluşturma

  1. Tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak uygulamanız için veya seçtiğiniz bir adla container-environment yeni bir dizin oluşturun.

  2. adlı compose.yamlyeni bir YAML dosyası oluşturun. Dosya için compose hem .yml hem de .yaml uzantıları kullanılabilir.

  3. Aşağıdaki YAML kod örneğini kopyalayıp dosyanıza compose.yaml yapıştırın. ve {TRANSLATOR_ENDPOINT_URI} değerini Azure portal Çeviri örneğinizdeki anahtar ve uç nokta değerleriyle değiştirin{TRANSLATOR_KEY}. Belgeleri çeviriyorsanız, kullandığınızdan document translation endpointemin olun.

  4. Üst düzey ad (azure-ai-translator, azure-ai-language, azure-ai-read) belirttiğiniz parametredir.

  5. container_name, çalıştırıldığında kapsayıcı için bir ad oluşturmak yerine docker compose bir ad ayarlayan isteğe bağlı bir parametredir.

    services:
  azure-ai-translator:
    container_name: azure-ai-translator
    image: mcr.microsoft.com/product/azure-cognitive-services/translator/text-translation:latest
    environment:
        - EULA=accept
        - billing={TRANSLATOR_ENDPOINT_URI}
        - apiKey={TRANSLATOR_KEY}
        - AzureAiLanguageHost=http://azure-ai-language:5000
        - AzureAiReadHost=http://azure-ai-read:5000
    ports:
          - "5000:5000"
    azure-ai-language:
      container_name: azure-ai-language
      image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
      environment:
          - EULA=accept
          - billing={TRANSLATOR_ENDPOINT_URI}
          - apiKey={TRANSLATOR_KEY}
    azure-ai-read:
      container_name: azure-ai-read
      image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest
      environment:
          - EULA=accept
          - billing={TRANSLATOR_ENDPOINT_URI}
          - apiKey={TRANSLATOR_KEY}

  6. Bir terminal açın, klasöre container-environment gidin ve kapsayıcıları aşağıdaki docker-compose komutla başlatın:

    docker compose up

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

    docker compose down

    İpucu

    Yararlı Docker komutları:

    • docker compose pause çalışan kapsayıcıları duraklatır.
    • docker compose unpause {your-container-name} duraklatılmış kapsayıcıları duraklatır.
    • docker compose restart tüm durdurulmuş ve çalışan kapsayıcıyı önceki tüm değişiklikleriyle yeniden başlatır. Yapılandırmanızda compose.yaml değişiklik yaparsanız, bu değişiklikler komutuyla docker compose restart güncelleştirilmez. Dosyadaki docker compose up güncelleştirmeleri ve değişiklikleri compose.yaml yansıtmak için komutunu kullanmanız gerekir.
    • docker compose ps -a durdurulan kapsayıcılar da dahil olmak üzere tüm kapsayıcıları listeler.
    • docker compose execçalışan bir kapsayıcıda ortam değişkenlerini ayırmak veya ayarlamak için komutları yürütmenize olanak tanır.

    Daha fazla bilgi için bkz. docker CLI başvurusu.

Kapsayıcı görüntülerini ve etiketlerini Çeviri ve destekleme

Azure AI hizmetleri kapsayıcı görüntüleri Microsoft Yapıt Kayıt Defteri kataloğunda bulunabilir. Aşağıdaki tabloda, metin ve belge çevirisi için tam görüntü konumu listelenir:

Kapsayıcı Görüntü konumu Notlar
Çeviri: Metin ve belge çevirisi mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest MCR'de Azure AI hizmetlerinin Metin Çevirisi sürüm etiketlerinin tam listesini görüntüleyebilirsiniz.
Metin analizi: dil mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest MCR'de Azure AI hizmetlerinin tam listesini Metin Analizi Dil sürümü etiketlerini görüntüleyebilirsiniz.
Görüntü İşleme: okuma mcr.microsoft.com/azure-cognitive-services/vision/read:latest Azure AI hizmetlerinin tam listesini görüntüleyebilir Görüntü İşleme MCR'de sürüm etiketlerini okuyunOCR.

Diğer parametreler ve komutlar

Kapsayıcıyı çalıştırmak için kullanabileceğiniz birkaç parametre ve komut daha şunlardır:

Kullanım kayıtları

Docker kapsayıcılarını bağlantısız bir ortamda çalıştırırken, kapsayıcı kullanım kayıtlarını zaman içinde toplandıkları bir birime yazar. Hizmet kullanımı hakkında bir rapor oluşturmak için rest API uç noktasını da çağırabilirsiniz.

Günlükleri depolamaya yönelik bağımsız değişkenler

Bağlantısı kesilmiş bir ortamda çalıştırıldığında, kullanım günlüklerini depolamak için kapsayıcıya bir çıkış bağlaması kullanılabilir olmalıdır. Örneğin, aşağıdaki örnekte ve Mounts:Output={OUTPUT_PATH} değerini günlüklerin depolandığı yol ile değiştirerek {OUTPUT_PATH} eklersiniz-v /host/output:{OUTPUT_PATH}:

Örnek docker run komut

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

Kubernetes dağıtımlarında ortam değişkeni adları

  • Örneğin Çeviri bazı Azure AI Kapsayıcıları, kullanıcıların kapsayıcıyı çalıştırırken iki nokta üst üste (:) içeren ortam değişkeni adlarını geçirmesini gerektirir.

  • Kubernetes, ortam değişkeni adlarında iki nokta üst üsteleri kabul etmez. Sorunu çözmek için, Kubernetes'e dağıtırken iki alt çizgi karakteriyle (__) iki nokta üst üste değiştirebilirsiniz. Ortam değişkeni adları için aşağıdaki kabul edilebilir biçim örneğine bakın:

        env:
        - name: Mounts__License
          value: "/license"
        - name: Mounts__Output
          value: "/output"

Bu örnek, docker run komutundaki Mounts:License ve Mounts:Output ortam değişkeni adları için varsayılan biçimin yerini alır.

Kapsayıcı uç noktalarını kullanarak kullanım kayıtlarını alma

Kapsayıcı, kullanımıyla ilgili kayıtları döndürmek için iki uç nokta sağlar.

Tüm kayıtları alma

Aşağıdaki uç nokta, bağlı faturalama kaydı dizininde toplanan tüm kullanımı özetleyen bir rapor sağlar.

https://<service>/records/usage-logs/

Tüm kayıtları almak için örnek HTTPS uç noktası

http://localhost:5000/records/usage-logs

Belirli bir ayın kayıtlarını alma

Aşağıdaki uç nokta, belirli bir ay ve yıl içindeki kullanımı özetleyen bir rapor sağlar:

https://<service>/records/usage-logs/{MONTH}/{YEAR}

Belirli bir ay ve yıla ilişkin kayıtları almak için örnek HTTPS uç noktası

http://localhost:5000/records/usage-logs/03/2024

Kullanım günlükleri uç noktaları aşağıdaki örneğe benzer bir JSON yanıtı döndürür:

Bağlan kapsayıcı

Kullanım ücretleri, değere göre quantity hesaplanır.

{
  "apiType": "string",
"serviceName": "string",
"meters": [
  {
    "name": "string",
    "quantity": 256345435
    }
  ]
}

Özet

Bu makalede, Azure AI Çeviri kapsayıcısını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışlarını öğrendiniz:

  • Azure AI Çeviri kapsayıcısı metin çevirisini, zaman uyumlu belge çevirisini ve metin çevirisini destekler.

  • Kapsayıcı görüntüleri kapsayıcı kayıt defterinden indirilir ve Docker'da çalıştırılır.

  • Bir kapsayıcı örneği oluştururken faturalama bilgileri belirtilmelidir.

Sonraki adımlar

Azure AI kapsayıcı yapılandırmasıhakkında daha fazla bilgi edinin Kapsayıcı dili desteği hakkında daha fazla bilgi edinin.