로컬라이제이션 엔진

공유 번역 구성을 만들고 호출 측에서 선택한 다음, 이 구성을 사용하는 리소스와 워크플로를 관리하세요.

로컬라이제이션 엔진은 반복되는 번역 요청에 공통 구성을 제공합니다. 모델을 선택하고 작업에 필요한 용어, 지침, 보이스를 연결합니다. 애플리케이션은 요청마다 제품의 모든 규칙을 다시 지정하지 않고도 콘텐츠를 전송할 수 있습니다.

Studio 2.5 탐색 메뉴에서 Studio 2.5 → 로컬라이제이션 엔진을 여세요. 그 외의 경우에는 인프라스트럭처를 여세요. 기존 엔진 링크도 그대로 사용할 수 있습니다.

로컬라이제이션 엔진은 조직에 속합니다. 연결된 용어집, 규칙 세트, 브랜드 보이스도 같은 조직에 속하며, 다른 로컬라이제이션 엔진과 공유할 수 있습니다. 엔진과 리소스가 분리되어 있어 관련 워크플로에서 공통 용어를 사용하면서도 모델 선택이나 파이프라인 정책은 각각 다르게 유지할 수 있습니다.

첫 구성 만들기 #

  1. 사용할 조직을 선택하고 인프라스트럭처를 연 다음 로컬라이제이션 엔진을 만드세요. 제품 문서처럼 어떤 작업인지 알아볼 수 있는 이름을 지정하세요.
  2. 모델에서 권장 기본 모델과 대체 모델을 확인하세요. 초기 구성은 모든 로캘 쌍에 적용됩니다. 처음 테스트할 때는 그대로 사용하거나 작업에 필요한 모델 적용 범위를 설정하세요.
  3. 컨텍스트가 표시되면 기존 용어집, 규칙 세트, 브랜드 보이스 하나를 선택하거나 아무것도 선택하지 않고 비워 두세요. 웹사이트가 표시되면 부족한 가이드를 생성할 사이트를 입력하거나 건너뛰기를 선택해 가이드를 생성하지 않고 계속하세요. 선택한 연결 항목과 생성 계획을 확인한 다음 로컬라이제이션 엔진을 만드세요.
  4. 저장된 연결 항목을 확인하세요. 엔진 생성과 리소스 연결은 별도의 쓰기 작업이므로, 연결하려던 항목의 연결에 실패해도 로컬라이제이션 엔진은 생성되어 있을 수 있습니다.
  5. 페이지 헤더에서 엔진 식별자를 복사해 호출 측에서 지원하는 구성에 입력하세요. 작업을 대표하는 작은 샘플을 번역한 뒤 결과와 요청 증빙을 확인하세요.

웹 앱에서 새로 만든 로컬라이제이션 엔진은 번역 전용 파이프라인으로 시작합니다. 선택 기능인 재작성과 휴먼 리뷰는 비활성화되어 있으며, 용어집 및 지침 준수 점수 평가와 자동 제안 생성도 비활성화되어 있습니다. 추가 기능을 활성화하기 전에 저장된 설정을 확인하세요. 기존 로컬라이제이션 엔진에는 이미 다른 정책이 적용되어 있을 수 있습니다.

엔진의 파이프라인 탭에서 휴먼 리뷰를 설정하세요. 결정 풀 카드에서 언어와 디렉터리별 검토 담당자를 선택할 수 있습니다. 풀을 만들고 검토 경로를 설정하는 방법은 결정 풀에서 설명합니다.

API 빠른 시작에서는 식별자를 명시적으로 지정해 첫 요청을 완료합니다. CLI 빠른 시작에서는 파일 기반 워크플로를 따릅니다. CLI는 동일한 문서 작업 수명 주기에 따라 파일 제출과 결과 가져오기를 관리합니다. 호출 측에서 지원하는 구성을 사용하세요.

사용할 로컬라이제이션 엔진 선택하기 #

모든 API 번역 작업에는 engineId이 필요합니다. CLI는 lingo link로 선택 내용을 저장하며, 연동 기능은 자체 구성에 저장합니다. 작업을 제출하기 전에 엔진이 속한 조직과 적용할 가이드를 확인하세요. 표시 이름은 사람이 엔진을 알아볼 수 있도록 돕고, 호출 측에서는 엔진 식별자를 사용합니다.

로컬라이제이션 엔진은 요청마다 모델 후보, 조건에 맞는 지침, 보이스 변형 하나, 관련 용어집 용어를 결정합니다. 이 리소스에 모두 같은 매칭 규칙이 적용되는 것은 아닙니다. 로캘 결정에서는 리소스를 사용하기 전에 어떻게 누적하고, 우선순위를 정하고, 필터링하는지 설명합니다.

공유 가이드 마련하기 #

번역 컨텍스트를 참고해 요구 사항을 용어, 지침, 보이스 중 어디에 반영할지 결정하세요. 공유 리소스를 편집하기 전에는 해당 리소스를 사용하는 로컬라이제이션 엔진을 확인하세요. 특정 독자층에 적합한 변경이라면 모든 사용처에 영향을 주는 편집 대신 별도 리소스를 만드는 편이 나을 수 있습니다.

계정의 MCP 도구로도 리소스를 구성할 수 있습니다. 적용하기 전에 도우미에게 제안된 용어, 지침, 로캘별 보이스를 보여 달라고 요청하세요. 기존 콘텐츠에서 가이드 생성하기에서는 웹 주소나 텍스트 샘플을 바탕으로 리소스를 비동기 방식으로 준비하는 방법을 설명합니다. 두 방법 모두 수동으로 구성할 때와 마찬가지로 저장된 레코드와 결과를 확인해야 합니다.

편집이 포함된 작업을 설명할 때는 구성 변경 사항을 요청 증빙과 함께 보관하세요. 저장된 연결 정보는 공유 리소스를 식별할 뿐, 해당 리소스 텍스트의 모든 버전까지 보존하지는 않습니다. 현재 설정으로 이전 요청을 재현할 수 있다고 가정하지 말고, 비교 전에 관련 가이드를 기록해 두세요.

로컬라이제이션 엔진 비활성화 또는 삭제하기 #

로컬라이제이션 엔진을 비활성화하면 나중에 다시 활성화할 수 있는 상태로 새 실행을 중단할 수 있습니다. 먼저 해당 식별자를 사용하는 호출 주체를 파악하고, 호출을 일시 중지할지 다른 엔진으로 전환할지 결정하세요. 비활성화해도 진행 중인 모든 작업이나 이미 큐에 들어간 제안이 취소되는 것은 아니며, 이미 적용된 번역이나 가이드 변경도 되돌리지 않습니다.

엔진을 참조하는 호출 측 설정을 제거하거나 교체한 뒤에만 삭제하세요. 삭제된 식별자를 지정한 요청은 더 이상 해당 엔진을 사용할 수 없습니다. 삭제하면 로컬라이제이션 엔진과 연결 정보는 제거되지만, 조직의 용어집, 규칙 세트, 브랜드 보이스는 공유 리소스로 남습니다.

비활성화하거나 삭제하기 전에 Inbox와 실행 증빙에서 대기 중인 작업을 확인하세요. 새 요청을 중단하는 것과는 별개로, 해당 작업을 처리하거나 남겨 둘 작업의 처리 방침을 명확히 정하세요.