Belge Çevirisi akışı oluşturma (önizleme)

  • Makale

Önemli

Translator bağlayıcısı şu anda genel önizlemede kullanılabilir. Genel Kullanılabilirlik (GA) öncesinde kullanıcı geri bildirimlerine göre özellikler, yaklaşımlar ve süreçler değişebilir.

Bu öğretici, belge çevirisini destekleyen bir Microsoft Çeviri V3 bağlayıcısı bulut akışı yapılandırma konusunda size yol gösterir. Translator V3 bağlayıcısı Translator Hizmeti örneğinizle Microsoft Power Automate arasında bir bağlantı oluşturur ve uygulamalarınızda ve iş akışlarınızda bir veya daha fazla önceden oluşturulmuş işlemi adım olarak kullanmanızı sağlar.

Belge Çevirisi, Azure AI Translator hizmetinin bulut tabanlı bir REST API özelliğidir. Belge Çevirisi API'si, özgün belge yapısını ve veri biçimini korurken birden çok ve karmaşık belge çevirisini etkinleştirir.

Bu öğreticide:

Önkoşullar

Başlamak için şunları yapmanız gerekir: Translator kaynağı, en az iki kapsayıcıya sahip Azure depolama hesabı ve rol tabanlı erişime sahip sistem tarafından atanan yönetilen kimlik.

Translator kaynağı

  • Etkin bir Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.

  • Tek hizmetli translator kaynağı oluşturma (çok hizmetli bir Azure AI hizmetleri kaynağı değil ). Translator projesi ve örnek ayrıntıları alanlarını tamamladığınızda aşağıdaki girişlere özellikle dikkat edin:

    • Kaynak Bölgesi. Batı ABD (Küresel bölge değil) gibi bir coğrafi bölge seçin.

    • Fiyatlandırma katmanı. Hizmeti denemek için Standart S1'i seçin.

  • Uygulamanızı Power Automate'e bağlamak için Translator kaynağınızdaki anahtarı ve adı kullanın. Translator kaynak anahtarlarınız Azure portalındaki Kaynak Yönetimi bölümünde bulunur ve kaynak adınız sayfanın en üstünde yer alır.

    Anahtarı ve uç noktayı alın.

  • Anahtarınızı ve kaynak adınızı kopyalayıp Microsoft Not Defteri gibi uygun bir konuma yapıştırın.

Azure depolama alanı

  • Ardından, kaynak ve hedef dosyalarınız için bir Azure Blob Depolama hesabına ve en az iki kapsayıcıya ihtiyacınız vardır:

    • Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
    • Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).

  • Depolama hesabınız bir güvenlik duvarının arkasındaysa ek yapılandırmaları etkinleştirmeniz gerekir:

    1. Azure portalına gidin ve Azure hesabınızla oturum açın.

    2. Depolama hesabınızı seçin.

    3. Sol bölmedeki Güvenlik + ağ grubunda Ağ'ı seçin.

    4. Güvenlik duvarları ve sanal ağlar sekmesinde Seçili sanal ağlardan ve IP adreslerinden etkinleştirildi'yi seçin.

      Ekran görüntüsü: Seçili ağlar radyo düğmesi seçildi.

    5. Tüm onay kutularının seçimini kaldırın.

    6. Microsoft ağ yönlendirmesi'nin seçili olduğundan emin olun.

    7. Kaynak örnekleri bölümünde kaynak türü olarak Microsoft.CognitiveServices/accounts öğesini seçin ve örnek adı olarak Translator kaynağınızı seçin.

    8. Güvenilen hizmetler listesindeki Azure hizmetlerinin bu depolama hesabına erişmesine izin ver kutusunun işaretli olduğundan emin olun. Özel durumları yönetme hakkında daha fazla bilgi için bkz. Azure Depolama güvenlik duvarlarını ve sanal ağları yapılandırma.

      Ekran görüntüsü: Güvenilen hizmetlere izin ver onay kutusu, portal görünümü.

    9. Kaydet'i seçin. Ağ değişikliklerinin yayılması 5 dakika kadar sürebilir.

RBAC ile yönetilen kimlik

Son olarak, Belge çevirisi için Translator V3 bağlayıcısının işlemlerini kullanabilmeniz için önce Rol tabanlı kimlik denetimi (RBAC) ile yönetilen bir kimlik kullanarak Translator kaynağınıza depolama hesabınıza erişim izni vermelisiniz.

Yönetilen kimlik akışının (RBAC) ekran görüntüsü.

Yönetilen kimlik oluşturma

İlk olarak Translator kaynağınız için sistem tarafından atanan bir yönetilen kimlik oluşturun ve bu kimliğe Azure depolama hesabınıza erişmek için belirli izinler verin:

  1. Azure portalına gidin ve Azure hesabınızla oturum açın.

  2. Translator kaynağını seçin.

  3. Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.

  4. Sistem tarafından atanan sekmesinde Durum iki durumlu düğmesini açın.

  5. Kaydet'i seçin.

    Ekran görüntüsü: Azure portalında kaynak yönetimi kimlik sekmesi.

