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

Kapsayıcılar, Azure AI Translator 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 Translator 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 Translator kapsayıcısını çevrimiçi olarak yüklemeyi ve çalıştırmayı öğrenin. Azure AI Translator kapsayıcısı aşağıdaki işlemleri destekler:

• Metin Çevirisi. Sözcüklerin veya tümceciklerin bağlamsal anlamını desteklenen source target 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. 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.

• Translator bağlı kapsayıcısına veya Translator bağlantısı kesilmiş kapsayıcıya onaylanan erişim isteği.

• Onaylanan abonelik kimliği altında oluşturulmuş bir Azure AI Translator 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.

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

    

  • Çevirinin bağlantısı kesilmiş kapsayıcılar için fiyatlandırma katmanı olarak öğesini seçin Commitment 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.

    

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 docker terminoloji 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.

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:

• 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.

Önerilen CPU çekirdekleri ve bellek

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.

• 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 Translator 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.

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:

Azure'a bağlanma

• 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 Translator kapsayıcısı azure-cognitive-services/translator deposunda bulunur ve olarak adlandırılır text-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 Translator kapsayıcı ortamınızı seçmek için bir sekme seçin:

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

  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?'}]"

docker run --rm -it -p 5000:5000 \

-v {MODEL_MOUNT_PATH} \

-v {LICENSE_MOUNT_PATH} \

-e Mounts:License={CONTAINER_LICENSE_DIRECTORY} \

-e DownloadLicense=true \

-e eula=accept \

-e billing={ENDPOINT_URI} \

-e apikey={API_KEY} \

-e Languages={LANGUAGES_LIST} \

[image]

    -e MODELS= usr/local/models/model1/, usr/local/models/model2/
    -e TRANSLATORSYSTEMCONFIG=/usr/local/models/Config/5a72fa7c-394b-45db-8c06-ecdfc98c0832

docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \

-v {MODEL_MOUNT_PATH} \

-v {LICENSE_MOUNT_PATH} \

-v {OUTPUT_MOUNT_PATH} \

-e Mounts:License={CONTAINER_LICENSE_DIRECTORY} \

-e Mounts:Output={CONTAINER_OUTPUT_DIRECTORY} \

-e MODELS={MODELS_DIRECTORY_LIST} \

-e TRANSLATORSYSTEMCONFIG={TRANSLATOR_CONFIG_JSON} \

-e eula=accept \

[image]

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.

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ı Translator 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 Translator 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. Translator kapsayıcısı, Azure hesabınızdaki Azure AI Translator kaynağı aracılığıyla faturalama bilgilerini Azure'a gönderir.

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 Translator ö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/azure-cognitive-services/translator/text-translation::latest
       environment:
           - EULA=accept
           - billing={TRANSLATOR_ENDPOINT_URI}
           - apiKey={TRANSLATOR_KEY}
           - ladurl=http://azure-ai-language:5000
           - VISIONURL=http://azure-ai-read:5000
       ports:
             - "5000:5000"
       volumes:
             - {your local folder}:/usr/local/models
       azure-ai-language:
         container_name: azure-ai-language
         image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
         environment:
             - EULA=accept
             - billing={LANGUAGE_RESOURCE_ENDPOINT_URI}
             - apiKey={LANGUAGE_RESOURCE_KEY}
             - Languages=en,es
             - LADINCLUSTER=true 
       azure-ai-read:
         container_name: azure-ai-read
         image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest
         environment:
             - EULA=accept
             - billing={COMPUTER_VISION_ENDPOINT_URI}
             - apiKey={COMPUTER_VISION_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.

Çeviri ve destekleyici 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. Aşağıdaki tabloda, metin ve belge çevirisi için tam görüntü konumu listelenir:

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ı

• Translator gibi 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:

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

      {
    "type": "CommerceUsageResponse",
    "meters": [
      {
        "name": "CognitiveServices.TextTranslation.Container.OneDocumentTranslatedCharacters",
        "quantity": 1250000,
        "billedUnit": 1875000
      },
      {
        "name": "CognitiveServices.TextTranslation.Container.TranslatedCharacters",
        "quantity": 1250000,
        "billedUnit": 1250000
      }
    ],
    "apiType": "texttranslation",
    "serviceName": "texttranslation"
   }

Özet

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

• Azure AI Translator 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