로컬라이제이션 버그 원인 파악하기
로컬라이제이션 결과가 잘못 나왔을 때, 어시스턴트가 엔진 설정을 살펴보고 근본 원인을 찾아 수정 방안까지 제안합니다. 모두 한 번의 대화로 가능합니다.
워크플로#
"'data processing agreement'의 독일어 로컬라이제이션이 'Datenverarbeitungsvereinbarung'으로 나왔는데, 법무팀은 'Auftragsverarbeitungsvertrag'를 써야 한다고 합니다. 왜 그런가요?"
진행 방식은 다음과 같습니다:
- 어시스턴트가 엔진과 엔진이 사용하는 용어집, 규칙 세트, 사전 정의된 규칙, 브랜드 보이스, 해당 로캘 쌍의 모델 체인을 확인합니다
- 엔진이 사용하는 모든 용어집에서 해당 용어를 검색합니다
- 근본 원인을 보고합니다: "엔진이 사용하는 용어집 어디에도 해당 용어가 없습니다. 모델이 틀린 표현은 아니지만 표준에 맞지 않는 로컬라이제이션을 선택했습니다"
- 수정 방안을 제안합니다: "법무팀이 선호하는 표현을 반드시 사용하도록 용어집에 용어를 추가하세요"
- 승인하면 수정 사항을 적용합니다
이럴 때 사용하세요#
- 사용자나 검토자가 잘못된 로컬라이제이션을 보고한 경우
- 로컬라이제이션 전반에서 용어 사용이 일관되지 않는다고 느껴질 때
- 특정 로캘에서 톤이나 문체가 계속 잘못 적용됩니다
- 특정 로캘 쌍을 처리하는 모델과 대체 모델이 무엇인지 알고 싶습니다
어시스턴트가 확인하는 항목#
| 신호 | 확인 항목 |
|---|---|
| 잘못된 용어 | 용어집 적용 범위 — 엔진이 사용하는 용어집에 해당 용어가 정의되어 있나요? |
| 잘못된 톤/문체 | 브랜드 보이스 — 엔진에 브랜드 보이스가 적용되어 있나요? 해당 로캘에 맞춘 변형이 있나요? |
| 규칙 위반 | 규칙 세트와 사전 정의된 규칙 — 해당 내용을 다루는 규칙이 있나요? 적용 범위가 올바른 로캘로 지정되어 있나요? |
| 모델 선택 | 모델 체인 — 해당 로캘 쌍을 처리하는 모델과 대체 모델은 무엇인가요? |
특정 요청에서 엔진이 실제로 무엇을 입력받고 반환했는지 확인하려면 대시보드에서 해당 요청을 열거나 API의 Observability 기능으로 조회하세요.
원인 파악 → 수정#
원인 파악은 어디가 문제인지 밝혀냅니다. 수정 방법은 문제 유형에 따라 달라집니다:
- 누락된 용어집 용어 → "
de용 용어집에 'data processing agreement' → 'Auftragsverarbeitungsvertrag'를 추가하세요" - 잘못된 브랜드 보이스 → "독일어 브랜드 보이스를 격식체로 쓰도록 업데이트하세요"
- 누락된 규칙 → "
de의 법률 용어 사용 규칙을 추가하세요" - 모델 한계 → "
en → de법률 콘텐츠에는 다른 기본 모델을 사용해 보세요"
승인하면 어시스턴트가 즉시 수정 사항을 적용할 수 있습니다. 버그 보고부터 해결까지 한 번의 대화로 끝납니다.