← Docs hub

LLM 운영 패키지

기준일: 2026-07-07
대상 코드:

• On-device: ~/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent
• Cloud LLM: ~/work/8.cloudLLM/backend-cloud-llm-lambda

바로가기

• 운영 Wiki 진입
• 요일별 운영 계획
• 운영 해설서
• 기능별 구현 설계도 인덱스
• PDF 출력 품질 게이트

구성

• lecture_plan.md: 월~금 요일별 운영 계획
• instructor_script.md: 운영 해설 문서
• function_flows_index.md: 기능별 SK 토큰 구현 SVG 인덱스
• pdf_export_guide.md: PDF 출력 전 링크/그림/표현/소스 근거 품질 게이트
• svg/pdf-safe/pdf_week_curriculum_map.svg: 주간 운영 전체 구조
• svg/pdf-safe/pdf_reading_path_map.svg: 목적별 PDF 읽는 순서
• svg/pdf-safe/pdf_quality_gate_checklist.svg: PDF 산출 전 품질 게이트
• svg/pdf-safe/pdf_cloud_lambda_rag_map.svg: Cloud LLM Lambda/RAG 구조
• svg/pdf-safe/pdf_dictionary_pipeline_map.svg: 온디바이스 딕셔너리 처리 흐름
• svg/pdf-safe/pdf_function_flow_index_reader.svg: 기능별 SK 토큰 구현 설계도 읽는 법
• svg/pdf-safe/pdf_operational_artifact_lifecycle.svg: 테스트 결과, 이슈 리포트, 회귀 검증으로 이어지는 운영 산출물 흐름
• svg/pdf-safe/pdf_table_split_rule.svg: PDF에서 넓은 표를 읽기 쉽게 나누는 기준
• svg/pdf-safe/pdf_log_evidence_ladder.svg: raw/processed/token/Cloud/API 로그 근거를 조합해 판정하는 기준
• svg/pdf-safe/pdf_malaysia_decision_router.svg: 말레이시아 현지 발화를 제품 기능/RAG/Web/미지원/dictionary 개선으로 분류하는 기준
• svg/architecture/: 기존 아키텍처 SVG 모음
• svg/ondevice_function_flows/: SK 토큰별 구현 설계 SVG 모음

권장 진행 순서

1. svg/pdf-safe/pdf_reading_path_map.svg로 목적별 읽는 순서를 확인한다.
2. svg/pdf-safe/pdf_week_curriculum_map.svg로 전체 운영 목표를 확인한다.
3. 월요일에는 svg/pdf-safe/pdf_stt_cloud_input_boundary.svg, svg/ondevice_function_flows/00_common_state_multiturn_flow.svg를 사용한다.
4. 화요일에는 svg/pdf-safe/pdf_dictionary_pipeline_map.svg와 function_flows_index.md를 사용한다.
5. 수요일에는 svg/pdf-safe/pdf_cloud_lambda_rag_map.svg를 사용한다.
6. 목요일에는 svg/architecture/api_call_validator_mr8_summary.svg와 실제 logcat 예시를 사용한다.
7. 금요일에는 실제 SQE/필드 이슈를 위 분류 기준에 따라 재현하고 원인 분석 리포트 형식으로 정리한다.

전달 시 주의

• 본 문서는 현재 구현 상태 기준입니다. 제품 사양서와 차이가 있으면 제품 사양서가 우선입니다.
• SK 토큰별 SVG는 자동 추출 기반이므로, 복잡 기능은 별도 상세 SVG와 함께 봐야 합니다.
• Cloud LLM 구조는 PROJECT_OVERVIEW_KR.md와 현재 lambda_function.py/gemini/ 구조 기준입니다.