Skip to content

fix(language): 구조화 번역 생성 실패 진단 및 GPT-5 호환 보완 - #71

Merged
hywznn merged 2 commits into
mainfrom
fix/70-language-translation
Aug 19, 2026
Merged

fix(language): 구조화 번역 생성 실패 진단 및 GPT-5 호환 보완#71
hywznn merged 2 commits into
mainfrom
fix/70-language-translation

Conversation

@hywznn

@hywznn hywznn commented Aug 19, 2026

Copy link
Copy Markdown
Member

문제

Renewal 안내문 번역이 실패해도 실제 Provider 오류가 숨겨지고 모든 경우가 TRANSLATION_GENERATION_FAILED로만 보였습니다. OpenAI 호환 요청에는 모델별로 허용되지 않을 수 있는 temperature가 고정 전송됐고, Pydantic 기본값 필드가 OpenAI strict JSON Schema의 필수 필드 규칙과 맞지 않아 의미 검증 요청도 400으로 실패했습니다.

변경 내용

  • 구조화 생성 요청에서 불필요한 temperature 제거
  • Pydantic Schema를 OpenAI strict Structured Outputs 규칙에 맞게 정규화
  • Provider 오류를 인증 실패, 요청 형식 오류, 일시 장애, 응답 스키마 오류, 거절로 구분
  • OpenAI request ID와 안전한 error code만 로그에 남겨 배포 환경에서 원인 추적 가능
  • Provider refusal 응답을 명시적으로 처리
  • 번역·쉬운 한국어 실패 경고에 안전한 실패 분류 코드 포함
  • 최초 생성 실패를 가짜 검증 항목으로 기록하던 동작 제거
  • 원문 프롬프트, 응답 본문, API Key는 로그와 외부 응답에 남기지 않음

검증

  • 전체 pytest -q 통과
  • ruff check app tests 통과
  • GitHub CI 3종 통과
  • 유효한 Provider 설정으로 몽골어 Renewal Smoke Test 통과
    • HTTP 200
    • target_language=mn
    • translated_text 생성 확인
    • TRANSLATION_GENERATION_FAILED 없음
    • 의미 검증 요청의 PROVIDER_REQUEST_INVALID 없음

Qdrant를 끈 Smoke 환경에서는 RETRIEVAL_UNAVAILABLE, TRANSLATION_FALLBACK_USED가 남고 HR 검토 상태가 됩니다. 검색 보강 기능의 비활성화에 따른 정상적인 degraded 동작이며, 이번 번역 생성 오류와는 별도 범위입니다.

Closes #70

@hywznn

hywznn commented Aug 19, 2026

Copy link
Copy Markdown
Member Author

유효한 LLM Provider 설정으로 몽골어 Renewal Smoke Test를 완료했습니다.

  • HTTP 200
  • target_language=mn
  • translated_text에 실제 몽골어 안내문 생성 확인
  • TRANSLATION_GENERATION_FAILED 없음
  • strict Schema 보완 후 의미 검증의 PROVIDER_REQUEST_INVALID 없음
  • 전체 pytest, Ruff, GitHub CI 3종 통과

Smoke에서는 Qdrant를 의도적으로 비활성화했으므로 검색 보강 관련 degraded 경고만 남습니다. Secret·개인정보·원문 응답은 댓글에 포함하지 않았습니다.

@hywznn
hywznn marked this pull request as ready for review August 19, 2026 07:38
@hywznn

hywznn commented Aug 19, 2026

Copy link
Copy Markdown
Member Author

@krestar

@hywznn
hywznn merged commit 2a21015 into main Aug 19, 2026
3 checks passed
@hywznn
hywznn deleted the fix/70-language-translation branch August 20, 2026 06:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] Renewal 안내문 번역 생성이 계속 구조화 검증 실패로 끝남 (TRANSLATION_GENERATION_FAILED)

1 participant