Vytvoření toku překladu dokumentů (Preview)

Důležité

Konektor Translator je aktuálně dostupný ve verzi Public Preview. Funkce, přístupy a procesy se můžou před obecnou dostupností (GA) změnit na základě zpětné vazby uživatelů.

Tento kurz vás provede konfigurací cloudového toku konektoru Microsoft Translator V3, který podporuje překlad dokumentů. Konektor Translator V3 vytvoří propojení mezi vaší instancí služby Translator a Microsoft Power Automate, které vám umožní používat jednu nebo více předem připravených operací jako postup v aplikacích a pracovních postupech.

Překlad dokumentů je cloudová funkce rozhraní REST API služby Azure AI Translator. Rozhraní API pro překlad dokumentů umožňuje více a složitých překladů dokumentů při zachování původní struktury dokumentů a formátu dat.

V tomto kurzu:

• Vytvořte účet úložiště objektů blob s kontejnery pro zdrojové a cílové soubory.
• Nastavení spravované identity pomocí řízení přístupu na základě role (RBAC)
• Přeložte dokumenty z účtu služby Azure Blob Storage.
• Přeložte dokumenty z sharepointového webu.

Požadavky

Začněte tím, co potřebujete: prostředek Služby Translator, účet úložiště Azure s alespoň dvěma kontejnery a spravovanou identitu přiřazenou systémem s přístupem na základě role.

Prostředek Translator

• Pokud nemáte aktivní účet Azure, můžete si ho zdarma vytvořit.

• Vytvořte prostředek Translatoru s jednou službou (nikoli prostředek služeb Azure AI s více službami). Při dokončování polí s podrobnostmi projektu a instance služby Translator věnujte zvláštní pozornost následujícím položkám:

  • Oblast zdroje. Zvolte geografickou oblast, jako je USA – západ (ne globální oblast).

  • Cenová úroveň: Pokud chcete službu vyzkoušet, vyberte Standard S1 .

• Pomocí klíče a názvu prostředku Translator připojte aplikaci k Power Automate. Klíče prostředků Služby Translator najdete v části Správa prostředků na webu Azure Portal a název vašeho prostředku se nachází v horní části stránky.

  

• Zkopírujte a vložte svůj klíč a název prostředku do vhodného umístění, například Do Poznámkového bloku Microsoftu.

Úložiště Azure

• Dále potřebujete účet služby Azure Blob Storage a alespoň dva kontejnery pro zdrojové a cílové soubory:

  • Zdrojový kontejner. V tomto kontejneru nahrajete soubory pro překlad (povinné).
  • Cílový kontejner. V tomto kontejneru jsou uložené přeložené soubory (povinné).

• Pokud je váš účet úložiště za bránou firewall, musíte povolit další konfigurace:

  1. Přejděte na Azure Portal a přihlaste se ke svému účtu Azure.

  2. Vyberte svůj účet úložiště.

  3. V levém podokně skupiny Zabezpečení a sítě vyberte Sítě.

  4. Na kartě Brány firewall a virtuální sítě vyberte Povoleno z vybraných virtuálních sítí a IP adres.

     

  5. Zrušte výběr všech zaškrtávacích políček.

  6. Ujistěte se, že je vybrané síťové směrování Microsoftu.

  7. V části Instance prostředků vyberte jako typ prostředku Microsoft.CognitiveServices/accounts a jako název instance vyberte prostředek Translator.

  8. Ujistěte se, že je zaškrtnuté políčko Povolit službám Azure v seznamu důvěryhodných služeb přístup k tomuto účtu úložiště. Další informace o správěvýjimekch

     

  9. Zvolte Uložit. Rozšíření změn sítě může trvat až 5 minut.

Spravovaná identita s využitím RBAC

Než budete moct pro překlad dokumentů použít operace konektoru Translator V3, musíte svému prostředku Služby Translator udělit přístup k vašemu účtu úložiště pomocí spravované identity s řízením identit na základě role (RBAC).

Vytvoření spravované identity

Nejprve vytvořte spravovanou identitu přiřazenou systémem pro váš prostředek Translator a udělte této identitě specifická oprávnění pro přístup k vašemu účtu úložiště Azure:

1. Přejděte na Azure Portal a přihlaste se ke svému účtu Azure.

2. Vyberte prostředek Translator.

