Microsoft Translator V3(미리 보기)
Microsoft Azure Cognitive Services Translator를 사용하면 일반 또는 사용자 지정 모델을 사용하여 100개 이상의 언어로 텍스트 및 문서를 번역할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft 번역기 |
| URL | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| 전자 메일 | mtfb@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft 번역기 |
| 웹 사이트 | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/ |
| 카테고리 | AI; 비즈니스 인텔리전스 |
Azure Cognitive Services Translator 커넥터를 사용하면 Power Automate Flow 또는 Power App과 같은 Power Platform의 모든 구성 요소를 Microsoft Translator 서비스와 통합할 수 있습니다. 이 커넥터를 사용하여 다음 작업을 수행할 수 있습니다.
•텍스트 번역.
• 텍스트를 음역합니다.
• 다양한 문서 파일 형식을 번역합니다.
필수 조건
Azure Portal에서 Translator 리소스를 만드는 방법에 대한 지침을 따릅니다.
자격 증명을 가져오는 방법
• Translator 리소스를 만든 후 Azure Portal에서 리소스 이름과 키를 가져옵니다.
• 문서 번역을 위한 필수 조건을 따릅니다.
• 원본 및 대상 컨테이너 내부로 이동하고 아래 스크린샷과 같이 "Microsoft Entra ID 사용자 계정으로 전환"을 클릭합니다. 이 단계는 커넥터에만 필요합니다.
커넥터 시작
흐름에서 Translator 커넥터를 사용하고 번역 작업을 자동화하는 방법에 대한 다음 지침을 따릅니다.
일반적인 오류
일반적인 오류는 이 설명서를 참조하세요. https://learn.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference#errors
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 액세스 키 | Translator에 대한 Microsoft Translator 리소스 이름 및 Azure Cognitive Services 리소스 키를 제공합니다. | 모든 지역 | 공유 가능 |
| Logic Apps 앱 관리 ID | LogicApps 관리 ID를 사용하여 연결 만들기 | LOGICAPPS만 | 공유 가능 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
액세스 키
인증 ID: keyBasedAuth
적용 가능: 모든 지역
Translator에 대한 Microsoft Translator 리소스 이름 및 Azure Cognitive Services 리소스 키를 제공합니다.
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Translator 리소스 이름 | 문자열 | Microsoft Translator 리소스 이름 입력 | 진실 |
| 리소스 키 | 시큐어스트링 (보안 문자열) | Translator용 Azure Cognitive Services 리소스 키입니다. | 진실 |
Logic Apps 관리 ID
인증 ID: managedIdentityAuth
적용 가능: LOGICAPPS만 해당
LogicApps 관리 ID를 사용하여 연결 만들기
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| LogicApps 관리 ID | 관리되는 ID | Logic Apps 관리 ID로 로그인 | 진실 |
| Translator 리소스 이름 | 문자열 | Microsoft Translator 리소스 이름 입력 | 진실 |
| 리소스 키 | 시큐어스트링 (보안 문자열) | Translator용 Azure Cognitive Services 리소스 키입니다. | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Translator 리소스 이름 | 문자열 | Microsoft Translator 리소스 이름 입력 | 진실 |
| 리소스 키 | 시큐어스트링 (보안 문자열) | Translator용 Azure Cognitive Services 리소스 키입니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Transliterate |
한 언어의 텍스트를 한 스크립트에서 다른 스크립트로 변환합니다. |
| 문서 번역 시작 |
이 작업은 문서 번역 작업을 시작합니다. |
| 문서 상태 가져오기 |
작업의 특정 문서에 대한 상태를 가져옵니다. |
| 문서 상태 가져오기 |
번역 작업의 모든 문서의 상태를 가져옵니다. |
| 번역 상태 가져오기 |
특정 문서 번역 요청에 대한 상태 요약을 가져옵니다. |
| 번역 상태 가져오기 |
사용자가 제출한 모든 번역 요청의 상태와 함께 목록을 가져옵니다. |
| 번역 취소 |
현재 처리 중이거나 큐에 대기 중인 문서 번역 작업을 취소합니다. |
| 언어 가져오기 |
Microsoft Azure Cognitive Services Translator에서 번역에 지원되는 모든 언어를 검색합니다. |
| 지원되는 문서 형식 가져오기 |
지원되는 문서 형식의 목록을 가져옵니다. |
| 지원되는 스토리지 원본 가져오기 |
지원되는 스토리지 원본/옵션 목록을 가져옵니다. |
| 지원되는 용어집 형식 가져오기 |
지원되는 용어집 형식의 목록을 가져옵니다. |
| 텍스트 번역 |
지정된 원본 언어 텍스트를 대상 언어 텍스트로 번역합니다. |
Transliterate
한 언어의 텍스트를 한 스크립트에서 다른 스크립트로 변환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Language
|
language | True | string |
한 스크립트에서 다른 스크립트로 변환할 텍스트의 언어를 지정합니다. |
|
원본 스크립트
|
fromScript | True | string |
입력 텍스트의 스크립트 이름입니다. |
|
대상 스크립트
|
toScript | True | string |
음역된 텍스트의 스크립트 이름입니다. |
|
문자 메시지
|
Text | True | string |
번역할 텍스트입니다. |
반환
- response
- array of TransliterationResults
문서 번역 시작
이 작업은 문서 번역 작업을 시작합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
입력 문서의 스토리지 유형
|
storageType | True | string |
파일 또는 폴더를 선택합니다. |
|
원본 언어
|
sourceLanguage | True | string |
언어 코드입니다. 지정하지 않으면 Microsoft Translator는 문서 언어를 자동으로 검색합니다. |
|
원본 문서의 위치
|
sourceURL | True | string |
단일 파일 또는 폴더일 수 있는 원본 문서의 위치입니다. 이 위치는 Azure Blob Storage의 URL 링크입니다. |
|
접두사 필터
|
documentFilterPrefix | string |
번역을 위해 원본 경로에서 문서를 필터링하는 대/소문자를 구분하는 접두사 문자열입니다. 예를 들어 Azure Storage Blob Uri를 사용하는 경우 접두사를 사용하여 하위 폴더를 변환할 수 있도록 제한합니다. |
|
|
접미사 필터
|
documentFilterSuffix | string |
번역을 위해 원본 경로에서 문서를 필터링하는 대/소문자를 구분하는 접미사 문자열입니다. 파일 확장명은 가장 자주 사용합니다. |
|
|
카테고리
|
targetCategory | string |
번역의 범주(도메인)를 지정하는 문자열입니다. 이 매개 변수는 Custom Translator를 사용하여 빌드된 사용자 지정 시스템에서 번역을 가져오는 데 사용됩니다. |
|
|
번역된 문서의 위치
|
targetContainerURL | True | string |
번역된 문서를 저장할 위치입니다. 이 위치는 Azure Blob Storage의 URL 링크입니다. |
|
대상 언어
|
targetLanguage | True | string |
대상 언어 코드입니다. |
|
용어집 URL
|
glossaryUrl | string |
용어집 문서의 위치입니다. 이 위치는 Azure Blob Storage의 URL 링크입니다. |
|
|
용어집 문서 형식 및 버전
|
glossaryFormatVersion | string |
용어집 문서 형식 및 버전입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
operationID
|
operationID | string |
작업 ID입니다. |
문서 상태 가져오기
작업의 특정 문서에 대한 상태를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 ID
|
id | True | string |
작업 ID입니다. |
|
문서 ID
|
documentId | True | string |
문서 ID입니다. |
반환
문서 상태 가져오기
번역 작업의 모든 문서의 상태를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 ID
|
id | True | string |
작업 ID입니다. |
|
반환할 총 레코드 수
|
$top | integer |
사용자가 모든 페이지에서 반환하려는 총 레코드 수입니다. |
|
|
건너뛸 레코드 수
|
$skip | integer |
정렬 방법에 따라 목록에서 건너뛸 레코드 수입니다. |
|
|
반환된 최대 레코드
|
$maxpagesize | integer |
페이지에 반환된 최대 레코드입니다. |
|
|
정렬 기준
|
$orderBy | array |
컬렉션에 대한 정렬 쿼리입니다. (예: 'CreatedDateTimeUtc asc', 'CreatedDateTimeUtc desc'). |
|
|
시작 날짜/시간
|
createdDateTimeUtcStart | date-time |
항목을 가져올 시작 날짜/시간입니다. |
|
|
종료 날짜/시간
|
createdDateTimeUtcEnd | date-time |
이전에 항목을 가져올 종료 날짜/시간입니다. |
|
|
상태별로 필터링
|
statuses | array |
필터링에 사용할 상태입니다. |
|
|
문서 ID로 필터링
|
ids | array |
필터링에 사용할 문서 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object |
응답 값입니다. |
|
path
|
value.path | string |
문서 또는 폴더의 위치입니다. |
|
sourcePath
|
value.sourcePath | string |
원본 문서의 위치입니다. |
|
createdDateTimeUtc
|
value.createdDateTimeUtc | string |
작업에서 만든 날짜 시간입니다. |
|
lastActionDateTimeUtc
|
value.lastActionDateTimeUtc | string |
작업 상태가 업데이트된 날짜 시간입니다. |
|
status
|
value.status | string |
작업 또는 문서의 가능한 상태 목록입니다. |
|
에게
|
value.to | string |
대상 언어입니다. |
|
발전
|
value.progress | integer |
번역 진행률(사용 가능한 경우)입니다. |
|
아이디
|
value.id | string |
문서 ID입니다. |
|
characterCharged
|
value.characterCharged | integer |
API에서 청구되는 문자입니다. |
|
@nextLink
|
@nextLink | string |
다음 페이지의 URL입니다. 마지막 페이지인 경우 Null입니다. |
번역 상태 가져오기
특정 문서 번역 요청에 대한 상태 요약을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 ID
|
id | True | string |
작업 ID입니다. |
반환
번역 상태 가져오기
사용자가 제출한 모든 번역 요청의 상태와 함께 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
반환할 총 레코드 수
|
$top | integer |
사용자가 모든 페이지에서 반환하려는 총 레코드 수입니다. |
|
|
건너뛸 레코드 수
|
$skip | integer |
정렬 방법에 따라 목록에서 건너뛸 레코드 수입니다. |
|
|
반환된 최대 레코드
|
$maxpagesize | integer |
페이지에 반환된 최대 레코드입니다. |
|
|
정렬 기준
|
$orderBy | array |
컬렉션에 대한 정렬 쿼리(예: 'CreatedDateTimeUtc asc', 'CreatedDateTimeUtc desc')입니다. |
|
|
시작 날짜/시간
|
createdDateTimeUtcStart | date-time |
레코드를 가져올 시작 날짜/시간입니다. |
|
|
종료 날짜/시간
|
createdDateTimeUtcEnd | date-time |
이전에 레코드를 가져올 종료 날짜/시간입니다. |
|
|
상태별로 필터링
|
statuses | array |
필터링에 사용할 상태입니다. |
|
|
작업 ID로 필터링
|
ids | array |
필터링에 사용할 작업 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of TranslationStatusResponse |
응답 값입니다. |
|
@nextLink
|
@nextLink | string |
다음 페이지의 URL입니다. 마지막 페이지인 경우 Null입니다. |
번역 취소
현재 처리 중이거나 큐에 대기 중인 문서 번역 작업을 취소합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 ID
|
id | True | string |
작업 ID입니다. |
반환
언어 가져오기
Microsoft Azure Cognitive Services Translator에서 번역에 지원되는 모든 언어를 검색합니다.
반환
- response
- array of Language
지원되는 문서 형식 가져오기
지원되는 스토리지 원본 가져오기
지원되는 스토리지 원본/옵션 목록을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of string |
응답 값입니다. |
지원되는 용어집 형식 가져오기
텍스트 번역
지정된 원본 언어 텍스트를 대상 언어 텍스트로 번역합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
원본 언어
|
from | True | string |
소스 언어 코드(예: 'en')입니다. 소스 언어 코드를 지정하지 않으면 원본 언어를 확인하기 위해 자동 언어 검색이 적용됩니다. |
|
대상 언어
|
to | True | string |
대상 언어 코드(예: 'fr')입니다. |
|
텍스트 형식
|
textType | string |
번역할 텍스트 형식이 일반 텍스트인지 HTML인지를 정의합니다. |
|
|
욕설 작업
|
profanityAction | string |
번역에서 욕설을 처리하는 방법을 지정합니다. |
|
|
욕설 표식
|
profanityMarker | string |
번역에서 욕설을 표시하는 방법을 지정합니다. |
|
|
문장 길이 포함
|
includeSentenceLength | string |
입력 텍스트 및 번역된 텍스트의 문장 경계를 포함할지 여부를 지정합니다. |
|
|
제안된 원본 언어
|
suggestedFrom | string |
입력 텍스트의 언어를 식별할 수 없는 경우 대체 언어를 지정합니다. |
|
|
원본 텍스트의 스크립트
|
fromScript | string |
입력 텍스트의 스크립트 이름입니다. |
|
|
번역된 텍스트의 스크립트
|
toScript | string |
번역된 텍스트의 스크립트 이름입니다. |
|
|
카테고리
|
category | string |
번역의 범주(도메인)를 지정하는 문자열입니다. 이 매개 변수는 Custom Translator를 사용하여 빌드된 사용자 지정 시스템에서 번역을 가져오는 데 사용됩니다. |
|
|
일반 도메인으로 대체 허용
|
allowFallback | string |
사용자 지정 시스템이 없을 때 서비스가 일반 시스템으로 대체되도록 지정합니다. |
|
|
문자 메시지
|
Text | True | string |
번역할 텍스트입니다. |
반환
- response
- array of TranslationResults
정의
TranslationResults
번역 결과입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
번역 결과
|
TranslatedText | string |
번역된 텍스트를 가져옵니다. |
|
음역된 텍스트
|
TransliteratedText | string |
음역된 텍스트를 가져옵니다. |
TransliterationResults
음역 결과입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문자 메시지
|
text | string |
음역된 텍스트를 가져옵니다. |
|
스크립트
|
script | string |
음역된 스크립트입니다. |
Language
언어 코드입니다. 지정하지 않은 경우 Microsoft Translator는 문서 언어를 자동으로 검색하려고 합니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
언어 코드
|
Code | string |
언어 코드를 가져오거나 설정합니다. |
|
Language
|
Name | string |
언어를 가져오거나 설정합니다. |
FormatOKResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object |
세부 정보가 포함된 파일 형식입니다. |
|
format
|
value.format | string |
문서 형식의 이름입니다. |
|
fileExtensions
|
value.fileExtensions | array of string |
이 형식에 대해 지원되는 파일 확장명입니다. |
|
contentTypes
|
value.contentTypes | array of string |
이 형식에 대해 지원되는 콘텐츠 형식입니다. |
|
versions
|
value.versions | array of string |
지원되는 버전입니다. |
|
기본값 버전
|
value.defaultVersion | string |
지정되지 않은 경우 기본 버전입니다. |
TranslationStatusResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
작업의 ID입니다. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
작업에서 만든 날짜 시간입니다. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
작업 상태가 업데이트된 날짜 시간입니다. |
|
status
|
status | string |
취소됨, 취소, 실패, 시작되지 않음, 실행 중, 성공, ValidationFailed와 같은 작업 또는 문서의 가능한 상태 목록입니다. |
|
합계
|
summary.total | integer |
총 문서 수입니다. |
|
실패
|
summary.failed | integer |
실패한 문서 수입니다. |
|
성공
|
summary.success | integer |
성공적으로 번역된 문서 수입니다. |
|
inProgress
|
summary.inProgress | integer |
진행 중인 문서 수입니다. |
|
notYetStarted
|
summary.notYetStarted | integer |
아직 처리를 시작하지 않은 문서 수입니다. |
|
cancelled
|
summary.cancelled | integer |
취소된 문서 수입니다. |
|
totalCharacterCharged
|
summary.totalCharacterCharged | integer |
청구된 총 문자 수입니다. |
DocumentStatusResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
path
|
path | string |
문서 또는 폴더의 위치입니다. |
|
sourcePath
|
sourcePath | string |
원본 문서의 위치입니다. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
작업에서 만든 날짜 시간입니다. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
작업 상태가 업데이트된 날짜 시간입니다. |
|
status
|
status | string |
취소됨, 취소, 실패, 시작되지 않음, 실행 중, 성공, ValidationFailed와 같은 작업 또는 문서의 가능한 상태 목록입니다. |
|
에게
|
to | string |
대상 언어입니다. |
|
발전
|
progress | integer |
번역 진행률(사용 가능한 경우)입니다. |
|
아이디
|
id | string |
문서 ID입니다. |
|
characterCharged
|
characterCharged | integer |
API에서 청구되는 문자입니다. |