다음을 통해 공유

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

  • 아티클

Important

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

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

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

이 자습서에서:

필수 조건

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

Translator 리소스

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

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

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

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

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

    Get key and endpoint.

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

Azure Storage

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

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

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

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

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

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

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

      Screenshot: Selected networks radio button selected.

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

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

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

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

      Screenshot: allow trusted services checkbox, portal view.

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

RBAC를 사용한 관리 ID

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

Screenshot of managed identity flow (RBAC).

관리 ID 만들기

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

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

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

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

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

  5. 저장을 선택합니다.

    Screenshot: resource management identity tab in the Azure portal.

역할 할당

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

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

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

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

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

    Screenshot: enable system-assigned managed identity in Azure portal.

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

    Screenshot: Azure role assignments page in the Azure portal.

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

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

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

    Screenshot: Added role assignment confirmation pop-up message.

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

    Screenshot: Azure role assignments window.

문서 번역 흐름 구성

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

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

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

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

    Screenshot showing how to create an instant cloud flow.

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

    Screenshot showing how to manually trigger a flow.

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

    Screenshot of add new flow step page.

문서 번역

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

Azure Blob Storage

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

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

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

    Screenshot showing the selection of Translator V3 as the next flow step.

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

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

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

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

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

      Screenshot showing the add connection window.

      참고 항목

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

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

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

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

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

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

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

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

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

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

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

      Screenshot of the Start document translation dialog window.

문서 상태 가져오기

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

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

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

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

    Screenshot of the get documents status step.

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

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

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

    
   body('Start_document_translation').operationID

    Screenshot showing function creation window.

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

    Screenshot showing the operation ID field with an expression function value.

커넥터 흐름 테스트

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

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

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

    Screenshot showing the test icon/button.

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

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

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

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

    Screenshot of successful document translation flow.

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

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

    Screenshot showing the 'Get documents status' JSON response.

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

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

다음 단계

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