Udostępnij za pośrednictwem


Tworzenie przepływu tłumaczenia dokumentów (wersja zapoznawcza)

Ważne

Łącznik usługi Translator jest obecnie dostępny w publicznej wersji zapoznawczej. Funkcje, podejścia i procesy mogą ulec zmianie przed ogólną dostępnością na podstawie opinii użytkowników.

Ten samouczek przeprowadzi Cię przez proces konfigurowania przepływu chmury łącznika Microsoft Translator v3 obsługującego tłumaczenie dokumentów. Łącznik translatora w wersji 3 tworzy połączenie między wystąpieniem usługi Translator i usługą Microsoft Power Automate, umożliwiając korzystanie z co najmniej jednej wstępnie utworzonej operacji w ramach kroków w aplikacjach i przepływach pracy.

Tłumaczenie dokumentów to funkcja interfejsu API REST oparta na chmurze usługi Azure AI Translator. Interfejs API tłumaczenia dokumentów umożliwia tłumaczenie wielu i złożonych dokumentów przy zachowaniu oryginalnej struktury i formatu danych.

W tym samouczku:

Wymagania wstępne

Oto, co należy rozpocząć: zasób usługi Translator, konto usługi Azure Storage z co najmniej dwoma kontenerami oraz tożsamość zarządzana przypisana przez system z dostępem opartym na rolach.

Zasób usługi Translator

  • Jeśli nie masz aktywnego konta platformy Azure, możesz utworzyć je bezpłatnie.

  • Utwórz zasób usługi Translator z jedną usługą (nie zasób wielosługowych usług Azure AI). Po ukończeniu pól szczegółów projektu i wystąpienia usługi Translator zwróć szczególną uwagę na następujące wpisy:

    • Region zasobów. Wybierz region geograficzny, taki jak Zachodnie stany USA (a nie region globalny).

    • Warstwa cenowa. Wybierz pozycję Standardowa S1 , aby wypróbować usługę.

  • Użyj klucza i nazwy z zasobu usługi Translator, aby połączyć aplikację z usługą Power Automate. Klucze zasobów usługi Translator znajdują się w sekcji Zarządzanie zasobami w witrynie Azure Portal, a nazwa zasobu znajduje się w górnej części strony.

    Pobierz klucz i punkt końcowy.

  • Skopiuj i wklej klucz i nazwę zasobu w dogodnej lokalizacji, takiej jak Notatnik Firmy Microsoft.

Magazyn platformy Azure

  • Następnie potrzebne jest konto usługi Azure Blob Storage i co najmniej dwa kontenery dla plików źródłowych i docelowych:

    • Kontener źródłowy. Ten kontener służy do przekazywania plików do tłumaczenia (wymagane).
    • Kontener docelowy. W tym kontenerze przechowywane są przetłumaczone pliki (wymagane).
  • Jeśli konto magazynu znajduje się za zaporą, musisz włączyć dodatkowe konfiguracje:

    1. Przejdź do witryny Azure Portal i zaloguj się na swoje konto platformy Azure.

    2. Wybierz konto magazynu.

    3. W grupie Zabezpieczenia i sieć w okienku po lewej stronie wybierz pozycję Sieć.

    4. Na karcie Zapory i sieci wirtualne wybierz pozycję Włączone z wybranych sieci wirtualnych i adresów IP.

      Zrzut ekranu: wybrany przycisk radiowy Wybrane sieci.

    5. Usuń zaznaczenie wszystkich pól wyboru.

    6. Upewnij się, że wybrano routing sieciowy firmy Microsoft.

    7. W sekcji Wystąpienia zasobów wybierz pozycję Microsoft.CognitiveServices/accounts jako typ zasobu i wybierz zasób usługi Translator jako nazwę wystąpienia.

    8. Upewnij się, że pole Zezwalaj usługom platformy Azure na liście zaufanych usług na dostęp do tego konta magazynu jest zaznaczone. Aby uzyskać więcej informacji na temat zarządzania wyjątkami, zobacz Konfigurowanie zapór i sieci wirtualnych usługi Azure Storage.

      Zrzut ekranu: zezwalaj na pole wyboru zaufanych usług, widok portalu.

    9. Wybierz pozycję Zapisz. Propagacja zmian sieci może potrwać do 5 minut.

