Bring Your Own Engine

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

Bring Your Own Engine (BYO Engine) 기능을 사용하면 외부 기계번역(MT) 엔진을 Phrase에 통합하여 다른 MT 공급자와 마찬가지로 번역 워크플로에서 사용할 수 있습니다.

Bring Your Own Engine (BYO Engine)은 다음에 적합합니다:

도메인별 MT 모델을 보유한 기업.
사용자 지정 클라이언트 엔진 또는 선호하는 AI 스택을 보유한 LSP.
특정 엔진(예: Gemini, 내부 LLM 등) 사용을 요구하는 내부 정책을 가진 조직.

사용자 지정 학습된 엔진을 사용하거나 번역을 사내 LLM 또는 MT 공급자로 라우팅하여 품질, 개인 정보 보호 및 비용을 완전히 제어하는 동시에 Phrase의 TM, 용어집, QPS 및 CAT Editor의 이점을 계속 누릴 수 있습니다.

Bring Your Own Engine (BYO Engine)을 사용할 수 있는 곳

통합되면 Bring Your Own Engine (BYO Engine)을 사전 번역에 사용할 수 있습니다. Phrase Language AI 프로필에서 구성하고 해당 프로필을 사용하여 Phrase TMS 프로젝트, Phrase Portal, Phrase Strings 프로젝트, Phrase Studio 및 API를 통한 Phrase Language AI에서 사전 번역하십시오.

Bring Your Own Engine 구성

어댑터 구축

조직은 경량 API 어댑터를 구축하고 테스트해야 합니다. 이 어댑터는 Phrase와 엔진 간의 통신을 가능하게 합니다.

어댑터는 다음을 지원해야 합니다:
- 번역 요청
- 언어 쌍 지원
- 엔진 상태 확인 (Phrase가 상태 요청을 보냄)
백엔드 인프라(MT 엔진 또는 LLM)는 조직에서 호스팅하고 유지 관리해야 합니다.
Phrase는 해당 인프라에 연결할 수 있는 권한이 필요합니다.
어댑터는 동일한 세그먼트 수와 순서로 번역을 반환해야 합니다.

MT 프로필에 엔진 통합하기

API 어댑터가 구현 및 배포되면 Bring Your Own Engine (BYO Engine)이 Phrase Language AI의 MT 프로필에서 선택 가능해지며, 프로젝트에 할당할 수 있습니다.

BYO 엔진을 MT 프로필에 연결하려면:

Phrase Language AI MT 프로필 페이지에서 MT 엔진 연결을 클릭하십시오.

MT 엔진 연결 페이지가 표시됩니다.
Select Bring Your Own (BYO) Engine.

BYO 엔진 구성 페이지가 열립니다.
기본 엔진 URL을 입력하십시오.
인증 방법(HTTP 헤더 또는 클라이언트 자격 증명(OAuth 2.0))에 따라 자격 증명을 제공하십시오.
번역 캐시 사용 여부를 선택하십시오. 기본적으로 활성화되어 있습니다.

지난 30일 이내에 번역된 세그먼트를 재사용하여 트래픽을 줄이고 번역 응답 속도를 높입니다. 이는 호출 성능 최적화일 뿐이며 번역 비용을 절감하지는 않습니다. 기본적으로 활성화 상태로 유지하고, 기본 엔진 어댑터가 활성 개발 중인 경우에만 사용 안 함으로 설정하십시오.
필요한 경우 사용자 지정 레이블. 아래에 엔진에 대한 추가 정보를 제공하십시오.
연결 유효성 검사를 클릭하여 엔진 통합이 작동하는지 확인하십시오.
추가를 클릭하십시오.

이제 프로필에서 엔진을 활성화할 수 있습니다.

팁

BYO 엔진을 사용할 때는 MT 프로필에서 다른 엔진을 활성화하지 마십시오. 이렇게 하면 사전 번역을 위해 BYO 엔진이 선택됩니다.

Bring Your Own Engine 편집

BYO Engine을 편집하려면 엔진 타일에서 편집 아이콘을 클릭하십시오.

Delete a Bring Your Own Engine

To delete a BYO Engine:

엔진 타일에서 편집 아이콘을 클릭하십시오.
Click Remove Bring Your Own Engine.

FAQ

