Creare un flusso di traduzione di documenti (anteprima)

Importante

Il connettore Traduttore è attualmente disponibile in anteprima pubblica. Le funzionalità, gli approcci e i processi possono cambiare prima della disponibilità generale, a seconda del feedback degli utenti.

Questa esercitazione illustra come configurare un flusso cloud del connettore Microsoft Translator V3 che supporta la traduzione di documenti. Il connettore Translator V3 crea una connessione tra l'istanza del servizio Traduttore e Microsoft Power Automate, consentendo di usare una o più operazioni predefinite come passaggi nelle app e nei flussi di lavoro.

Traduzione documenti è una funzionalità API REST basata sul cloud del servizio Traduttore per Azure AI. L'API Traduzione documenti consente traduzioni di documenti multipli e complessi mantenendo al tempo stesso la struttura e il formato dei dati originali.

Contenuto dell'esercitazione:

• Creare un account di archiviazione BLOB con contenitori per i file di origine e di destinazione.
• Configurare un'identità gestita con il controllo degli accessi in base al ruolo (RBAC).
• Tradurre documenti dall'account di Archiviazione BLOB di Azure.
• Tradurre documenti dal sito di SharePoint.

Prerequisiti

Ecco cosa è necessario per iniziare: risorsa Traduttore, account di archiviazione di Azure con almeno due contenitori e un'identità gestita assegnata dal sistema con accesso basato sui ruoli.

Risorsa Traduttore

• Se non si ha un account Azure attivo, è possibile crearne uno gratuitamente.

• Creare una risorsa Traduttore a servizio singolo (non una risorsa Servizi di Azure AI multiservizio). Quando si completano i campi dei dettagli del progetto e dell'istanza di Traduttore, prestare particolare attenzione alle voci seguenti:

  • Area della risorsa. Scegliere un'area geografica come Stati Uniti occidentali (non l'area Globale).

  • Piano tariffario. Per provare il servizio, selezionare Standard S1.

• Usare la chiave e il nome della risorsa Traduttore per connettere l'applicazione a Power Automate. Le chiavi della risorsa Traduttore si trovano nella sezione Gestione risorse del portale di Azure e il nome della risorsa si trova nella parte superiore della pagina.

  

• Copiare e incollare la chiave e il nome della risorsa in una posizione comoda, ad esempio il Blocco note Microsoft.

Archiviazione di Azure

• È poi necessario un account di archiviazione BLOB di Azure e almeno due contenitori per i file di origine e di destinazione:

  • Contenitore di origine. Questo contenitore consente di caricare i file per la traduzione (obbligatorio).
  • Contenitore di destinazione. Questo contenitore è la posizione in cui vengono archiviati i file tradotti (obbligatorio).

• Se l'account di archiviazione è protetto da un firewall, è necessario abilitare ulteriori configurazioni:

  1. Passare al portale di Azure e accedere all'account Azure.

  2. Selezionare l'account di archiviazione.

  3. Nel gruppo Sicurezza e rete nel riquadro sinistro selezionare Rete.

  4. Nella scheda Firewall e reti virtuali seleziona Abilitato da reti virtuali e indirizzi IP selezionati.

     

  5. Deseleziona tutte le caselle di controllo.

  6. Assicurarsi che sia selezionato Routing di rete Microsoft.

  7. Nella sezione Istanze della risorsa selezionare Microsoft.CognitiveServices/accounts come tipo di risorsa e selezionare la risorsa Traduttore come nome dell'istanza.

  8. Assicurarsi che sia selezionata la casella di controllo Consenti ai servizi di Azure nell'elenco servizi attendibili di accedere a questo account di archiviazione. Per altre informazioni sulla gestione delle eccezioni, vedere Configurare i firewall e le reti virtuali di Archiviazione di Azure.

     

  9. Seleziona Salva. La propagazione delle modifiche di rete potrebbe richiedere fino a 5 minuti.

Identità gestita con controllo degli accessi in base al ruolo

Infine, prima di poter usare le operazioni del connettore Translator V3 per la traduzione dei documenti, è necessario concedere alla risorsa Traduttore l'accesso all'account di archiviazione usando un'identità gestita con il controllo degli accessi in base al ruolo.

Creare un'identità gestita

Creare prima di tutto un'identità gestita assegnata dal sistema per la risorsa Traduttore e concedere a tale identità autorizzazioni specifiche per accedere all'account di archiviazione di Azure:

1. Passare al portale di Azure e accedere all'account Azure.

2. Selezionare la risorsa Traduttore.