3. Ve skupině Správa prostředků v levém podokně vyberte Identita.

4. Na kartě Přiřazený systém zapněte přepínač Stav.

5. Zvolte Uložit.

   

Přiřazení role

Dále přiřaďte Storage Blob Data Contributor spravované identitě roli v oboru úložiště pro váš prostředek úložiště.

1. Přejděte na Azure Portal a přihlaste se ke svému účtu Azure.

2. Vyberte prostředek Translator.

3. Ve skupině Správa prostředků v levém podokně vyberte Identita.

4. V části Oprávnění vyberte přiřazení rolí Azure:

   

5. Na stránce přiřazení rolí Azure, která se otevřela, vyberte v rozevírací nabídce své předplatné a pak vyberte + Přidat přiřazení role.

   

6. Nakonec k prostředku služby Translator přiřaďte roli Přispěvatel dat v objektu blob služby Storage. Role Přispěvatel dat objektů blob služby Storage poskytuje službě Translator (reprezentovanou spravovanou identitou přiřazenou systémem) přístup ke čtení, zápisu a odstraňování přístupu ke kontejneru objektů blob a datům. V automaticky otevíraných otevíraných okně Přidat přiřazení role vyplňte pole následujícím způsobem a vyberte Uložit:

   Pole	Hodnota
   Scope	Úložiště:
   Předplatné	Předplatné přidružené k vašemu prostředku úložiště.
   Prostředek	Název vašeho prostředku úložiště.
   Role	Přispěvatel dat objektů blob služby Storage

7. Po zobrazení potvrzovací zprávy Přidání přiřazení role aktualizujte stránku, aby se zobrazilo přidané přiřazení role.

   

8. Pokud nové přiřazení role hned nevidíte, počkejte a zkuste stránku znovu aktualizovat. Když přiřadíte nebo odeberete přiřazení rolí, může trvat až 30 minut, než se změny projeví.

   

Konfigurace toku překladu dokumentů

Teď, když jste dokončili požadavky a počáteční nastavení, začneme pomocí konektoru Translator V3 vytvořit tok překladu dokumentů:

1. Přihlaste se do Power Automate

2. V nabídce levého bočního panelu vyberte Vytvořit .

3. V oblasti hlavního obsahu vyberte Okamžitý tok cloudu.

   

4. V místním okně pojmenujte tok a pak zvolte Ručně aktivovat tok a vyberte Vytvořit.

   

5. První krok pro okamžitý tok – Ruční aktivace toku – se zobrazí na obrazovce. Vyberte Nový krok.

   

Překlad dokumentů

Dále jsme připraveni vybrat akci. Dokumenty umístěné ve službě Azure Blob Storage nebo účtu Microsoft SharePointu můžete přeložit.

Použití služby Azure Blob Storage

Azure Blob Storage

Tady je postup překladu souboru ve službě Azure Blob Storage pomocí konektoru Translator V3:

• Zvolte konektor translatoru V3.
• Vyberte překlad dokumentu.
• Zadejte přihlašovací údaje a umístění kontejnerů služby Azure Blob Storage.
• Přeložte dokumenty, které zvolíte zdrojový a cílový jazyk.
• Získejte stav operace překladu.

1. V automaticky otevírané okně Zvolit operaci zadejte Translator V3 do vyhledávacích konektorů a akcí na panelu hledání a vyberte ikonu Microsoft Translator V3.

   

2. Vyberte akci Zahájit překlad dokumentu.

3. Pokud konektor Translator V3 používáte poprvé, musíte zadat přihlašovací údaje k prostředku:

   • Název připojení. Zadejte název připojení.

   • Klíč předplatného. Klíče prostředků Služby Translator najdete v části Správa prostředků na bočním panelu prostředku na webu Azure Portal. Zadejte jeden z vašich klíčů. Ujistěte se, že je váš prostředek Translator přiřazený k geografické oblasti, jako je USA – západ (ne globální).

   • Název prostředku služby Translator. Zadejte název prostředku Translatoru, který najdete v horní části stránky prostředku na webu Azure Portal. Vyberte Vytvořit.

     

     Poznámka:

     Po nastavení připojení nebudete muset znovu zadat přihlašovací údaje pro následné toky.

