목차(클릭하세요)
[prolog] 양파고 GitHub와 민원방패 프로젝트 소개
P-1.양파고 GitHub 페이지
•
GitHub 프로필: https://github.com/roughkyo
•
P-2. 민원방패 프로젝트
•
민원방패는 통화 녹음을 Gemini로 분석해 구글 시트에 상담 기록을 만드는 프로젝트임
◦
시리즈 1은 녹음 파일을 Drive 폴더에 직접 업로드하면 Apps Script가 전사, 분석, 상담 횟수 집계를 처리함
◦
시리즈 2는 Google 주소록 연동과 Android 앱을 추가함
◦
Android 앱은 통화 종료 알림, 최근 1시간 녹음 조회, Drive 업로드를 담당함
•
앱이 통화를 직접 녹음하지는 않음
◦
휴대전화가 이미 저장한 녹음 파일을 사용자가 확인하고 선택했을 때만 Drive에 업로드함
P3. 민원방패 프로젝트 핵심 요소
•
녹음 파일을 보관함에 넣고 상담 일지에 내용을 옮겨 적는 일을 AI+구글 시트로 자동화하는 구성임
◦
구글 드라이브: 원본 녹음 파일 보관
◦
Gemini: 음성을 글로 전사하고 정해진 상담 항목 추출
▪
전사:말소리를 문자로 옮겨 적는 것을 의미
◦
Google Apps Script: 파일 확인, API 호출, 시트 기록, 상담 이력 집계
◦
구글 스프레드시트: 통화별 기록과 누적 상담 현황 확인
에필로그. 민원방패 시리즈의 장점과 한계
E-1. 장점
•
별도 서버 없이 Google 계정 안에서 전체 과정이 진행됨
◦
Drive, Apps Script, Gemini API, 구글 시트만 사용함
•
코드와 AI의 역할이 나뉘어 있음
◦
AI는 전사와 항목 추출을 맡음
◦
코드는 파일 확인, 상담 횟수 집계, 중복 처리 방지를 맡음
•
확인할 수 없는 값은 추측해서 채우지 않음
◦
통화일시와 전화번호를 확인할 수 없으면 비워 두고 사람이 확인할 항목으로 남김
•
요청하는 권한이 좁음
◦
Drive 접근에는 사용자가 허용한 파일과 폴더로 한정된 drive.file 범위를 사용함
•
단계별로 도입할 수 있음
◦
시리즈 1만으로도 녹음 분석과 상담 기록 작성이 동작함
◦
필요할 때 주소록 연동과 Android 앱을 추가하면 됨
E-2. 한계
•
아이폰 계열에서는 사용할 수 없음
◦
Android 앱(Kotlin, Android 12 이상)만 제공하며 iOS용 앱은 없음
◦
통화 종료 감지와 녹음 파일 조회도 Android 기능을 기준으로 구현됨
•
음성 파일의 전사 품질은 모델 성능에 좌우됨
◦
코드의 기본 모델은 gemini-3.5-flash-lite이며 다른 모델로 바꾸면 결과가 달라질 수 있음
◦
모델과 녹음 상태에 따라 오인식이나 누락이 발생할 수 있음
◦
화자 구분과 학생 이름 추출도 전사 결과에 영향을 받음
◦
중요한 발언은 원본 녹음과 대조하기
•
그 밖의 제약
◦
삼성 계열의 Recordings/Call 저장 경로를 기준으로 하며 기종이 다르면 CALL_RECORDINGS_PATH 수정이 필요함
◦
조회 시점 기준 최근 1시간 이내에 저장된 녹음만 목록에 표시함
◦
실시간 처리가 아님. Apps Script가 5분마다 새 파일을 확인하고 1회에 최대 3건을 처리함
◦
일반 전화 상태를 기준으로 하므로 일부 인터넷 전화 앱의 통화 종료는 감지하지 못할 수 있음
◦
업로드가 끊기면 자동으로 재개하지 않으며 같은 녹음을 여러 번 선택하면 중복 업로드될 수 있음
◦
상담 횟수는 전화번호와 학생 이름 기준으로 집계하므로 같은 학생이라도 보호자 번호가 다르면 따로 집계됨
◦
개인 시험용 Debug 빌드 기준이며 Google Cloud 설정과 SHA-1 등록은 각자 진행해야 함