3. Nel gruppo Gestione risorse nel riquadro sinistro selezionare Identità.

4. All'interno della scheda Assegnata dal sistema attivare l'interruttore Stato.

5. Seleziona Salva.

   

Assegnazione di ruolo

Assegnare quindi un ruolo Storage Blob Data Contributor all'identità gestita nell'ambito di archiviazione per la risorsa di archiviazione.

1. Passare al portale di Azure e accedere all'account Azure.

2. Selezionare la risorsa Traduttore.

3. Nel gruppo Gestione risorse nel riquadro sinistro selezionare Identità.

4. In Autorizzazioni selezionare Assegnazioni di ruolo di Azure:

   

5. Nella pagina Assegnazioni di ruolo di Azure aperta scegliere la sottoscrizione dal menu a discesa e quindi selezionare + Aggiungi assegnazione di ruolo.

   

6. Assegnare infine un ruolo Collaboratore ai dati del BLOB di archiviazione alla risorsa del servizio Traduttore. Il ruolo Collaboratore ai dati dei BLOB di archiviazione fornisce a Traduttore, rappresentato dall'identità gestita assegnata dal sistema, l'accesso in lettura, scrittura ed eliminazione ai dati e al contenitore BLOB. Nella finestra popup Aggiungi assegnazione di ruolo completare i campi come indicato di seguito e selezionare Salva:

   Campo	Valore
   Scope	Archiviazione.
   Abbonamento	Sottoscrizione associata alla risorsa di archiviazione.
   Conto risorse	Nome della risorsa di archiviazione.
   Ruolo	Collaboratore ai dati del BLOB di archiviazione.

7. Dopo la visualizzazione del messaggio di conferma Assegnazione di ruolo aggiunta, aggiornare la pagina per visualizzarla.

   

8. Se non viene visualizzata subito la nuova assegnazione di ruolo, attendere e provare ad aggiornare nuovamente la pagina. Quando si assegnano o si rimuovono le assegnazioni di ruolo, l'applicazione delle modifiche può richiedere fino a 30 minuti.

   

Configurare un flusso di traduzione di documenti

Dopo aver completato i prerequisiti e la configurazione iniziale, è possibile iniziare a usare il connettore Translator V3 per creare il flusso di traduzione dei documenti:

1. Accedi a Power Automate.

2. Selezionare Crea dal menu della barra laterale sinistra.

3. Selezionare Flusso cloud istantaneo nell'area di contenuto principale.

   

4. Nella finestra popup assegnare un nome al flusso, scegliere Attiva un flusso manualmente e quindi selezionare Crea.

   

5. Il primo passaggio per il flusso istantaneo, ovvero Attiva un flusso manualmente, viene visualizzato sullo schermo. Seleziona Nuovo passaggio.

   

Tradurre documenti

A questo punto, è possibile selezionare un'azione. È possibile tradurre i documenti che si trovano in Archiviazione BLOB di Azure o nell'account di Microsoft SharePoint.

Usare Archiviazione BLOB di Azure

Archiviazione BLOB di Azure

Ecco i passaggi per tradurre un file in Archiviazione BLOB di Azure usando il connettore Translator V3:

• Scegliere il connettore Translator V3.
• Selezionare la traduzione dei documenti.
• Immettere le credenziali e i percorsi del contenitore di Archiviazione BLOB di Azure.
• Tradurre i documenti scegliendo le lingue di origine e di destinazione.
• Ottenere lo stato dell'operazione di traduzione.

1. Nella finestra popup Scegliere un'operazione immettere Translator V3 nella barra di ricerca Cerca connettori e azioni e quindi selezionare l'icona di Microsoft Translator V3.

   

2. Selezionare l'azione Inizia traduzione documenti.

3. Se si usa il connettore Translator V3 per la prima volta, è necessario immettere le credenziali della risorsa:

   • Nome connessione. immettere un nome per la connessione.

   • chiave di sottoscrizione. Le chiavi della risorsa Traduttore si trovano nella sezione Gestione risorse della barra laterale della risorsa nel portale di Azure. Immettere una delle chiavi. Assicurarsi che la risorsa Traduttore sia assegnata a un'area geografica, ad esempio Stati Uniti occidentali (non globale).

   • Nome della risorsa Traduttore. Immettere il nome della risorsa Traduttore disponibile nella parte superiore della pagina della risorsa nel portale di Azure. Seleziona Crea.

     

     Nota

     Dopo aver configurato la connessione, non sarà necessario immettere nuovamente le credenziali per i flussi successivi.

