문서 번역 흐름 만들기(미리 보기)

Important

번역기 커넥터는 현재 공개 미리 보기로 제공됩니다. 기능, 방식 및 프로세스는 GA(일반 공급) 전에 사용자 피드백에 따라 변경될 수 있습니다.

이 자습서에서는 문서 번역을 지원하는 Microsoft 번역기 V3 커넥터 클라우드 흐름을 구성하는 과정을 안내합니다. 번역기 V3 커넥터는 번역기 서비스 인스턴스와 Microsoft Power Automate 간의 연결을 생성하여 하나 이상의 사전 빌드된 작업을 앱 및 워크플로의 단계로 사용할 수 있도록 합니다.

문서 번역은 Azure AI 번역기 서비스의 클라우드 기반 REST API 기능입니다. 문서 번역 API를 사용하면 원본 문서 구조와 데이터 형식을 유지하면서 여러 개의 복잡한 문서 번역이 가능합니다.

이 자습서에서:

• 원본 및 대상 파일용 컨테이너가 포함된 Blob 스토리지 계정을 만듭니다.
• 역할 기반 액세스 제어(RBAC)를 사용하여 관리 ID를 설정합니다.
• Azure Blob Storage 계정의 문서를 번역합니다.
• SharePoint 사이트의 문서를 번역하세요.

필수 조건

시작하려면 다음이 필요합니다. 번역기 리소스, 2개 이상의 컨테이너가 포함된 Azure 스토리지 계정 및 역할 기반 액세스 권한이 있는 시스템 할당 관리 ID입니다.

Translator 리소스

• 활성 Azure 계정이 없으면 무료로 계정을 만들 수 있습니다.

• 단일 서비스 번역기 리소스(다중 서비스 Azure AI 서비스 리소스가 아님)를 만듭니다. 번역기 프로젝트 및 인스턴스 세부 정보 필드를 완료할 때 다음 항목에 특히 주의하세요.

  • 리소스 지역. 미국 서부와 같은 지리적 지역을 선택합니다(글로벌 지역이 아님).

  • 가격 책정 계층. 서비스를 사용해 보려면 표준 S1을 선택하세요.

• 번역기 리소스의 키 및 이름을 사용하여 애플리케이션을 Power Automate에 연결합니다. 번역기 리소스 키는 Azure portal의 리소스 관리 섹션 아래에 있으며 리소스 이름은 페이지 상단에 있습니다.

  

• Microsoft 메모장과 같은 편리한 위치에 키와 리소스 이름을 복사하여 붙여넣으세요.

Azure Storage

• 다음으로, 원본 및 대상 파일을 위한 Azure Blob Storage 계정과 2개 이상의 컨테이너가 필요합니다.

  • 원본 컨테이너. 이 컨테이너는 번역을 위해 파일을 업로드하는 위치입니다(필수).
  • 대상 컨테이너. 이 컨테이너는 번역된 파일이 저장되는 곳입니다(필수).

• 스토리지 계정이 방화벽으로 보호되는 경우 추가 구성을 활성화해야 합니다.

  1. Azure Portal로 이동하여 Azure 계정에 로그인합니다.

  2. 스토리지 계정을 선택합니다.

  3. 왼쪽 창의 보안 + 네트워킹 그룹에서 네트워킹을 선택합니다.

  4. 방화벽 및 가상 네트워크 탭에서 선택한 가상 네트워크 및 IP 주소에서 사용을 선택합니다.

     

  5. 모든 확인란을 선택 취소합니다.

  6. Microsoft 네트워크 라우팅이 선택되어 있는지 확인합니다.

  7. 리소스 인스턴스 섹션에서 Microsoft.CognitiveServices/accounts를 리소스 종류로 선택하고 Translator 리소스를 인스턴스 이름으로 선택합니다.

  8. 신뢰할 수 있는 서비스 목록의 Azure 서비스에서 이 스토리지 계정에 액세스하도록 허용 확인란이 선택되어 있는지 확인합니다. 예외 관리에 대한 자세한 내용은 Azure Storage 방화벽 및 가상 네트워크 구성을 참조하세요.

     

  9. 저장을 선택합니다. 네트워크 변경 내용이 전파되는 데 최대 5분이 걸릴 수 있습니다.