4. Zobrazí se okno akce Spustit překlad dokumentu. Vyplňte pole následujícím způsobem:

   • Typ úložiště vstupních dokumentů. Vyberte Soubor nebo složku.

   • V rozevírací nabídce vyberte zdrojový jazyk nebo ponechte výchozí možnost Automatické rozpoznání.

   • Umístění zdrojových dokumentů Zadejte adresu URL dokumentů ve zdrojovém kontejneru dokumentů Azure Storage.

   • Umístění přeložených dokumentů Zadejte adresu URL cílového kontejneru dokumentů úložiště Azure.

     Vyhledání zdrojových a cílových adres URL:

     • Na webu Azure Portal přejděte na svůj účet úložiště.

     • V levém bočním panelu v části Úložiště dat vyberte Kontejnery:

       Source	Cíl
       Zaškrtněte políčko vedle zdrojového kontejneru.	Zaškrtněte políčko vedle cílového kontejneru.
       V oblasti hlavního okna vyberte soubor nebo dokument pro překlad.	Vyberte tři tečky umístěné vpravo a pak zvolte Vlastnosti.
       Zdrojová adresa URL se nachází v horní části seznamu Vlastnosti. Vyberte ikonu Kopírovat do schránky.	Cílová adresa URL se nachází v horní části seznamu Vlastností. Vyberte ikonu Kopírovat do schránky.
       Přejděte do toku Power Automate a vložte zdrojovou adresu URL do pole Umístění zdrojového dokumentu .	Přejděte do toku Power Automate a vložte cílovou adresu URL do umístění pole přeložených dokumentů .

   • V rozevírací nabídce zvolte cílový jazyk a vyberte Uložit.

     

Získání stavu dokumentů

Teď, když jste odeslali dokumenty k překladu, zkontrolujeme stav operace.

1. Vyberte Nový krok.

2. Do vyhledávacího pole zadejte Translator V3 a zvolte Microsoft Translator V3.

3. Vyberte Možnost Získat stav dokumentů (ne akce získání stavu dokumentu s jednotným číslem).

   

4. V dalším kroku zadáte výraz, který načte operation ID hodnotu.

5. Vyberte pole ID operace. Zobrazí se rozevírací okno Výraz dynamického obsahu / .

6. Vyberte kartu Výraz a do pole funkce zadejte následující výraz:

   
      body('Start_document_translation').operationID
   
   

   

7. Vyberte OK. Funkce se zobrazí v okně ID operace. Zvolte Uložit.

   

Testování toku konektoru

Čas zkontrolovat výsledky toku a překladu dokumentů

1. V horní části stránky je zelený pruh, který označuje, že váš tok je připravený.

2. V pravém horním rohu stránky vyberte Test .

   

3. Vyberte následující tlačítka: Testovací tok → ručně → Testovat z pravého okna.

4. V dalším okně vyberte tlačítko Spustit tok .

5. Nakonec vyberte tlačítko Hotovo .

6. Měli byste obdržet zprávu o úspěšném spuštění toku a zelené značky zaškrtnutí by měly být v souladu s každým úspěšným krokem.

   

7. Vyberte krok Získat dokumenty a pak v části Výstupy vyberte Zobrazit nezpracované výstupy.

8. Zobrazí se okno Pro získání stavu dokumentů. V horní části odpovědi JSON se zobrazí "statusCode":200 oznámení, že požadavek byl úspěšný.

   

9. Jako poslední kontrolu přejděte do cílového zdrojového kontejneru služby Azure Blob Storage. Tam byste měli vidět přeložený dokument v části Přehled . Dokument může být ve složce označené kódem jazyka překladu.

Použití Microsoft SharePointu

Microsoft SharePoint

Tady je postup pro nahrání souboru z sharepointového webu do služby Azure Blob Storage, překlad souboru a vrácení přeloženého souboru do SharePointu:

• Načtěte obsah zdrojového souboru z sharepointového webu.
• Vytvořte objekt blob úložiště Azure ze zdrojového souboru.
• Přeloží zdrojový soubor.
• Získejte stav dokumentů.
• Získejte obsah a metadata objektu blob.
• Vytvořte novou složku SharePointu.
• Vytvořte přeložený soubor na SharePointu.

Získat obsah souboru

1. V automaticky otevíraných otevíraných oknech Zvolte operaci, zadejte SharePoint a pak vyberte obsah obsahu Získat soubor . Power Automate vás automaticky přihlásí k účtům SharePointu.

   