4. Viene ora visualizzata l'azione Inizia traduzione documenti. Compilare i campi come indicato di seguito:

   • Per Tipo di archiviazione dei documenti di input. Selezionare File o Cartella.

   • Selezionare una lingua di origine dal menu a discesa oppure mantenere l'opzione predefinita Rilevamento automatico.

   • Posizione dei documenti di origine. Immettere l'URL dei documenti nel contenitore dei documenti di origine dello spazio di archiviazione di Azure.

   • Posizione dei documenti tradotti. Immettere l'URL per il contenitore dei documenti di destinazione dell'archiviazione di Azure.

     Per trovare gli URL di origine e di destinazione:

     • Passare all'account di archiviazione nel portale di Azure.

     • Nella barra laterale sinistra, in Archiviazione dati selezionare Contenitori:

       Origine	Target
       Selezionare la casella di controllo accanto al contenitore di origine	Selezionare la casella di controllo accanto al contenitore di destinazione.
       Nell'area della finestra principale selezionare un file o un documento per la traduzione.	Selezionare i puntini di sospensione a destra e quindi scegliere Proprietà.
       L'URL di origine si trova nella parte superiore dell'elenco Proprietà. Selezionare l'icona Copia negli Appunti.	L'URL di destinazione si trova nella parte superiore dell'elenco Proprietà. Selezionare l'icona Copia negli Appunti.
       Passare al flusso di Power Automate e incollare l'URL di origine nel campo Posizione dei documenti di origine.	Passare al flusso di Power Automate e incollare l'URL di destinazione nel campo Posizione dei documenti di tradotti.

   • Scegliere una Lingua di destinazione dal menu a discesa e selezionare Salva.

     

Ottenere lo stato dei documenti

Dopo aver inviato i documenti per la traduzione, è necessario controllare lo stato dell'operazione.

1. Seleziona Nuovo passaggio.

2. Immettere Translator V3 nella casella di ricerca e scegliere Microsoft Translator V3.