RBAC를 사용한 관리 ID

마지막으로 문서 번역을 위해 번역기 V3 커넥터의 작업을 사용하려면 먼저 RBAC(역할 기반 ID 제어)가 포함된 관리 ID를 사용하여 스토리지 계정에 번역기 리소스 액세스 권한을 부여해야 합니다.

관리 ID 만들기

먼저 번역기 리소스에 대한 시스템 할당 관리 ID를 만들고 해당 ID에 Azure Storage 계정에 액세스할 수 있는 특정 권한을 부여합니다.

1. Azure Portal로 이동하여 Azure 계정에 로그인합니다.

2. Translator 리소스를 선택합니다.

3. 왼쪽 창의 리소스 관리 그룹에서 ID를 선택합니다.

4. 시스템 할당 탭 내에서 상태 토글을 켭니다.

5. 저장을 선택합니다.

   

역할 할당

그런 다음 스토리지 리소스의 스토리지 범위에 있는 관리 ID 에 Storage Blob Data Contributor 역할을 할당합니다.

1. Azure Portal로 이동하여 Azure 계정에 로그인합니다.

2. Translator 리소스를 선택합니다.

3. 왼쪽 창의 리소스 관리 그룹에서 ID를 선택합니다.

4. 권한에서 Azure 역할 할당을 선택합니다.

   

5. 열린 Azure 역할 할당 페이지의 드롭다운 메뉴에서 구독을 선택한 다음, + 역할 할당 추가를 선택합니다.

   

6. 마지막으로 번역기 서비스 리소스에 Storage Blob 데이터 기여자 역할을 할당합니다. Storage Blob 데이터 기여자 역할은 Blob 컨테이너 및 데이터에 대한 읽기, 쓰기 및 삭제 권한을 Translator(시스템 할당 관리 ID로 표시됨)에 제공합니다. 역할 할당 추가 팝업 창에서 다음과 같이 필드를 완료하고 저장을 선택합니다.

   필드	값
   범위	저장.
   구독	스토리지 리소스와 연결된 구독입니다.
   리소스	스토리지 리소스의 이름.
   역할	Storage Blob 데이터 기여자.

7. 추가된 역할 할당 확인 메시지가 표시된 후 페이지를 새로 고쳐 추가된 역할 할당을 확인합니다.

   

8. 새로운 역할 할당이 즉시 표시되지 않으면 기다렸다가 페이지를 한 번 더 새로 고쳐 보세요. 역할 할당을 할당하거나 제거하는 경우 변경 내용이 적용되는 데 최대 30분이 걸릴 수 있습니다.

   

문서 번역 흐름 구성

이제 필수 구성 요소와 초기 설정을 완료했으므로 Translator V3 커넥터를 사용하여 문서 번역 흐름을 만들어 보겠습니다.

1. Power Automate에 로그인합니다.

2. 왼쪽 사이드바 메뉴에서 만들기를 선택합니다.

3. 기본 콘텐츠 영역에서 인스턴트 클라우드 흐름을 선택합니다.

   

4. 팝업 창에서 흐름 이름을 지정한 다음 수동으로 흐름 트리거를 선택하고 만들기를 선택합니다.

   

5. 인스턴트 흐름의 첫 번째 단계인 수동으로 흐름 트리거가 화면에 나타납니다. 새 단계를 선택합니다.

   

문서 번역

다음으로 작업을 선택할 준비가 되었습니다. Azure Blob Storage 또는 Microsoft SharePoint 계정에 있는 문서를 번역할 수 있습니다.

