활용 가이드¶
RAG4U를 잘 쓰려면 질문을 "문서에서 근거를 찾을 수 있는 형태"로 만들어야 합니다.
핵심 사고방식¶
사람도 어떤 내용을 확인할 때 모든 문서를 처음부터 끝까지 읽지 않습니다. 먼저 관련 문서를 좁히고, 그 안에서 조항이나 절차를 확인합니다. RAG4U도 같은 방식으로 동작합니다.
질문
-> 관련 청크 검색
-> 근거 청크만 provider에 전달
-> 답변과 citation 표시
좋은 질문¶
좋은 질문은 문서 안에 있을 법한 단어, 대상, 절차, 조건을 포함합니다.
E37 오류는 무엇을 의미하나요?
출장 영수증은 언제까지 제출해야 하나요?
기밀 문서를 외부 서비스에 공유하려면 어떤 승인이 필요한가요?
P-101 최근 알람과 정비 이력을 같이 요약해줘.
C-201 온도 센서 추세와 최근 CRITICAL 알람을 함께 확인해줘.
좋지 않은 질문¶
너무 넓거나 문서 밖 판단을 요구하는 질문은 품질이 떨어집니다.
우리 회사 정책 전체를 요약해줘
이 정책이 법적으로 완벽한지 판단해줘
출장비를 최대한 많이 받을 방법을 알려줘
필요하다면 이렇게 바꿉니다.
호텔 비용이 도시별 한도를 초과하면 어떤 승인이 필요한가요?
Top K¶
Top K는 질문과 관련 있는 문서 청크를 몇 개 가져올지 정하는 값입니다.
| 값 | 적합한 상황 |
|---|---|
| 3 | 오류 코드, 단일 절차, 짧은 매뉴얼 질문 |
| 5 | 정책, 예외 조건, 여러 섹션이 관련될 수 있는 질문 |
| 8 이상 | 문서가 많고 같은 주제가 여러 문서에 흩어진 경우 |
값이 너무 크면 관련 없는 청크가 섞일 수 있습니다. 먼저 3 또는 5로 시작하세요.
Agentic DB Tools¶
문서 검색만으로 부족하고 운영 데이터가 필요한 질문은 DB tool을 함께 켤 수 있습니다.
| Tool | 쓰임 |
|---|---|
get_alarm_history |
설비 알람 이력, 심각도, 발생/해제 시각 조회 |
get_sensor_trend |
압력, 온도, 진동 등 센서 추세 조회 |
get_maintenance_history |
점검, 수리, 교체 등 정비 이력 조회 |
질문 예시:
P-101 최근 알람과 정비 이력을 같이 요약해줘.
C-201 온도 상승 전후 센서 추세와 알람을 확인해줘.
HX-301 차압 알람 이후 정비 조치가 있었는지 알려줘.
enable_tools=true일 때 OpenAI 또는 Codex provider가 필요한 tool을 선택합니다. LLM이 SQL을 직접 실행하지 않고, RAG4U가 정의한 read-only tool만 실행합니다.
Domain Profile¶
domain_profile은 문서 유형별 답변 방식과 안전 정책을 선택하는 값입니다.
| Profile | 용도 |
|---|---|
general |
일반 문서 |
manual |
장비/제품 매뉴얼 |
internal-policy |
사내 규정, 정책, 절차 |
정책 문서에 manual profile을 쓰면 답변 톤과 우선 메타데이터가 어긋날 수 있습니다.
Citation 읽는 법¶
답변 아래 citation에는 다음 정보가 표시됩니다.
- 파일명
- 섹션 또는 페이지
- 검색된 근거 스니펫
- 로컬 파일 경로
업무에 사용할 때는 답변만 믿지 말고 citation을 열어 원문 근거가 실제 질문과 연결되는지 확인합니다.
근거 없음이 중요한 이유¶
RAG 시스템은 항상 답하는 시스템이 아니라, 근거가 없으면 멈추는 시스템이어야 합니다.
예를 들어 샘플 문서에는 X100의 무게가 없습니다.
ACME Cooler X100의 무게는 몇 kg인가요?
이 질문에는 정확한 답을 만들 수 없어야 합니다. 회사 내규나 보안 정책에서는 이 거절 동작이 답변 생성보다 더 중요합니다.