3. Selezionare Ottenere lo stato dei documenti (non l'azione al singolare Ottenere lo stato del documento).

   

4. Si immetterà quindi un'espressione per recuperare il valore operation ID.

5. Selezionare il campo ID operazione. Viene visualizzata una finestra a discesa Contenuto dinamico / Espressione.

6. Selezionare la scheda Espressione e immettere l'espressione seguente nel campo della funzione:

   
      body('Start_document_translation').operationID
   
   

   

7. Seleziona OK. La funzione viene visualizzata nella finestra ID operazione. Seleziona Salva.

   

Testare il flusso del connettore

È ora di controllare il flusso e i risultati della traduzione dei documenti.

1. Nella parte superiore della pagina è presente una barra verde che indica che Il flusso è pronto per l'uso.

2. Selezionare Test nell'angolo superiore destro della pagina.

   

3. Selezionare i pulsanti seguenti: Flusso di test → Manuale → Test nella finestra a destra.

4. Nella finestra successiva selezionare il pulsante Esegui flusso.

5. Infine, selezionare il pulsante Fine.

6. Si dovrebbe ricevere un messaggio Il flusso è stato eseguito correttamente e verranno visualizzati segni di spunta verdi per ogni passaggio riuscito.

   

7. Selezionare il passaggio Ottenere lo stato dei documenti, quindi selezionare Mostra output non elaborati nella sezione Output.

8. Viene visualizzata la finestra Ottenere lo stato dei documenti. Nella parte superiore della risposta JSON viene visualizzato "statusCode":200 che indica che la richiesta ha avuto esito positivo.

   

9. Come controllo finale, passare al contenitore di origine di destinazione di Archiviazione BLOB di Azure. Il documento tradotto dovrebbe essere qui visualizzato nella sezione Panoramica. Il documento potrebbe trovarsi in una cartella con un'etichetta corrispondente al codice della lingua di traduzione.

Usare Microsoft SharePoint

Microsoft SharePoint

Ecco i passaggi per caricare un file dal sito di SharePoint in Archiviazione BLOB di Azure, tradurre il file e restituire il file tradotto in SharePoint:

• Recuperare il contenuto del file di origine dal sito di SharePoint.
• Creare un BLOB di archiviazione di Azure dal file di origine.
• Tradurre il file di origine.
• Ottenere lo stato dei documenti.
• Ottenere il contenuto e i metadati del BLOB.
• Creare una nuova cartella di SharePoint.
• Creare il file tradotto in SharePoint.

Ottieni contenuto del file

1. Nella finestra popup Scegliere un'operazione, immettere SharePoint e quindi selezionare Ottieni contenuto file. Power Automate esegue automaticamente l'accesso agli account di SharePoint.

   

2. Nella finestra del passaggio Ottieni contenuto file completare i campi seguenti:

   • Indirizzo del sito. Selezionare l'URL del sito di SharePoint in cui si trova il file dall'elenco a discesa.
   • Identificatore file. Selezionare l'icona della cartella e scegliere i documenti da tradurre.

Creare un BLOB di archiviazione

1. Selezionare Nuovo passaggio e immettere Archiviazione BLOB di Azure nella casella di ricerca.

2. Selezionare l'azione Crea BLOB (V2).

3. Se si usa il passaggio di archiviazione di Azure per la prima volta, è necessario immettere l'autenticazione per la risorsa di archiviazione:

4. Nel campo Tipo di autenticazione scegliere Integrata con Microsoft Entra e quindi selezionare il pulsante Accedi.

   

5. Scegliere l'account Microsoft Entra associato agli account di Archiviazione BLOB di Azure e Risorse di Traduttore.

6. Dopo aver completato l'autenticazione di Archiviazione BLOB di Azure viene visualizzato il passaggio Crea BLOB. Compilare i campi come indicato di seguito:

   • Nome dell'account di archiviazione o dell'endpoint BLOB. Selezionare Immetti valore personalizzato e immettere il nome dell'account di archiviazione.

   • Percorso cartella. Selezionare l'icona della cartella e selezionare il contenitore del documento di origine.

   • Nome BLOB. Immettere il nome del file che si sta traducendo.

   • Contenuto BLOB. Selezionare il campo Contenuto BLOB per visualizzare l'elenco a discesa Contenuto dinamico e scegliere l'icona Contenuto file di SharePoint.

     

Iniziare la traduzione dei documenti

1. Seleziona Nuovo passaggio.

2. Immettere Translator V3 nella casella di ricerca e scegliere Microsoft Translator V3.

3. Selezionare l'azione Inizia traduzione documenti.

4. Se si usa il connettore Translator V3 per la prima volta, è necessario immettere le credenziali della risorsa:

   • Nome connessione. immettere un nome per la connessione.

   • chiave di sottoscrizione. Immettere una delle chiavi copiate dal portale di Azure.

   • Nome della risorsa Traduttore. Immettere il nome della risorsa Traduttore disponibile nella parte superiore della pagina della risorsa nel portale di Azure.

   • Seleziona Crea.

     

     Nota

     Dopo aver configurato la connessione, non sarà necessario immettere nuovamente le credenziali per i flussi di Traduttore successivi.

5. Viene ora visualizzata l'azione Inizia traduzione documenti. Compilare i campi come indicato di seguito:

6. Per Tipo di archiviazione dei documenti di input. Selezionare File o Cartella.

7. Selezionare una lingua di origine dal menu a discesa oppure mantenere l'opzione predefinita Rilevamento automatico.

8. Posizione dei documenti di origine. Selezionare il campo e aggiungere Percorso seguito da Nome dall'elenco a discesa Contenuto dinamico.

9. Posizione dei documenti tradotti. Immettere l'URL per il contenitore dei documenti di destinazione dell'archiviazione di Azure.

   Per trovare l'URL del contenitore di destinazione:

   • Passare all'account di archiviazione nel portale di Azure.
   • Nella barra laterale sinistra, in Archiviazione dati selezionare Contenitori.
   • Selezionare la casella di controllo accanto al contenitore di destinazione.
   • Selezionare i puntini di sospensione a destra e quindi scegliere Proprietà.
   • L'URL di destinazione si trova nella parte superiore dell'elenco Proprietà. Selezionare l'icona Copia negli Appunti.
   • Tornare al flusso di Power Automate e incollare l'URL di destinazione nel campo Posizione dei documenti di tradotti.

10. Scegliere una Lingua di destinazione dal menu a discesa e selezionare Salva.

    

Ottenere lo stato dei documenti

Prima di recuperare lo stato dei documenti, è necessario pianificare un ritardo di 30 secondi per assicurarsi che il file venga elaborato per la traduzione:

1. Seleziona Nuovo passaggio. Immettere Pianificazione nella casella di ricerca e scegliere Ritardo.

   • Per Numero. Immettere 30.
   • Per Unità. Immettere Secondo dall'elenco a discesa.

   

2. Seleziona Nuovo passaggio. Immettere Translator V3 nella casella di ricerca e scegliere Microsoft Translator V3.

3. Selezionare Ottenere lo stato dei documenti (non l'azione al singolare Ottenere lo stato del documento).

   

4. Si immetterà quindi un'espressione per recuperare il valore operation ID.

5. Selezionare il campo ID operazione. Viene visualizzata una finestra a discesa Contenuto dinamico / Espressione.

6. Selezionare la scheda Espressione e immettere l'espressione seguente nel campo della funzione:

   
     body('Start_document_translation').operationID
   
   

   

7. Seleziona OK. La funzione viene visualizzata nella finestra ID operazione. Seleziona Salva.

   

Ottenere il contenuto e i metadati del BLOB

In questo passaggio si recupera il documento tradotto da Archiviazione BLOB di Azure e lo si carica in SharePoint.

1. Selezionare Nuovo passaggio, immettere Controllo nella casella di ricerca e selezionare Apply to each dall'elenco Azioni.

2. Selezionare il campo di input per visualizzare la finestra Contenuto dinamico e selezionare valore.

   

3. Seleziona Aggiungi un'azione.

   

4. Immettere Controllo nella casella di ricerca e selezionare Do until dall'elenco Azioni.

5. Selezionare il campo Scegli un valore per visualizzare la finestra Contenuto dinamico e selezionare stato di avanzamento.

6. Completare i tre campi come segue: stato di avanzamento → è uguale a → 1:

   

7. Selezionare Aggiungere un'azione, immettere Archiviazione BLOB di Azure nella casella di ricerca e selezionare l'azione Recupera contenuto BLOB in base al percorso (V2).

8. Nel campo Nome dell'account di archiviazione o dell'endpoint BLOB selezionare Immetti valore personalizzato e immettere il nome dell'account di archiviazione.

9. Selezionare il campo Percorso BLOB per visualizzare la finestra Contenuto dinamico, quindi selezionare Espressione e immettere la logica seguente nel campo della formula:

   
      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. Selezionare Aggiungere un'azione, immettere Archiviazione BLOB di Azure nella casella di ricerca e selezionare l'azione Recupera metadati del BLOB in base al percorso (V2).

11. Nel campo Nome dell'account di archiviazione o dell'endpoint BLOB selezionare Immetti valore personalizzato e immettere il nome dell'account di archiviazione.

    

12. Selezionare il campo Percorso BLOB per visualizzare la finestra Contenuto dinamico, selezionare Espressione e immettere la logica seguente nel campo della formula:

    
       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])
    
    