Azure Blob 스토리지 사용

Azure Blob Storage

번역기 V3 커넥터를 사용하여 Azure Blob Storage에서 파일을 번역하는 단계는 다음과 같습니다.

• 번역기 V3 커넥터를 선택하세요.
• 문서 번역을 선택하세요.
• Azure Blob Storage 자격 증명 및 컨테이너 위치를 입력합니다.
• 원본 및 대상 언어를 선택하여 문서를 번역하세요.
• 번역 작업 상태를 가져옵니다.

1. 작업 선택 팝업 창에서 커넥터 및 작업 검색 검색창에 번역기 V3를 입력하고 Microsoft 번역기 V3 아이콘을 선택합니다.

   

2. 문서 번역 시작 작업을 선택합니다.

3. 번역기 V3 커넥터를 처음 사용하는 경우 리소스 자격 증명을 입력해야 합니다.

   • 연결 이름. 연결의 이름을 입력합니다.

   • 구독 키. 번역기 리소스 키는 Azure portal 리소스 사이드바의 리소스 관리 섹션 아래에 있습니다. 키 중 하나를 입력하세요. 번역기 리소스가 미국 서부와 같은 지리적 지역에 할당되어 있는지 확인하세요(전역 아님).

   • 번역기 리소스 이름. Azure portal의 리소스 페이지 상단에 있는 번역기 리소스의 이름을 입력합니다. 만들기를 실행합니다.

     

     참고 항목

     연결을 설정한 후에는 후속 흐름에 대해 자격 증명을 다시 입력할 필요가 없습니다.

4. 이제 문서 번역 시작 작업 창이 나타납니다. 다음과 같이 필드를 완성하세요.

   • 입력 문서의 저장 유형입니다. 파일 또는 폴더를 선택합니다.

   • 드롭다운 메뉴에서 출발어를 선택하거나 기본 자동 탐지 옵션을 유지하세요.

   • 원본 문서의 위치. Azure Storage 원본 문서 컨테이너에 문서의 URL을 입력합니다.

   • 번역된 문서의 위치. Azure Storage 대상 문서 컨테이너의 URL을 입력합니다.

     원본 및 대상 URL을 찾으려면:

     • Azure Portal의 스토리지 계정으로 이동합니다.

     • 왼쪽 사이드바의 데이터 스토리지 아래에서 컨테이너를 선택합니다.

       원본	대상
       원본 컨테이너 옆에 있는 확인란을 선택합니다.	대상 컨테이너 옆의 확인란을 선택합니다.
       메인 창 영역에서 번역할 파일이나 문서를 선택하세요.	오른쪽에 있는 타원을 선택한 다음 속성을 선택합니다.
       원본 URL은 속성 목록 상단에 있습니다. 클립보드에 복사 아이콘을 선택합니다.	대상 URL은 속성 목록 상단에 있습니다. 클립보드에 복사 아이콘을 선택합니다.
       Power Automate 흐름으로 이동하여 원본 문서 위치 필드에 원본 URL을 붙여넣습니다.	Power Automate 흐름으로 이동하여 번역된 문서 위치 필드에 대상 URL을 붙여넣습니다.

   • 드롭다운 메뉴에서 대상 언어를 선택하고 저장을 선택합니다.

     

문서 상태 가져오기

이제 번역을 위해 문서를 제출했으므로 작업 상태를 확인해 보겠습니다.

1. 새 단계를 선택합니다.

2. 검색창에 번역기 V3를 입력하고 Microsoft 번역기 V3를 선택합니다.

3. 문서 상태 가져오기(단일 문서 상태 가져오기 작업 아님)를 선택합니다.

   

4. 다음으로 operation ID 값을 검색하는 식을 입력하겠습니다.

5. 작업 ID 필드를 선택합니다. 동적 콘텐츠 / 식 드롭다운 창이 나타납니다.