2. V okně kroku Získat obsah souboru vyplňte následující pole:

   • Adresa webu. V rozevíracím seznamu vyberte adresu URL sharepointového webu, kde se soubor nachází.
   • Identifikátor souboru. Vyberte ikonu složky a zvolte dokumenty pro překlad.

Vytvoření objektu blob úložiště

1. Vyberte Nový krok a do vyhledávacího pole zadejte Azure Blob Storage .

2. Vyberte akci Vytvořit objekt blob (V2).

3. Pokud krok úložiště Azure používáte poprvé, musíte zadat ověřování prostředků úložiště:

4. V poli Typ ověřování zvolte integrovanou aplikaci Microsoft Entra a pak vyberte tlačítko Přihlásit se.

   

5. Zvolte účet Microsoft Entra přidružený k vašim účtům prostředků Azure Blob Storage a Translatoru.

6. Po dokončení ověřování Azure Blob Storage se zobrazí krok Vytvoření objektu blob . Vyplňte pole následujícím způsobem:

   • Název účtu úložiště nebo koncový bod objektu blob Vyberte Zadat vlastní hodnotu a zadejte název účtu úložiště.

   • Cesta ke složce Vyberte ikonu složky a vyberte kontejner zdrojového dokumentu.

   • Název objektu blob Zadejte název souboru, který překládáte.

   • Obsah objektu blob Výběrem pole obsahu objektu blob zobrazte rozevírací seznam Dynamického obsahu a zvolte ikonu Obsah souboru služby SharePoint.

     

Zahájení překladu dokumentů

1. Vyberte Nový krok.

2. Do vyhledávacího pole zadejte Translator V3 a zvolte Microsoft Translator V3.

3. Vyberte akci Zahájit překlad dokumentu.

4. Pokud konektor Translator V3 používáte poprvé, musíte zadat přihlašovací údaje k prostředku:

   • Název připojení. Zadejte název připojení.

   • Klíč předplatného. Zadejte jeden z klíčů, které jste zkopírovali z webu Azure Portal.

   • Název prostředku služby Translator. Zadejte název prostředku Translatoru, který najdete v horní části stránky prostředku na webu Azure Portal.

   • Vyberte Vytvořit.

     

     Poznámka:

     Po nastavení připojení nebudete muset znovu zadat přihlašovací údaje pro následné toky služby Translator.

5. Zobrazí se okno akce Spustit překlad dokumentu. Vyplňte pole následujícím způsobem:

6. Typ úložiště vstupních dokumentů. Vyberte Soubor nebo složku.

7. V rozevírací nabídce vyberte zdrojový jazyk nebo ponechte výchozí možnost Automatické rozpoznání.

8. Umístění zdrojových dokumentů Vyberte pole a v rozevíracím seznamu Dynamického obsahu přidejte cestu následovanou názvem.

9. Umístění přeložených dokumentů Zadejte adresu URL cílového kontejneru dokumentů úložiště Azure.

   Vyhledání adresy URL cílového kontejneru:

   • Na webu Azure Portal přejděte na svůj účet úložiště.
   • Na levém bočním panelu v části Úložiště dat vyberte Kontejnery.
   • Zaškrtněte políčko vedle cílového kontejneru.
   • Vyberte tři tečky umístěné vpravo a pak zvolte Vlastnosti.
   • Cílová adresa URL se nachází v horní části seznamu Vlastností. Vyberte ikonu Kopírovat do schránky.
   • Vraťte se do toku Power Automate a vložte cílovou adresu URL do umístění pole přeložených dokumentů .

10. V rozevírací nabídce zvolte cílový jazyk a vyberte Uložit.

    

Získání stavu dokumentů

Před načtením stavu dokumentů naplánujeme 30sekundové zpoždění, abychom zajistili, že se soubor zpracuje pro překlad:

1. Vyberte Nový krok. Do vyhledávacího pole zadejte Plán a zvolte Zpoždění.

   • Počet. Zadejte 30.
   • Pro jednotku. V rozevíracím seznamu zadejte sekundu .

   

2. Vyberte Nový krok. Do vyhledávacího pole zadejte Translator V3 a zvolte Microsoft Translator V3.

3. Vyberte Získat stav dokumentů (ne stav jednotného dokumentu).

   

