AI 학습하기 사용 가이드

🧠

AI 학습하기란?

자동 견적 위자드가 고객사에게 모듈과 예산을 추천할 때 사용하는 기준 로직을 실무 피드백으로 직접 개선하는 기능입니다. 학습된 내용은 Cloudflare D1 데이터베이스에 저장되어, 이후 팀원 누구가 접속해도 동일하게 적용됩니다.

🏢

산업별 모듈 기본값

금융, 공공, 헬스케어 등 산업 선택 시 자동 체크되는 모듈 구성을 바꿀 수 있습니다.

💰

예산 구간 기준

Low / Mid / High 구간의 금액 임계값을 실제 고객 예산 수준에 맞게 조정합니다.

📊

쿼리 수 배율

예산 구간별 추천 쿼리 수의 증감 비율을 현실에 맞게 재설정합니다.

🎯

목적별 모듈 구성

위협 인텔리전스, 자격증명 보호 등 목적 선택 시 나오는 추천 모듈을 변경합니다.

💡

단계별 힌트 메시지

위자드 각 스텝 상단에 표시되는 안내 문구를 업데이트합니다.

📅

견적 유효기간

기본 유효일 수(현재 30일)를 고객 결재 주기에 맞게 변경합니다.

🖱️

학습하기 버튼 여는 법

1

위자드 페이지 하단으로 스크롤

페이지 최하단 Footer 영역 오른쪽에 보라색 버튼이 고정되어 있습니다.

2

버튼 클릭

한국어 버전: 🧠 학습하기 / 영문 버전: 🧠 Train AI

3

팝업 모달 오픈 확인

AI 견적 가이드 학습 팝업이 나타나면 준비가 된 것입니다. 학습 탭이 기본으로 선택되어 있습니다.

📊

STEP 1 — 학습 강도 선택

팝업 상단 1~5단계 버튼으로 AI가 기존 로직을 얼마나 과감하게 수정할지 조절합니다.

1

미세 조정

작은 오류 하나만 수정. 기존 로직 거의 유지

2

부분 개선

특정 산업군 또는 규칙 하나만 변경

초보 추천

3

균형 조정

여러 규칙 개선, 전체 구조 유지

기본값 추천

4

대폭 개선

전반적으로 추천 로직이 현실과 맞지 않을 때

팀 합의 후

5

전면 개편

처음부터 다시 재작성. 기존 학습 대폭 교체

신중히 사용

💡

추천 강도 처음 사용하거나 작은 개선이라면 강도 2~3으로 시작하세요. 결과를 확인한 후 필요하면 추가 학습을 진행하는 방식을 권장합니다. 강도 5는 기존 학습 내용을 대폭 교체하므로 팀 합의 후 사용하세요.

✍️

STEP 2 — 피드백 내용 입력

텍스트 박스에 개선하고 싶은 내용을 자유롭게 작성합니다. (최대 500자)
핵심은 "어떤 고객에게 / 어떤 설정을 / 왜" 세 가지가 들어가게 작성하는 것입니다.

✅ 잘 쓴 예시

금융업종 고객에게는 CL(Credential Lookout), CB(Combo Browser), CDS(Credential Dark Scanner), UB(Underground Browser) 모듈을 기본으로 추천해야 합니다. 현재 DT, TT만 추천되는데 금융 고객 특성상 자격증명 유출 모니터링이 필수입니다.

✅ 잘 쓴 예시

예산이 월 $5,000 이상인 고객에게는 전체 모듈을 기본으로 선택하고 쿼리도 Pro 티어로 설정해주세요. 대형 고객사에 Basic 추천이 나오면 영업에 방해가 됩니다.

✅ 잘 쓴 예시

공공기관(Public) 고객에게는 랜섬웨어 모니터링(RM)과 정부 유출 모니터링(LM)을 반드시 포함시켜야 합니다. 최근 공공기관 랜섬웨어 피해가 급증해 필수 모듈로 취급해야 합니다.

❌ 효과가 적은 예시

추천이 이상해요. / 모듈 좀 바꿔주세요. / 그냥 다 포함시키세요.
→ 어떤 고객에게, 어떤 모듈을, 왜 바꿔야 하는지 맥락이 없습니다.

예시 칩 — 빠른 시작