6. 식 탭을 선택하고 함수 필드에 다음 식을 입력합니다.

   
      body('Start_document_translation').operationID
   
   

   

7. 확인을 선택합니다. 함수가 작업 ID 창에 나타납니다. 저장을 선택합니다.

   

커넥터 흐름 테스트

흐름과 문서 번역 결과를 확인하는 시간입니다.

1. 페이지 상단에 흐름을 시작할 준비가 되었습니다를 나타내는 녹색 막대가 있습니다.

2. 페이지 오른쪽 상단에서 테스트를 선택합니다.

   

3. 오른쪽 창에서 테스트 흐름 → 수동 → 테스트 버튼을 선택합니다.

4. 다음 창에서 흐름 실행 버튼을 선택합니다.

5. 마지막으로 완료 버튼을 선택합니다.

6. 흐름이 성공적으로 실행되었습니다 메시지가 표시되고 각 성공적인 단계에 녹색 확인 표시가 표시됩니다.

   

7. 문서 상태 가져오기 단계를 선택한 다음 출력 섹션에서 원시 출력 표시를 선택합니다.

8. 문서 상태 가져오기 창이 나타납니다. JSON 응답 상단에 요청이 성공했음을 나타내는 "statusCode":200이(가) 표시됩니다.

   

9. 마지막 확인으로 Azure Blob Storage 대상 원본 컨테이너로 이동합니다. 개요 섹션에 번역된 문서가 표시됩니다. 문서는 번역 언어 코드가 표시된 폴더에 있을 수 있습니다.

Microsoft SharePoint 사용

Microsoft SharePoint

SharePoint 사이트에서 Azure Blob Storage로 파일을 업로드하고, 파일을 번역하고, 번역된 파일을 SharePoint로 반환하는 단계는 다음과 같습니다.

• SharePoint 사이트에서 원본 파일 콘텐츠를 검색합니다.
• 원본 파일에서 Azure Storage Blob을 생성합니다.
• 원본 파일을 번역합니다.
• 문서 상태를 확인하세요.
• Blob 콘텐츠 및 메타데이터를 가져옵니다.
• 새 SharePoint 폴더를 만듭니다.
• Sharepoint에서 번역된 파일을 만듭니다.

파일 콘텐츠 가져오기

1. 작업 선택 팝업 창에서 SharePoint를 입력한 다음 파일 콘텐츠 가져오기 콘텐츠를 선택합니다. Power Automate는 자동으로 SharePoint 계정에 로그인합니다.

   

2. 파일 콘텐츠 가져오기 단계 창에서 다음 필드를 완성합니다.

   • 사이트 주소. 드롭다운 목록에서 파일이 있는 SharePoint 사이트 URL을 선택합니다.
   • 파일 식별자. 폴더 아이콘을 선택하고 번역할 문서를 선택하세요.

스토리지 Blob 만들기

1. 새 단계를 선택하고 검색창에 Azure Blob Storage를 입력합니다.

2. BLOB 생성(V2) 작업을 선택합니다.

3. Azure Storage 단계를 처음으로 사용하는 경우 스토리지 리소스 인증을 입력해야 합니다.

4. 인증 유형 필드에서 Microsoft Entra 통합을 선택한 다음 로그인 단추를 선택합니다.

   

5. Azure Blob Storage 및 번역기 리소스 계정과 연결된 Microsoft Entra 계정을 선택합니다.

6. Azure Blob Storage 인증을 완료하면 Blob 만들기 단계가 나타납니다. 다음과 같이 필드를 완성하세요.

   • 스토리지 계정 이름 또는 blob 엔드포인트. 사용자 지정 값 입력을 선택하고 스토리지 계정 이름을 입력합니다.

   • 폴더 경로. 폴더 아이콘을 선택하고 원본 문서 컨테이너를 선택합니다.

   • Blob 이름. 번역하려는 파일의 이름을 입력하세요.

   • Blob 콘텐츠. Blob 콘텐츠 필드를 선택하여 동적 콘텐츠 드롭다운 목록을 표시하고 SharePoint 파일 콘텐츠 아이콘을 선택합니다.

     