4. V dalším kroku zadáte výraz, který načte operation ID hodnotu.

5. Vyberte pole ID operace. Zobrazí se rozevírací okno Výraz dynamického obsahu / .

6. Vyberte kartu Výraz a do pole funkce zadejte následující výraz:

   
     body('Start_document_translation').operationID
   
   

   

7. Vyberte OK. Funkce se zobrazí v okně ID operace. Zvolte Uložit.

   

Získání obsahu a metadat objektů blob

V tomto kroku načtete přeložený dokument ze služby Azure Blob Storage a nahrajete ho do SharePointu.

1. Vyberte Nový krok, do vyhledávacího pole zadejte ovládací prvek a v seznamu Akce vyberte Použít u každého.

2. Výběrem vstupního pole zobrazte okno dynamického obsahu a vyberte hodnotu.

   

3. Vyberte Přidat akci.

   

4. Do vyhledávacího pole zadejte ovládací prvek a v seznamu Akce vyberte Provést, dokud se nezobrazí.

5. Výběrem pole Zvolit hodnotu zobrazte okno Dynamického obsahu a vyberte průběh.

6. Vyplňte tři pole následujícím způsobem: průběh → se rovná → 1:

   

7. Vyberte Přidat akci, do vyhledávacího pole zadejte Azure Blob Storage a vyberte akci Získat obsah objektu blob pomocí cesty (V2 ).

8. V poli Název účtu úložiště nebo koncový bod objektu blob vyberte Zadat vlastní hodnotu a zadejte název účtu úložiště.

9. Výběrem pole cesta k objektu blob zobrazte okno dynamického obsahu, vyberte Výraz a do pole vzorce zadejte následující logiku:

   
      concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
   
   

10. Vyberte Přidat akci, do vyhledávacího pole zadejte Azure Blob Storage a vyberte akci Získat metadata objektů blob pomocí cesty (V2 ).

11. V poli Název účtu úložiště nebo koncový bod objektu blob vyberte Zadat vlastní hodnotu a zadejte název účtu úložiště.

    

12. Vyberte pole cesta k objektu blob, aby se zobrazilo okno dynamického obsahu, vyberte Výraz a do pole vzorce zadejte následující logiku:

    
       concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
    
    

Vytvořit novou složku

1. Vyberte Přidat akci, do vyhledávacího pole zadejte SharePoint a vyberte akci Vytvořit novou složku .
2. V rozevíracím seznamu Adresa webu vyberte adresu URL SharePointu.
3. V dalším poli vyberte v rozevíracím seznamu seznam nebo knihovnu .
4. Pojmenujte novou složku a zadejte ji do pole /Folder Path/ (nezapomeňte název cesty uzavřít do lomítek).

Vytvoření sharepointového souboru

1. Vyberte Přidat akci, do vyhledávacího pole zadejte SharePoint a vyberte akci Vytvořit soubor .

2. V rozevíracím seznamu Adresa webu vyberte adresu URL SharePointu.

3. V poli Cesta ke složce v seznamu Dynamický obsah v části Vytvořit novou složku vyberte Úplnou cestu .

4. V poli Název souboru v seznamu dynamického obsahu v části Získat metadata objektů blob pomocí cesty (V2) vyberte Název .

5. V poli Obsah souboru v seznamu dynamického obsahu v části Získat metadata objektů blob pomocí cesty (V2) vyberte Obsah souboru .

6. Zvolte Uložit.

   

Testování toku konektoru

Pojďme zkontrolovat tok překladu dokumentu a výsledky.

1. V horní části stránky je zelený pruh, který označuje, že váš tok je připravený.

2. V pravém horním rohu stránky vyberte Test .

   

3. V pravém okně vyberte Testovací tok → Ručně → Test .

4. V okně Spustit tok vyberte tlačítko Pokračovat a pak tlačítka Spustit tok.

5. Nakonec vyberte tlačítko Hotovo .

6. Měla by se zobrazit zpráva o úspěšném spuštění toku a zelené značky zaškrtnutí by měly být v souladu s každým úspěšným krokem.

   

A je to! Naučili jste se automatizovat procesy překladu dokumentů pomocí konektoru Microsoft Translator V3 a Power Automate.

Další kroky

Seznámení s referenční příručkou k překladu dokumentů