Tożsamość zarządzana przy użyciu kontroli dostępu opartej na rolach

Na koniec, zanim będzie można używać operacji łącznika translatora w wersji 3 na potrzeby tłumaczenia dokumentów, musisz przyznać usłudze Translator dostęp do zasobu usługi Translator do konta magazynu przy użyciu tożsamości zarządzanej z kontrolą tożsamości opartą na rolach (RBAC).

Zrzut ekranu przedstawiający przepływ tożsamości zarządzanej (RBAC).

Tworzenie tożsamości zarządzanej

Najpierw utwórz tożsamość zarządzaną przypisaną przez system dla zasobu usługi Translator i przyznaj tej tożsamości określone uprawnienia dostępu do konta usługi Azure Storage:

  1. Przejdź do witryny Azure Portal i zaloguj się na swoje konto platformy Azure.

  2. Wybierz zasób translatora.

  3. W grupie Zarządzanie zasobami w okienku po lewej stronie wybierz pozycję Tożsamość.

  4. Na karcie Przypisane przez system włącz przełącznik Stan .

  5. Wybierz pozycję Zapisz.

    Zrzut ekranu: karta tożsamości zarządzania zasobami w witrynie Azure Portal.

Przypisanie roli

Następnie przypisz Storage Blob Data Contributor rolę do tożsamości zarządzanej w zakresie magazynu dla zasobu magazynu.

  1. Przejdź do witryny Azure Portal i zaloguj się na swoje konto platformy Azure.

  2. Wybierz zasób translatora.

  3. W grupie Zarządzanie zasobami w okienku po lewej stronie wybierz pozycję Tożsamość.

  4. W obszarze Uprawnienia wybierz pozycję Przypisania ról platformy Azure:

    Zrzut ekranu: włączanie tożsamości zarządzanej przypisanej przez system w witrynie Azure Portal.

  5. Na otwartej stronie Przypisania ról platformy Azure wybierz swoją subskrypcję z menu rozwijanego, a następnie wybierz pozycję + Dodaj przypisanie roli.

    Zrzut ekranu: strona Przypisań ról platformy Azure w witrynie Azure Portal.

  6. Na koniec przypisz rolę Współautor danych obiektu blob usługi Storage do zasobu usługi Translator. Rola Współautor danych obiektu blob usługi Storage zapewnia usłudze Translator (reprezentowane przez tożsamość zarządzaną przypisaną przez system) odczyt, zapis i usuwanie dostępu do kontenera obiektów blob i danych. W oknie podręcznym Dodawanie przypisania roli wypełnij pola w następujący sposób i wybierz pozycję Zapisz:

    Pole Wartość
    Scope Magazyn.
    Subskrypcja Subskrypcja skojarzona z zasobem magazynu.
    Zasób Nazwa zasobu magazynu.
    Rola Współautor danych obiektu blob usługi Storage.
  7. Po wyświetleniu komunikatu potwierdzenia Dodano przypisanie roli odśwież stronę, aby wyświetlić dodane przypisanie roli.

    Zrzut ekranu: Dodano komunikat z potwierdzeniem przypisania roli.

  8. Jeśli od razu nie widzisz nowego przypisania roli, poczekaj i spróbuj odświeżyć stronę ponownie. Po przypisaniu lub usunięciu przypisań ról może upłynąć do 30 minut, aby zmiany zaczęły obowiązywać.

    Zrzut ekranu: okno przypisań ról platformy Azure.

Konfigurowanie przepływu tłumaczenia dokumentów