Creare una nuova cartella

1. Selezionare Aggiungere un'azione, immettere SharePoint nella casella di ricerca e selezionare l'azione Crea nuova cartella.
2. Selezionare l'URL di SharePoint nella finestra a discesa Indirizzo sito.
3. Nel campo successivo selezionare un Elenco o raccolta dall'elenco a discesa.
4. Assegnare un nome alla nuova cartella e immetterlo nel campo /Percorso cartella/ (assicurarsi di racchiudere il nome del percorso tra barre).

Creare un file di SharePoint

1. Selezionare Aggiungere un'azione, immettere SharePoint nella casella di ricerca e selezionare l'azione Crea file.

2. Selezionare l'URL di SharePoint nella finestra a discesa Indirizzo sito.

3. Nel campo Percorso cartella selezionare Percorso completo in Crea nuova cartella nell'elenco Contenuto dinamico.

4. Nel campo Nome file selezionare Nome in Recupera metadati BLOB in base al percorso (V2 ) nell'elenco Contenuto dinamico.

5. Nel campo Nome file selezionare Contenuto del file in Recupera metadati BLOB in base al percorso (V2 ) nell'elenco Contenuto dinamico.

6. Seleziona Salva.

   

Testare il flusso del connettore

A questo punto, è possibile controllare il flusso e i risultati della traduzione dei documenti.

1. Nella parte superiore della pagina è presente una barra verde che indica che Il flusso è pronto per l'uso.

2. Selezionare Test nell'angolo superiore destro della pagina.

   

3. Selezionare Flusso di test → Manuale → Test nella finestra a destra.

4. Nella finestra Esegui flusso selezionare i pulsanti Continua e quindi Esegui flusso.

5. Infine, selezionare il pulsante Fine.

6. Si dovrebbe ricevere un messaggio "Il flusso è stato eseguito correttamente" e verranno visualizzati segni di spunta verdi per ogni passaggio riuscito.

   

Ecco fatto! Si è appreso come automatizzare i processi di traduzione di documenti usando il connettore Microsoft Translator V3 e Power Automate.

Passaggi successivi

Esplorare la guida di riferimento sulla traduzione di documenti