MCP 서버는 AI 어시스턴트 안에서 로컬라이제이션 엔진을 직접 사용할 수 있게 해줍니다. 대화 흐름을 벗어나지 않고 용어집 용어를 테스트하고, 문자열 묶음을 로컬라이즈하고, 언어를 감지할 수 있습니다.
콘텐츠 로컬라이즈#
어시스턴트에게 콘텐츠를 로컬라이즈하라고 하면, 용어집, 브랜드 보이스, 지침, 모델 체인까지 모두 자동 적용된 전체 설정으로 엔진을 호출합니다.
"내 엔진을 통해 이 문자열들을 독일어로 로컬라이즈해 줘: 'Add to cart', 'Proceed to checkout', 'Your order has been placed'"
어시스턴트는 소스 로캘과 대상 로캘을 지정해 키-값 데이터를 엔진으로 보냅니다. 엔진의 용어집은 정확한 용어 사용을 보장하고(예: 그렇게 설정했다면 "checkout"은 "Checkout"으로 유지), 브랜드 보이스는 적절한 톤을 적용하며, 구성된 모델 체인이 생성을 처리합니다.
의미를 정확히 구분할 수 있도록 엔진에 문맥 힌트를 함께 줄 수도 있습니다:
"'Share'를 일본어로 로컬라이즈해 줘 — 금융 상품의 주식이 아니라 소셜 미디어 맥락의 버튼 라벨이야"
어시스턴트가 대신 처리하는 것#
| 파라미터 | 설명 |
|---|---|
| 엔진 선택 | 사용할 엔진 지정(기본값은 조직 내 첫 번째 엔진) |
| 소스 로캘 | 원본 언어(예: en) |
| 대상 로캘 | 대상 언어(예: de, ja, pt-BR) |
| 데이터 | 로컬라이즈할 문자열의 키-값 맵 |
| 힌트 | 의미 구분을 돕는 키별 선택적 문맥 힌트 |
| 참조 | few-shot 컨텍스트를 위한 기존 로컬라이제이션 |
일괄 로컬라이제이션 (async)#
페이로드가 크거나 여러 로캘로 실행할 때는 어시스턴트가 비동기 작업을 사용합니다. 한 번 제출하면 모든 대상 로캘의 결과를 받을 수 있습니다:
"이 JSON 파일을 프랑스어, 독일어, 일본어로 로컬라이즈해 줘. 내 프로덕션 엔진을 사용해."
어시스턴트는 모든 대상 로캘을 하나의 요청으로 제출합니다. 각 로캘은 병렬로 처리되는 독립적인 작업이 됩니다. 상태는 언제든 확인할 수 있습니다:
"그 로컬라이제이션 배치 상태가 어때?"
어시스턴트는 작업 그룹을 폴링해 진행 상황을 알려줍니다. 몇 개 로캘이 완료됐는지, 실패나 경고는 없는지 보고하고, 준비되는 대로 결과를 가져옵니다.
비동기 작업 기능#
- 요청당 최대 100개 대상 로캘 제출
- 작업 완료 시 선택적 webhook 콜백
- 중복 제출을 방지하는 멱등성 키
- 요청별 파이프라인 설정 재정의
- 잠긴 키는 로컬라이제이션에서 제외
언어 감지#
"이 텍스트는 어떤 언어야: 'Nous sommes ravis de vous accueillir'"
어시스턴트는 언어를 감지하고 BCP-47 로캘, 언어명, 지역, 스크립트, 텍스트 방향(LTR/RTL)을 반환합니다.
이 기능과 CLI, 언제 무엇을 쓸까#
| 시나리오 | 추천 |
|---|---|
| 방금 추가한 용어집 용어를 테스트할 때 | MCP - 대화 안에서 즉시 피드백 |
| 코드 검토 중 문자열 하나를 로컬라이즈할 때 | MCP - 컨텍스트 전환 없이 |
| 모든 파일에 걸쳐 전체 프로젝트 로컬라이제이션을 실행할 때 | CLI - 파일 기반 워크플로에 적합 |
| CI/CD 파이프라인 통합 | CLI 또는 API - 자동화되고 반복 가능 |
| 여러 로캘로 문자열 묶음을 한 번에 로컬라이즈할 때 | MCP 비동기 작업 - 하나의 프롬프트로 병렬 처리 |