Teraz, po ukończeniu wymagań wstępnych i początkowej konfiguracji, zacznijmy korzystać z łącznika translatora w wersji 3 w celu utworzenia przepływu tłumaczenia dokumentów:

  1. Zaloguj się do usługi Power Automate.

  2. Wybierz pozycję Utwórz z menu paska bocznego po lewej stronie.

  3. Wybierz pozycję Błyskawiczny przepływ chmury z głównego obszaru zawartości.

    Zrzut ekranu przedstawiający sposób tworzenia natychmiastowego przepływu chmury.

  4. W oknie podręcznym nadaj przepływowi nazwę, a następnie wybierz pozycję Ręcznie wyzwól przepływ i wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający sposób ręcznego wyzwalania przepływu.

  5. Pierwszy krok dla przepływu natychmiastowego — ręczne wyzwalanie przepływu — pojawia się na ekranie. Wybierz pozycję Nowy krok.

    Zrzut ekranu przedstawiający stronę dodawania nowego kroku przepływu.

Tłumaczenie dokumentów

Następnie możemy wybrać akcję. Możesz przetłumaczyć dokumenty znajdujące się w usłudze Azure Blob Storage lub na koncie programu Microsoft SharePoint .

Azure Blob Storage

Poniżej przedstawiono kroki tłumaczenia pliku w usłudze Azure Blob Storage przy użyciu łącznika translatora w wersji 3:

  • Wybierz łącznik Translator w wersji 3.
  • Wybierz pozycję Tłumaczenie dokumentów.
  • Wprowadź poświadczenia usługi Azure Blob Storage i lokalizacje kontenerów.
  • Przetłumacz dokumenty wybierające języki źródłowe i docelowe.
  • Uzyskaj stan operacji tłumaczenia.
  1. W oknie podręcznym Wybieranie operacji wprowadź ciąg Translator v3 na pasku wyszukiwania łączników wyszukiwania i akcji, a następnie wybierz ikonę Microsoft Translator V3.

    Zrzut ekranu przedstawiający wybór wersji 3 w usłudze Translator jako kolejny krok przepływu.

  2. Wybierz akcję Rozpocznij tłumaczenie dokumentu.

  3. Jeśli używasz łącznika translatora w wersji 3 po raz pierwszy, musisz wprowadzić poświadczenia zasobu:

    • Nazwa połączenia. Wprowadź nazwę połączenia.

    • Klucz subskrypcji. Klucze zasobów usługi Translator znajdują się w sekcji Zarządzanie zasobami paska bocznego zasobu w witrynie Azure Portal. Wprowadź jeden z kluczy. Upewnij się, że zasób usługi Translator jest przypisany do regionu geograficznego, takiego jak Zachodnie stany USA (nie globalne).

    • Nazwa zasobu usługi Translator. Wprowadź nazwę zasobu usługi Translator znalezionego w górnej części strony zasobu w witrynie Azure Portal. Wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający okno z instrukcjami dodawania połączenia.

      Uwaga

      Po skonfigurowaniu połączenia nie będzie konieczne ponowne podanie poświadczeń dla kolejnych przepływów.

  4. Zostanie wyświetlone okno akcji Rozpocznij tłumaczenie dokumentu. Wypełnij pola w następujący sposób:

    • W polu Typ magazynu dokumentów wejściowych. Wybierz pozycję Plik lub Folder.

    • Wybierz język źródłowy z menu rozwijanego lub zachowaj domyślną opcję Automatycznego wykrywania.

    • Lokalizacja dokumentów źródłowych. Wprowadź adres URL dokumentów w kontenerze dokumentów źródłowych usługi Azure Storage.

    • Lokalizacja przetłumaczonych dokumentów. Wprowadź adres URL kontenera dokumentów docelowych usługi Azure Storage.

      Aby znaleźć źródłowe i docelowe adresy URL:

      • W witrynie Azure Portal przejdź do swojego konta magazynu.

      • Na pasku bocznym po lewej stronie w obszarze Magazyn danych wybierz pozycję Kontenery:

        Lokalizacja źródłowa Target
        Zaznacz pole wyboru obok kontenera źródłowego Zaznacz pole wyboru obok kontenera docelowego.
        W obszarze głównym okna wybierz plik lub dokument do tłumaczenia. Wybierz wielokropek znajdujący się po prawej stronie, a następnie wybierz pozycję Właściwości.
        Źródłowy adres URL znajduje się w górnej części listy Właściwości. Wybierz ikonę Kopiuj do Schowka . Docelowy adres URL znajduje się w górnej części listy Właściwości. Wybierz ikonę Kopiuj do Schowka .
        Przejdź do przepływu usługi Power Automate i wklej źródłowy adres URL w polu Lokalizacja dokumentów źródłowych. Przejdź do przepływu usługi Power Automate i wklej docelowy adres URL w polu Lokalizacja przetłumaczonych dokumentów .
    • Wybierz język docelowy z menu rozwijanego i wybierz pozycję Zapisz.

      Zrzut ekranu przedstawiający okno dialogowe Uruchamiania tłumaczenia dokumentów.