Q:	상태 요청이 필요한 이유는 무엇인가요? 이 요청은 Phrase가 엔진에 보내는 것인가요, 아니면 고객이 처리해야 하나요?
A:	Phrase는 엔진이 작동하는지 확인하기 위해 요청을 보냅니다.
Q:	하나의 요청에는 `maxItems`가 `segments` 내에 500개까지 포함될 수 있습니다. 이는 500개의 소스 문장을 실시간으로 번역해야 함을 의미합니까?
A:	동기식 호출에는 최대 5개의 세그먼트만 포함할 수 있고, 비동기식 호출에는 최대 500개까지 포함할 수 있습니다. 또한 비동기 호출의 타임아웃은 약 30분입니다.
Q:	용어집의 모든 용어가 요청에 포함되어 전송됩니까, 아니면 일부만 전송됩니까?
A:	용어집의 모든 용어가 전송됩니다.
Q:	LLM을 연결할 수 있습니까?
A:	래퍼를 사용하면 가능할 것입니다. 엔진이 스키마에 정의된 대로 세그먼트를 반환하기만 하면 Phrase는 특정 엔진이나 LLM을 요구하지 않습니다.
Q:	사용자 지정 품질 평가(QE)가 가능합니까?
A:	타사 QE는 지원되지 않습니다.
Q:	태그는 어떻게 처리됩니까?
A:	Phrase가 받는 콘텐츠는 사전 처리됩니다. HTML 태그는 마크로 변환되며, 해당 마크는 그대로 전달됩니다.
Q:	비동기 방식만 구현할 수 있습니까? 모든 Phrase 영역(사전 번역, 에디터 등)에서 올바르게 작동합니까?
A:	아니요, 두 방식(이상적으로는 모든 엔드포인트)을 모두 구현해야 합니다. 동기식 엔드포인트는 예를 들어 에디터에서 사용되는 반면, 비동기식 엔드포인트는 사전 번역과 같은 영역에서 사용됩니다.
Q:	엔진이 동시에 여러 요청을 받으면 어떻게 됩니까?
A:	엔진은 이를 처리할 수 있어야 합니다. 모든 엔드포인트, 특히 비동기 엔드포인트에서 동시성 및 스레드 안전성을 적절하게 처리하십시오.
Q:	Request Metadata는 어떻게 작동합니까?
A:	엔진 설정 중에 정의된 대로 정적 상태를 유지해야 합니다.
Q:	Segment Metadata는 어떻게 작동합니까?
A:	현재는 스키마의 일부여야 합니다.
Q:	MT 작업 중에 BYOE는 RAG를 사용하여 컨텍스트를 검색합니까?
A:	아니요, BYOE는 RAG를 사용하지 않습니다. 사용자는 TM을 활용하여 어떤 세그먼트가 번역되는지 결정할 수 있지만, MT 프로세스 자체 내에서는 사용되지 않습니다. 이는 MT 엔진이 RAG를 통해 TM 데이터를 통합하도록 특별히 설계되어야 하며, BYOE 시나리오에서는 엔진이 구축되거나 구성되는 방식에 대한 제어 권한이 없기 때문입니다.

어댑터 스키마 참조

어댑터는 다음 필드 이름 및 열거형 값과 정확히 일치하는 응답을 반환해야 합니다. 어댑터 자체가 200 OK 응답을 반환하더라도 불일치가 발생하면 Phrase에서 일반적인 INTERNAL_ERROR가 발생합니다.

POST /status은(는) 반드시 status 필드를 반환해야 하며, 해당 필드는 ok 또는 not_ok 중 하나의 엄격한 소문자 열거형 값이어야 합니다. 예시: { \"status\": \"ok\" }
POST /languages은(는) languagePairs 배열(camelCase)을 반환해야 하며, 각 항목에는 sourceLanguage 필드와 targetLanguage 필드가 포함되어야 합니다. 예시: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate 및 GET /translateAsyncResult/{id}은(는) 최상위 sourceLanguage 및 targetLanguage 필드와, 각 세그먼트에 text 필드(에코된 소스 텍스트) 및 translatedText 필드가 모두 포함된 segments 배열을 반환해야 합니다. translatedText만 반환하거나 다른 키 이름을 사용하면 역직렬화 실패가 발생합니다.
POST /translateAsync은(는) 응답에 id 필드만 필요합니다. status 필드는 이 응답 스키마의 일부가 아니며, 포함되어 있더라도 무시됩니다.
GET /translateAsyncStatus/{id}은(는) status 필드를 세 가지 열거형 값 중 하나로 반환해야 합니다. running은(는) 여전히 처리 중인 작업, done은(는) 성공적으로 완료된 작업, failed는(는) 실패한 작업을 나타냅니다. 실패한 작업의 경우, 선택 사항인 detail 필드를 사용하여 실패 원인을 설명할 수 있습니다. 예시 값: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Description of translation failure" }