Manual

Voice KMS Roleplay Bot 사용 방법

이 버전은 MP3 데이터를 분석하면서 카테고리를 자동 생성하는 구조입니다. 미리 정해진 분류표가 아니라 실제 발화에서 카테고리와 그래프가 만들어집니다.

1. 설치/실행

cd /d C:\AI\kms_voice_bot
scripts\setup_windows.cmd
scripts\run_windows.cmd

PowerShell 보안 오류가 나면 CMD 방식으로 실행하거나, 현재 창에서만 Bypass를 적용하세요.

2. MP3 자동 분석 순서

  1. MP3 100개를 C:\AI\kms_voice_bot\goodcall에 넣습니다.
  2. 굿콜 자동 분석 화면에서 MP3 폴더 스캔을 누릅니다.
  3. 엑셀 메타데이터가 있으면 업로드합니다.
  4. 이어서 분석 또는 전체 재분석을 실행합니다.
  5. 학습된 카테고리, 고객 질문 그래프, 키워드, 상담사 대응 분석을 확인합니다.

3. Gemini 사용

프로젝트 루트의 .env에 아래 값을 넣으면 동적 카테고리 이름 생성에 Gemini를 사용할 수 있습니다.

USE_GEMINI=true
GEMINI_MODEL=gemini-2.5-flash
GEMINI_API_KEY=현_API키

4. 실제 STT/화자분리 연결 위치

현재는 바로 실행 가능한 MVP라 MP3 음성은 mock 분석입니다. 실제 STT/화자분리는 아래 파일을 교체하면 됩니다.

backend/services/transcript_service.py
- transcribe_any()
- mock_diarize_and_transcribe()