Pobieranie stanu dokumentów

Teraz, po przesłaniu dokumentów do tłumaczenia, sprawdźmy stan operacji.

  1. Wybierz pozycję Nowy krok.

  2. Wprowadź ciąg Translator v3 w polu wyszukiwania i wybierz pozycję Microsoft Translator V3.

  3. Wybierz pozycję Pobierz stan dokumentów (a nie pojedynczą akcję Pobierz stan dokumentu ).

    Zrzut ekranu przedstawiający krok pobierania stanu dokumentów.

  4. Następnie wprowadzisz wyrażenie, aby pobrać operation ID wartość.

  5. Wybierz pole identyfikatora operacji. Zostanie wyświetlone okno rozwijane Wyrażenie zawartości / dynamicznej.

  6. Wybierz kartę Wyrażenie i wprowadź następujące wyrażenie w polu funkcji:

    
       body('Start_document_translation').operationID
    
    

    Zrzut ekranu przedstawiający okno tworzenia funkcji.

  7. Wybierz przycisk OK. Funkcja zostanie wyświetlona w oknie Identyfikator operacji. Wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający pole identyfikatora operacji z wartością funkcji wyrażenia.

Testowanie przepływu łącznika

Czas, aby sprawdzić nasz przepływ i wyniki tłumaczenia dokumentów.

  1. W górnej części strony znajduje się zielony pasek wskazujący, że przepływ jest gotowy do przejścia.

  2. Wybierz pozycję Testuj w prawym górnym rogu strony.

    Zrzut ekranu przedstawiający ikonę/przycisk testu.

  3. Wybierz następujące przyciski: Testowanie przepływuRęcznieTest w oknie po prawej stronie.

  4. W następnym oknie wybierz przycisk Uruchom przepływ .

  5. Na koniec wybierz przycisk Gotowe .

  6. Powinien zostać wyświetlony komunikat Pomyślnie uruchomiony przepływ i zielone znaczniki wyboru są zgodne z każdym pomyślnym krokiem.

    Zrzut ekranu przedstawiający pomyślny przepływ tłumaczenia dokumentów.

  7. Wybierz krok Pobieranie stanu dokumentów, a następnie wybierz pozycję Pokaż nieprzetworzone dane wyjściowe w sekcji Dane wyjściowe.

  8. Zostanie wyświetlone okno Pobieranie stanu dokumentów. W górnej części odpowiedzi JSON widać "statusCode":200 , że żądanie zakończyło się pomyślnie.

    Zrzut ekranu przedstawiający odpowiedź JSON

  9. W ramach ostatecznego sprawdzenia przejdź do docelowego kontenera źródłowego usługi Azure Blob Storage. W tym miejscu powinien zostać wyświetlony przetłumaczony dokument w sekcji Przegląd . Dokument może znajdować się w folderze oznaczonym kodem języka tłumaczenia.

I już! Nauczyliśmy się automatyzować procesy tłumaczenia dokumentów przy użyciu łącznika microsoft Translator v3 i usługi Power Automate.

Następne kroki