인증 정보 입력
.env에 채널톡, OpenAI, Hugging Face API 키를 입력합니다.
전체 문의—
답변 확인필요—
유형채널일시최근 대화답변 상태
상담 사례를 불러오는 중입니다.
왼쪽 목록에서 상담을 선택해 주세요.
분류 기준을 불러오는 중입니다.
고객 문의답변 지식관리
FAQ를 불러오는 중입니다.
문서 제목문서 내용관리
문서 정보를 불러오는 중입니다.
OPERATIONS HANDBOOK
Relay를 안전하게
운영하는 방법
설치부터 자동 전송 전환까지, 꼭 필요한 절차와 파라미터를 한곳에 정리했습니다.
01
QUICK START
세 단계로 시작하세요
지식 구성
지식 관리에서 답변에 사용할 FAQ와 문서 정보를 확인하고 필요한 내용을 추가합니다.
답변 검수
운영 콘솔에서 대표 문의를 테스트하고 유사도와 생성 답변을 확인합니다.
Terminal
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env
python -m cs_assistant.main02
RESPONSE FLOW
문의가 답변이 되기까지
채널톡 대화와 문의·답변 변경을 가져와 Vector DB를 갱신합니다.
이전 대화가 있으면 맥락을 포함해 커스텀 기준으로 분류합니다.
과거 상담에서 가까운 사례를 찾아 답변 초안을 생성합니다.
고유사도는 자동 전송하고 저유사도는 답변 확인필요로 보관합니다.
03
PARAMETERS
주요 파라미터
주요 운영값은 옵션 탭에서 즉시 변경할 수 있습니다. 운영 전에는 기본값으로 충분히 검수한 뒤 조정하세요.
AI
답변 생성
GPT 모델의 품질·속도·출력 범위를 설정합니다.
환경변수기본값설명
OPENAI_MODELgpt-5.6-luna최종 답변을 생성할 OpenAI 모델OPENAI_REASONING_EFFORTlow추론 강도. 높을수록 응답 시간이 늘 수 있습니다.OPENAI_MAX_OUTPUT_TOKENS500생성 답변의 최대 출력 토큰GENERATION_MAX_RETRIES3생성 실패 문의의 자동 재시도 횟수GENERATION_RETRY_BASE_SECONDS60지수 백오프 재시도의 기본 간격(초)OPENAI_STOREfalseOpenAI 측 응답 저장 여부RAG
검색과 지식
과거 상담의 범위와 유사도 기준을 조정합니다.
환경변수기본값설명
HISTORY_DAYS14저장하고 검색할 과거 상담 기간EMBEDDING_MODELembeddinggemma-300mCPU에서 실행되는 로컬 임베딩 모델SIMILARITY_THRESHOLD0.72GPT 답변 생성을 허용하는 최소 유사도TOP_K3답변 생성에 참고할 최대 상담 사례 수OPS
운영과 안전
호출 주기와 실제 메시지 전송을 제어합니다.
환경변수기본값설명
POLL_INTERVAL_SECONDS300채널톡 대화 동기화 주기(5분)MAX_REQUESTS_PER_SECOND9.0채널톡 API 초당 최대 요청 수DRY_RUNtruetrue이면 답변을 생성해도 채널톡에 보내지 않음AUTO_REPLY_ENABLEDfalse자동응답 기능 활성화 여부04
GO LIVE
검수가 끝났다면
자동 전송으로 전환하세요.
대표 문의를 충분히 테스트하고 개인정보·배송·환불 답변을 확인한 뒤 두 값을 함께 변경합니다.
AUTO_REPLY_ENABLED=falseDRY_RUN=false서버를 실행할 때마다 자동 전송은 꺼집니다. 옵션 탭에서 직접 활성화해 주세요.