Rol ataması

Ardından, depolama kaynağınızın depolama kapsamında yönetilen kimliğe bir Storage Blob Data Contributor rol atayın.

  1. Azure portalına gidin ve Azure hesabınızla oturum açın.

  2. Translator kaynağını seçin.

  3. Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.

  4. İzinler'in altında Azure rol atamaları'ı seçin:

    Ekran görüntüsü: Azure portalında sistem tarafından atanan yönetilen kimliği etkinleştirme.

  5. Açılan Azure rol atamaları sayfasında, açılan menüden aboneliğinizi seçin ve ardından + Rol ataması ekle'yi seçin.

    Ekran görüntüsü: Azure portalında Azure rol atamaları sayfası.

  6. Son olarak, Translator hizmet kaynağınıza bir Depolama Blobu Veri Katkıda Bulunanı rolü atayın. Depolama Blob Verileri Katkıda Bulunanı rolü, Translator'a (sistem tarafından atanan yönetilen kimlik tarafından temsil edilir) blob kapsayıcısına ve verilerine okuma, yazma ve silme erişimi verir. Rol ataması ekle açılır penceresinde, alanları aşağıdaki gibi doldurun ve Kaydet'i seçin:

    Alan Değer
    Scope Depolama.
    Abonelik Depolama kaynağınızla ilişkili abonelik.
    Kaynak Depolama kaynağınızın adı.
    Rol Depolama Blob Verileri Katkıda Bulunanı.

  7. Rol ataması eklendi onay iletisi görüntülendikten sonra eklenen rol atamasını görmek için sayfayı yenileyin.

    Ekran görüntüsü: Rol ataması onay açılır iletisi eklendi.

  8. Yeni rol atamasını hemen görmüyorsanız bekleyin ve sayfayı yenilemeyi yeniden deneyin. Rol atamalarını atadığınızda veya kaldırdığınızda değişikliklerin geçerlilik kazanması 30 dakika kadar sürebilir.

    Ekran görüntüsü: Azure rol atamaları penceresi.

Belge Çevirisi akışı yapılandırma

Önkoşulları ve ilk kurulumu tamamladığınıza göre, belge çeviri akışınızı oluşturmak için Translator V3 bağlayıcısını kullanmaya başlayalım:

  1. Power Automate'te oturum açın.

  2. Sol kenar çubuğu menüsünden Oluştur'u seçin.

  3. Ana içerik alanından Anlık bulut akışı'nı seçin.

    Anlık bulut akışının nasıl oluşturulacağını gösteren ekran görüntüsü.

  4. Açılan pencerede akışınızı adlandırın, ardından Akışı el ile tetikle'yi seçin ve Oluştur'u seçin.

    Akışı el ile tetikleme işlemini gösteren ekran görüntüsü.

  5. Anlık akışınız için ilk adım (Akışı el ile tetikleme) ekranda görünür. Yeni adım'ı seçin.

    Yeni akış adımı ekleme sayfasının ekran görüntüsü.

Belgeleri çevirme

Ardından, bir eylem seçmeye hazırız. Azure Blob Depolama veya Microsoft SharePoint hesabınızda bulunan belgeleri çevirebilirsiniz.

Azure Blob Storage