문서 번역 시작

1. 새 단계를 선택합니다.

2. 검색창에 번역기 V3를 입력하고 Microsoft 번역기 V3를 선택합니다.

3. 문서 번역 시작 작업을 선택합니다.

4. 번역기 V3 커넥터를 처음 사용하는 경우 리소스 자격 증명을 입력해야 합니다.

   • 연결 이름. 연결의 이름을 입력합니다.

   • 구독 키. Azure portal에서 복사한 키 중 하나를 입력하세요.

   • 번역기 리소스 이름. Azure portal의 리소스 페이지 상단에 있는 번역기 리소스의 이름을 입력합니다.

   • 만들기를 실행합니다.

     

     참고 항목

     연결을 설정한 후에는 후속 번역기 흐름에 대한 자격 증명을 다시 입력할 필요가 없습니다.

5. 이제 문서 번역 시작 작업 창이 나타납니다. 다음과 같이 필드를 완성하세요.

6. 입력 문서의 저장 유형입니다. 파일 또는 폴더를 선택합니다.

7. 드롭다운 메뉴에서 출발어를 선택하거나 기본 자동 탐지 옵션을 유지하세요.

8. 원본 문서의 위치. 필드를 선택하고 동적 콘텐츠 드롭다운 목록에서 경로와 이름을 차례로 추가합니다.

9. 번역된 문서의 위치. Azure Storage 대상 문서 컨테이너의 URL을 입력합니다.

   대상 컨테이너 URL을 찾으려면:

   • Azure Portal의 스토리지 계정으로 이동합니다.
   • 왼쪽 사이드바의 데이터 스토리지 아래에서 컨테이너를 선택합니다.
   • 대상 컨테이너 옆의 확인란을 선택합니다.
   • 오른쪽에 있는 타원을 선택한 다음 속성을 선택합니다.
   • 대상 URL은 속성 목록 상단에 있습니다. 클립보드에 복사 아이콘을 선택합니다.
   • Power Automate 흐름으로 돌아가서 번역된 문서 위치 필드에 대상 URL을 붙여넣습니다.

10. 드롭다운 메뉴에서 대상 언어를 선택하고 저장을 선택합니다.

    

문서 상태 가져오기

문서 상태를 검색하기 전에 파일이 번역 처리되었는지 확인하기 위해 30초 지연을 예약해 보겠습니다.

1. 새 단계를 선택합니다. 검색창에 일정을 입력하고 지연을 선택합니다.

   • 개수의 경우. 30을 입력합니다.
   • 단위용. 드롭다운 목록에서 초를 입력합니다.

   

2. 새 단계를 선택합니다. 검색창에 번역기 V3를 입력하고 Microsoft 번역기 V3를 선택합니다.

3. 문서 상태 가져오기(단수 문서 상태 가져오기 아님)를 선택합니다.

   

4. 다음으로 operation ID 값을 검색하는 식을 입력하겠습니다.

5. 작업 ID 필드를 선택합니다. 동적 콘텐츠 / 식 드롭다운 창이 나타납니다.

6. 식 탭을 선택하고 함수 필드에 다음 식을 입력합니다.

   
     body('Start_document_translation').operationID
   
   

   

7. 확인을 선택합니다. 함수가 작업 ID 창에 나타납니다. 저장을 선택합니다.

   

Blob 콘텐츠 및 메타데이터 가져오기

이 단계에서는 Azure Blob Storage에서 번역된 문서를 검색하여 SharePoint에 업로드합니다.

1. 새 단계를 선택하고 검색창에 Control을 입력한 다음 작업 목록에서 각 단계에 적용을 선택합니다.

