기타2026. 8. 15.

엄격한 영어 문장 교정 및 설명 도우미

엄격한 영어 문장 교정 및 설명 도우미 - 1

Gemini AI와 엄격한 규칙을 결합하여 영어 문장의 오류를 정확히 짚어내고 상세한 한국어 피드백을 제공하는 문장 교정 도구입니다.

💡 만든 동기

기존의 단순한 문법 검사기나 룰 기반 시스템은 문맥을 정확히 파악하지 못하거나 틀린 문장도 맞다고 오인하는 한계가 있었습니다. 사용자가 입력한 영어 문장의 숨은 오류(시제, 수 일치, 조동사 규칙 등)를 정확히 잡아내고, 각 부분별로 '왜 틀렸는지' 혹은 '왜 맞았는지' 상세한 이유를 한국어로 제공하는 실용적인 학습 도구를 만들고자 개발하게 되었습니다. 어려웠던 점:

🤔 어려웠던 점

AI의 과도한 관대함: 초기 Gemini AI 프롬프트에서는 문장 오류(예: 조동사 'did' 뒤의 동사 형태나 시제 불일치 등)를 명확히 잡아내지 못하고 모든 문장을 무조건 맞다고 처리하는 현상(False Positive)이 발생했습니다. JSON 파싱 오류: API 응답에 마크다운 블록이나 부가 텍스트가 섞여 들어오면서 프론트엔드에서 JSON.parse 에러가 빈번하게 발생했습니다.

🛠 해결한 방법

시스템 프롬프트(System Prompt)에 주요 문법 예외 규칙과 구체적인 오답 사례(Few-shot 개념)를 강력하게 추가하고, AI에게 극도로 엄격한 검사 기준을 부여하여 오류 검출률을 높였습니다. 정규식(Regex)을 활용하여 API 응답 텍스트에서 순수 JSON 객체 영역만 안전하게 추출하고 정제하는 파싱 로직을 구현하여 에러를 완전히 해결했습니다.

✨ 배운 점

프롬프트 엔지니어링의 중요성: AI 모델이 사용자의 요구사항을 정확히 따르게 하려면 단순한 요청을 넘어 구체적인 규칙과 제약 조건을 명시하는 것이 얼마나 중요한지 체감했습니다. API 연동과 예외 처리: 외부 AI API를 활용할 때 발생할 수 있는 데이터 형식 불일치(JSON 파싱 에러) 및 사용자 인증(API 키 설정)을 안전하게 처리하는 프론트엔드 아키텍처 설계 역량을 기를 수 있었습니다.