Translator V3 bağlayıcısını kullanarak Azure Blob Depolama'da bir dosyayı çevirme adımları şunlardır:

  • Translator V3 bağlayıcısını seçin.
  • Belge çevirisi'ne tıklayın.
  • Azure Blob Depolama kimlik bilgilerinizi ve kapsayıcı konumlarınızı girin.
  • Kaynak ve hedef dilleri seçerek belgelerinizi çevirin.
  • Çeviri işleminin durumunu alın.

  1. İşlem seçin açılır penceresinde, Bağlayıcılar ve eylemler arama çubuğuna Translator V3 yazın ve Microsoft Çeviri V3 simgesini seçin.

    Sonraki akış adımı olarak Translator V3 seçimini gösteren ekran görüntüsü.

  2. Belge çevirisini başlat eylemini seçin.

  3. Translator V3 bağlayıcısını ilk kez kullanıyorsanız kaynak kimlik bilgilerinizi girmeniz gerekir:

    • Bağlantı adı. Bağlantınız için bir ad girin.

    • Abonelik Anahtarı. Translator kaynak anahtarlarınız Azure portalındaki kaynak kenar çubuğunun Kaynak Yönetimi bölümünde bulunur. Anahtarlarınızdan birini girin. Translator kaynağınızın Batı ABD (genel değil) gibi bir coğrafi bölgeye atandığından emin olun.

    • Translator kaynak adı. Azure portalında kaynak sayfanızın üst kısmında bulunan Translator kaynağınızın adını girin. Oluştur'u belirleyin.

      Bağlantı ekleme penceresini gösteren ekran görüntüsü.

      Not

      Bağlantınızı ayarladıktan sonra, sonraki akışlar için kimlik bilgilerinizi yeniden kullanmanız gerekmez.

  4. Belge çevirisini başlat eylem penceresi şimdi görüntülenir. Alanları aşağıdaki gibi tamamlayın:

    • Giriş belgelerinin Depolama türü için. Dosya veya Klasör'e tıklayın.

    • Açılan menüden bir Kaynak Dil seçin veya varsayılan Otomatik algılama seçeneğini koruyun.

    • Kaynak belgelerin konumu. Azure depolama kaynağı belge kapsayıcınızda belgelerinizin URL'sini girin.

    • Çevrilen belgelerin konumu. Azure depolama hedef belge kapsayıcınızın URL'sini girin.

      Kaynak ve hedef URL'lerinizi bulmak için:

      • Azure portalda depolama hesabınıza gidin.

      • Sol kenar çubuğundaki Veri depolama altında Kapsayıcılar'ı seçin:

        Source Target
        Kaynak kapsayıcının yanındaki onay kutusunu seçin Hedef kapsayıcının yanındaki onay kutusunu seçin.
        Ana pencere alanından çeviri için bir dosya veya belge seçin. Sağ tarafta bulunan üç noktayı ve ardından Özellikler'i seçin.
        Kaynak URL, Özellikler listesinin en üstünde bulunur. Panoya Kopyala simgesini seçin. Hedef URL, Özellikler listesinin en üstünde bulunur. Panoya Kopyala simgesini seçin.
        Power automate akışınıza gidin ve kaynak URL'yi kaynak belgelerin konumu alanına yapıştırın. Power automate akışınıza gidin ve hedef URL'yi çevrilmiş belgelerin konumu alanına yapıştırın.

    • Açılan menüden bir Hedef Dil seçin ve Kaydet'i seçin.

      Belge çevirisini başlat iletişim penceresinin ekran görüntüsü.

Belgelerin durumunu alma

Belgelerinizi çeviri için gönderdiğinize göre işlemin durumunu denetleyelim.

  1. Yeni adım'ı seçin.

  2. Arama kutusuna Translator V3 yazın ve V3'Microsoft Çeviri seçin.

  3. Belgeleri al durumunu seçin (tekil Belge durumunu al eylemini değil).

    Belge alma durumu adımının ekran görüntüsü.

  4. Ardından, değeri almak operation ID için bir ifade gireceksiniz.

  5. İşlem kimliği alanını seçin. Dinamik içerik / İfadesi açılan penceresi görüntülenir.

  6. İfade sekmesini seçin ve işlev alanına aşağıdaki ifadeyi girin:

    
   body('Start_document_translation').operationID

    İşlev oluşturma penceresini gösteren ekran görüntüsü.

  7. Tamam'ı seçin. İşlev, İşlem Kimliği penceresinde görüntülenir. Kaydet'i seçin.

    İfade işlev değerine sahip işlem kimliği alanını gösteren ekran görüntüsü.

Bağlayıcı akışını test edin

Akış ve belge çevirisi sonuçlarımızı denetleme zamanı.

  1. Sayfanın üst kısmında Akışınız'ın kullanıma hazır olduğunu gösteren yeşil bir çubuk vardır.

  2. Sayfanın sağ üst köşesinden Test'i seçin.

    Test simgesini/düğmesini gösteren ekran görüntüsü.

  3. Aşağıdaki düğmeleri seçin: Sağ taraftaki pencerede Test Akışı → El ile → Test .

  4. Sonraki pencerede Akışı çalıştır düğmesini seçin.

  5. Son olarak Bitti düğmesini seçin.

  6. Akışınız başarıyla çalıştı iletisini almanız ve yeşil onay işaretlerinin her başarılı adımla uyumlu olması gerekir.

    Başarılı belge çevirisi akışının ekran görüntüsü.

  7. Belgeleri al durum adımını ve ardından Çıkışlar bölümünden Ham çıkışları göster'i seçin.

  8. Belgeleri al durum penceresi görüntülenir. JSON yanıtının en üstünde, isteğin başarılı olduğunu belirten bir ifade görürsünüz "statusCode":200 .

    'Belge durumunu al' JSON yanıtını gösteren ekran görüntüsü.

  9. Son denetim olarak Azure Blob Depolama hedef kaynak kapsayıcınıza gidin. Burada, çevrilmiş belgeyi Genel Bakış bölümünde görmeniz gerekir. Belge, çeviri dil koduyla etiketlenmiş bir klasörde olabilir.

İşte hepsi bu! Microsoft Çeviri V3 bağlayıcısını ve Power Automate'i kullanarak belge çevirisi işlemlerini otomatikleştirmeyi öğrendinsiniz.

Sonraki adımlar

Belge Çevirisi başvuru kılavuzunu keşfetme