입력창 위에 자주 쓰는 예시 버튼이 있습니다. 클릭하면 텍스트가 자동 삽입되므로, 그대로 제출하거나 수정해서 사용하세요.

💡 금융 모듈 💡 대기업 기준 💡 공공기관 💡 학술 기관 💡 유효기간

칩 이름	삽입되는 내용 요약
💡 금융 모듈	금융업 고객 → CL / CB / CDS / UB 기본 추천
💡 대기업 기준	$100K 이상 → 전체 모듈 + Pro 쿼리 티어
💡 공공기관	Public 산업 → RM + LM 필수 포함
💡 학술 기관	교육/학술 → DT + CL만, Basic 티어
💡 유효기간	기본 30일 → 60일 변경 요청

🚀

STEP 3 — 학습 시작

1

🚀 학습 시작 버튼 클릭

팝업 하단 오른쪽의 파란 버튼을 클릭합니다. 버튼이 회전 애니메이션으로 바뀌며 처리 중임을 알립니다.

2

AI 처리 대기 (5~10초)

OpenAI가 피드백을 분석해 견적 가이드 JSON을 생성합니다. 페이지를 닫거나 새로 고침하지 마세요.

3

결과 카드 확인 → 즉시 반영

초록 결과 카드가 나타나면 완료입니다. 팝업을 닫지 않아도 위자드에 즉시 반영됩니다.

✅

STEP 4 — 결과 카드 읽기

학습이 완료되면 팝업 하단에 초록색 결과 카드가 표시됩니다.

결과 카드 예시

✅ 학습 완료
금융업종 고객에게는 CL, CB, CDS, UB 모듈을 기본으로 추천하며, 예산 $5,000 이상이면 전체 모듈을 설정합니다.

🏢 산업별 예산 기준 📦 산업별 모듈 구성 💰 예산 임계값

카드 항목	설명
제목 (✅ 학습 완료)	정상 처리됨. `🔒 시뮬레이션 모드`가 보이면 API 키 없는 테스트 환경
요약 문장	AI가 학습 내용을 한 줄로 요약한 메시지
변경 항목 태그	이번 학습으로 업데이트된 규칙 항목 (산업별 모듈, 예산 기준 등)

ℹ️

즉시 전체 팀 반영 학습 결과는 서버 D1에 저장되어, 다음 접속하는 팀원 누구에게나 자동으로 최신 guidance가 적용됩니다. 별도 배포나 재시작이 필요 없습니다.

📋

이전 학습 내역 확인

팝업 하단 왼쪽의 📋 이전 학습 보기 버튼을 클릭하면 최근 20건의 학습 기록을 확인할 수 있습니다.

항목	내용
강도 배지	학습 강도 숫자 + 색상 (파랑/주황/빨강)
날짜/시간	학습이 완료된 UTC 기준 일시
언어	🇰🇷 한국어 / 🇺🇸 영문 버전 구분
요약	AI가 생성한 해당 학습의 한 줄 요약

⚠️

현재 적용 중인 guidance는 항상 가장 최근 학습 기준입니다. 이전 학습으로 롤백하는 기능은 현재 없습니다. 잘못된 학습을 수정하려면 올바른 내용으로 다시 학습시켜 덮어쓰세요.

🔄

학습이 반영되는 항목 전체

항목	학습 전 기본값	학습 후 변화
산업별 모듈 기본값 industryModules	Public: DT·TT·RM·LM Finance: DT·TT 등 고정값	피드백에 따라 산업별 체크 모듈 세트 재구성
예산 구간 임계값 budgetThresholds	Low: $2,000 / Mid: $6,000	실제 고객 예산 분포에 맞게 재조정
쿼리 수 배율 queryMultipliers	Low: ×0.9 / Mid: ×1.0 / High: ×1.2	예산 구간별 쿼리 증감 비율 재설정
목적별 모듈 구성 purposeModules	Threat: DT·TT·RM Credential: CL·CB·CDS 등	목적 선택 시 자동 추천 모듈 세트 변경
단계별 힌트 메시지 stepHints[0~4]	"회사명을 입력하면 AI가 분석합니다" 등	각 스텝 상단 힌트 문구 업데이트
견적 유효기간 defaultValidity	30일	피드백에 따라 기본 유효일 수 변경
산업별 예산 기준 industryBudgetMap	Public: $100K Enterprise: $50K 등	산업군 선택 시 예산 입력란 자동 기준값 변경