2. 입력 필드를 선택하여 동적 콘텐츠 창을 표시하고 값을 선택합니다.

   

3. 작업 추가를 선택합니다.

   

4. 검색창에 Control을 입력하고 작업 목록에서 기한을 선택합니다.

5. 값 선택 필드를 선택하여 동적 콘텐츠 창을 표시하고 진행률을 선택합니다.

6. 다음과 같이 세 개의 필드를 완성합니다. 진행률 → 같음 → 1:

   

7. 작업 추가를 선택하고 검색창에 Azure Blob Storage를 입력한 다음 경로를 사용하여 Blob 콘텐츠 가져오기(V2) 작업을 선택합니다.

8. 스토리지 계정 이름 또는 blob 엔드포인트 필드에서 사용자 지정 값 입력을 선택하고 스토리지 계정 이름을 입력합니다.

9. Blob 경로 필드를 선택하여 동적 콘텐츠 창을 표시하고, 식을 선택한 후 수식 필드에 다음 논리를 입력합니다.

   
      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. 작업 추가를 선택하고 검색창에 Azure Blob Storage를 입력한 다음 경로(V2)를 사용하여 Blob 메타데이터 가져오기 작업을 선택합니다.

11. 스토리지 계정 이름 또는 blob 엔드포인트 필드에서 사용자 지정 값 입력을 선택하고 스토리지 계정 이름을 입력합니다.

    

12. Blob 경로 필드를 선택하여 동적 콘텐츠 창을 표시하고, 식을 선택한 후 수식 필드에 다음 논리를 입력합니다.

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

새 폴더 만들기

1. 작업 추가를 선택하고 검색창에 SharePoint를 입력한 다음 새 폴더 만들기 작업을 선택합니다.
2. 사이트 주소 드롭다운 창에서 SharePoint URL을 선택합니다.
3. 다음 필드의 드롭다운에서 목록 또는 라이브러리를 선택합니다.
4. 새 폴더의 이름을 지정하고 이를 /Folder Path/ 필드에 입력합니다(경로 이름을 슬래시로 묶어야 함).

SharePoint 파일 만들기

1. 작업 추가를 선택하고 검색창에 SharePoint를 입력한 다음 파일 만들기 작업을 선택합니다.

2. 사이트 주소 드롭다운 창에서 SharePoint URL을 선택합니다.

3. 폴더 경로 필드의 동적 콘텐츠 목록에 있는 새 폴더 만들기에서 전체 경로를 선택합니다.

4. 파일 이름 필드의 동적 콘텐츠 목록에 있는 경로를 사용하여 Blob 메타데이터 가져오기(V2) 아래에서 이름을 선택합니다.

5. 파일 콘텐츠 필드의 동적 콘텐츠 목록에 있는 경로를 사용하여 Blob 메타데이터 가져오기(V2)에서 파일 콘텐츠를 선택합니다.

6. 저장을 선택합니다.

   

커넥터 흐름 테스트

문서 번역 흐름과 결과를 확인해 보세요.

1. 페이지 상단에 흐름이 준비되었습니다.를 나타내는 녹색 막대가 있습니다.

2. 페이지 오른쪽 상단에서 테스트를 선택합니다.

   

3. 오른쪽 창에서 테스트 흐름 → 수동 → 테스트를 선택합니다.

4. 흐름 실행 창에서 계속을 선택한 다음 흐름 실행 버튼을 선택합니다.

5. 마지막으로 완료 버튼을 선택합니다.

6. "흐름이 성공적으로 실행되었습니다"라는 메시지가 표시되고 각 성공적인 단계에 녹색 확인 표시가 표시됩니다.

   

정말 간단하죠. Microsoft Translator V3 커넥터 및 Power Automate를 사용하여 문서 번역 프로세스를 자동화하는 방법을 알아보았습니다.

다음 단계

문서 번역 참조 가이드 살펴보기