⚠️

사용 시 주의사항

✅ 권장하는 사용법

한 번에 하나의 주제로 집중해서 입력
팀 미팅에서 합의된 피드백을 담당자 1인이 입력
강도 3 이하로 시작 → 결과 확인 → 필요 시 추가 학습
학습 후 위자드에서 실제 견적 테스트로 검증
월 1~2회 취합된 피드백 한꺼번에 입력 권장

❌ 피해야 할 상황

강도 5로 잦은 학습 (팀 전체 로직이 계속 뒤집힘)
개인 취향 수준의 수정 (실제 영업 경험 기반으로만)
동시에 여러 명이 학습 (마지막 학습이 기준, 충돌 발생)
검증 없이 대형 고객 견적에 즉시 적용
여러 주제를 한꺼번에 뭉뚱그려 입력

⚠️

잘못 학습한 경우 수정 방법 롤백 기능은 현재 없습니다. 올바른 내용으로 다시 학습시키면 덮어씁니다. 예: "이전 학습에서 금융 모듈 설정이 잘못됐습니다. 올바른 구성은 CL, CB, CDS입니다."

❓

자주 묻는 질문

Q 학습하면 기존에 저장된 견적 데이터가 변경되나요? ▼

아니요. 기존에 저장된 견적 데이터는 그대로 유지됩니다. 학습은 앞으로 새로 작성되는 견적의 추천 로직에만 영향을 줍니다. 이미 발송된 견적서에는 영향이 없습니다.

Q 학습 결과가 마음에 안 들면 되돌릴 수 있나요? ▼

현재 버전에서는 직접 롤백 기능이 없습니다. 잘못된 학습을 수정하려면 올바른 내용으로 다시 학습시켜 덮어쓰세요. 강도 3~4로 "이전과 달리 XX를 해주세요" 형태로 입력하면 됩니다.

Q 영문(en) 버전에서도 학습이 같이 적용되나요? ▼

네. 학습 결과는 언어에 관계없이 동일한 D1 데이터베이스에서 공유됩니다. 한국어로 학습해도 영문 버전 위자드에 바로 반영됩니다.

Q 얼마나 자주 학습시켜야 하나요? ▼

영업 현장에서 추천 결과가 실제와 다르다고 느껴질 때마다 진행하면 됩니다. 최소 월 1~2회 팀 미팅 시 취합한 피드백을 담당자 1인이 한꺼번에 입력하는 방식을 권장합니다. 지나치게 잦은 학습은 로직 안정성을 떨어뜨릴 수 있습니다.

Q 🔒 시뮬레이션 모드가 표시되면 어떻게 하나요? ▼

OpenAI API 키가 서버에 설정되지 않은 경우 시뮬레이션 모드로 동작합니다. 결과가 표시되더라도 실제 D1에는 저장되지 않습니다. 시스템 관리자에게 OPENAI_API_KEY 설정을 요청하세요.

Q 학습 내용은 누가 볼 수 있나요? ▼

팝업의 📋 이전 학습 보기 버튼으로 최근 20건 요약을 조회할 수 있습니다. 관리자 대시보드(/admin.html)에서는 전체 세션을 확인할 수 있습니다. 입력 내용 원문은 현재 요약 형태로만 표시됩니다.

Q 학습 후 즉시 위자드에 반영이 안 되는 것 같아요. ▼

팝업을 닫은 후 위자드에서 산업군 또는 예산을 다시 선택해보세요. 추천 모듈 체크가 변경되면 반영된 것입니다. 페이지를 새로 고침하면 서버에서 최신 guidance를 다시 불러옵니다.

자동 견적 AI를 직접 가르치세요

산업별 모듈 기본값

예산 구간 기준

쿼리 수 배율

목적별 모듈 구성

단계별 힌트 메시지

견적 유효기간

위자드 페이지 하단으로 스크롤

버튼 클릭

팝업 모달 오픈 확인

예시 칩 — 빠른 시작

🚀 학습 시작 버튼 클릭

AI 처리 대기 (5~10초)

결과 카드 확인 → 즉시 반영

✅ 권장하는 사용법

❌ 피해야 할 상황