RAG 튜토리얼 25개의 기록
RAG 25. 로컬 API 운영: 상태 확인, 입력 제한, 본문 없는 로그와 스모크 테스트
터미널 검색기를 로컬 HTTP API로 감싸고 정상 동작을 다시 확인하는 방법을 만듭니다. 상태 확인, 입력 제한, 근거 출처, 본문 없는 로그까지 붙여 25편의 실습을 마무리합니다.
RAG 24. 성능과 비용: 로컬 검색 시간을 재고 호출 예산을 따로 잡자
검색이 느린지, 답변 생성이 비싼지 먼저 나눠 봅니다. 3,000개 가상 문서의 로컬 검색 지연을 실제로 재고, 별도의 가상 요금 계산기로 요청 예산을 제한합니다.
RAG 23. 프롬프트 인젝션: 문서의 지시를 데이터로 다루고 출력을 제한하기
검색한 문서에 “이전 규칙을 무시하라”는 문장이 있으면 어떻게 할까요? 문서와 지시를 분리하고, 허용한 근거·출력 형식만 통과시키는 작은 검증기를 만듭니다.
RAG 22. 권한 기반 검색: 다른 사용자의 문서를 순위 계산 전에 제외하기
답변을 출력할 때만 비공개 문서를 가리면 이미 늦을 수 있습니다. 사용자와 조직 권한을 먼저 확인해, 허용된 본문만 검색 순위 계산 함수에 전달하는 구조를 만듭니다.
RAG 21. 문서 갱신: 같은 내용은 건너뛰고 오래된 청크는 지우자
문서를 다시 넣을 때 청크가 계속 늘어나거나, 삭제한 문장이 검색에 남는 문제를 막습니다. 내용 해시와 SQLite 트랜잭션으로 한 문서의 청크를 통째로 안전하게 교체합니다.
RAG 20. 평가 대시보드: 정답 질문으로 Recall과 실패 사례 함께 보기
검색 방식을 바꾸기 전후에 같은 질문을 실행하고, 어떤 질문이 좋아졌는지 파일로 남깁니다. 손으로 정답을 붙인 여섯 질문으로 검색 지표를 직접 계산하고 로컬 HTML 대시보드를 만듭니다.
RAG 19. 실시간 문서 수집: 늦게 온 이벤트와 오래된 근거 구분하기
새 문서가 들어왔다고 검색 결과가 최신이라는 뜻은 아닙니다. 순서가 뒤바뀐 갱신 이벤트, 중복 전달, 오래된 원문을 구분하는 작은 수집기를 만듭니다.
RAG 18. 재무 보고서 검색: 숫자와 기간·통화·단위를 함께 꺼내자
재무 보고서에서 매출을 찾을 때 숫자만 꺼내면 서로 다른 기간이나 통화를 비교하기 쉽습니다. 가상의 연차·분기 보고서를 사용해 비교 조건이 맞는 근거만 고르고, 기준이 다르면 계산을 멈추는 프로그램을 만듭니다.
RAG 17. 의료 지침 검색의 경계: 가상 교육 프로토콜로 버전·범위 확인하기
가상 의료 교육실의 연습 문서에서 “교육기록” 항목을 찾습니다. 승인본·초안·구판을 구분하고 문서 버전과 출처를 함께 반환하되, 실제 진단이나 치료 질문은 입력 범위에 넣지 않습니다.
RAG 16. 다국어 검색: 한국어 질문을 영어 검색어로 바꾸어 근거 찾기
한국어로 “비밀번호 재설정”을 입력해 영어 도움말을 찾습니다. 한국어 원문, 검색에 쓴 영어 표현, 영어 근거를 따로 남겨 번역이 검색 결과를 어떻게 바꾸는지 확인합니다.
RAG 15. 지식 그래프 검색: 관계를 따라가되 원문 근거를 놓치지 않기
checkout 서비스에서 두 단계 떨어진 ledger의 담당 팀을 찾습니다. 그래프 경로만 출력하지 않고, 각 연결이 어떤 원문에 적혀 있는지도 함께 보여 주는 작은 Graph RAG 검색기를 만듭니다.
RAG 14. 에이전틱 검색 입문: 계획·재검색·중단 조건을 코드로 드러내기
청구서 내보내기 질문에 절차와 권한 근거가 모두 모일 때만 답하도록 만듭니다. 첫 검색에서 빠진 부분은 다른 검색어로 다시 찾되, 정해진 횟수를 넘거나 근거가 부족하면 멈춥니다.
RAG 13. 하이브리드 검색: BM25·RRF를 구현하고 임베딩 API 연결하기
비밀번호 도움말을 단어 검색으로 찾고, 두 검색 목록을 순위 기준으로 합칩니다. 기본 데모에서는 수동 순위로 합산 동작을 검증하고, 실제 임베딩 API를 연결하는 실행 경로도 분리해 둡니다.
RAG 12. 멀티모달 검색: 캡션과 실제 이미지 근거를 함께 전달하기
“빨강”을 검색하면 빨간 정사각형 이미지와 사람이 적은 캡션을 함께 찾습니다. 기본 실행은 캡션 검색까지만 수행하고, 선택 실행에서는 검색된 PNG 자체를 이미지 입력을 지원하는 모델에 전달합니다.
RAG 11. 상품 검색: 가격·재고·규격은 점수보다 먼저 거른다
“10만 원 이하, 재고가 있는 USB-C 저소음 키보드”를 찾습니다. 설명이 아무리 비슷해도 비싸거나 품절인 상품은 결과에 들어오지 않도록, 필수 조건과 검색 점수를 분리합니다.
RAG 10. 인사 규정 Q&A: 기준일과 직원 구분부터 확인하기
같은 “연차 신청” 질문에도 2025년에는 포털 A, 2026년에는 포털 B가 나오는 검색기를 만듭니다. 직원 구분까지 먼저 거르면, 검색어가 비슷하다는 이유로 다른 규정이 섞이는 문제를 줄일 수 있습니다.
RAG 09. 논문 요약: 섹션 출처와 참고문헌 인용을 따로 지키기
가상 미니 논문을 섹션별로 발췌하고 출처 id와 참고문헌을 검증합니다. 선택적으로 실제 Responses API 생성 요약을 연결합니다.
RAG 08. 계약서 조항 검색: 연결된 예외 조항을 빠뜨리지 않기
가상 계약서의 조항을 검색한 뒤 참조된 예외까지 확장합니다. 법률 판단 없이 원문·줄 번호·연결을 보존하는 실습입니다.
RAG 07. 코드베이스 검색: 함수 경계와 파일·줄 번호를 함께 남기기
Python AST로 함수와 메서드를 나누고 파일 경로·원문 줄 번호를 보존하는 로컬 코드 검색기를 만듭니다.
RAG 06. 고객지원 답변 만들기: 정책 안내와 상담원 확인 나누기
날짜·지역·상품에 맞는 가상 정책을 고르고, 일반 안내·추가 질문·상담원 확인을 나눠 불필요한 모델 호출을 막습니다.
RAG 05. 이력서와 공고 연결하기: 기술명보다 경험 근거를 확인하자
가상 이력서와 공고를 기술별로 연결하고 프로젝트·수강·계획을 구분합니다. 점수나 채용 결정 없이 검토할 근거와 빈칸을 보여 줍니다.
RAG 04. 유튜브 자막 Q&A: 답변 근거에 시간 구간 붙이기
가상 VTT 자막에서 관련 구간을 찾고 가까운 문맥만 확장해, 시간 인용이 남는 Q&A 경로를 구현합니다.
RAG 03. 개인 메모 검색기: 수정한 내용은 갱신하고 지운 메모는 없애기
Markdown 메모를 태그와 제목으로 검색하고, 파일 해시로 수정·삭제를 반영하는 로컬 색인을 만듭니다.
RAG 02. 강의계획서 Q&A: 주차와 평가 기준을 먼저 좁히기
가상 강의계획서의 주차·항목 종류를 필터링하고 평가 비중을 검증한 뒤, 근거가 있는 질문만 생성 모델로 보내는 실습입니다.
RAG 01. PDF 챗봇 만들기: 답변보다 먼저 페이지 근거를 확인하자
가상 PDF를 읽고 질문과 관련된 문장·페이지를 찾은 뒤, 선택적으로 언어 모델을 연결하는 첫 RAG 실습입니다.
다른 검색어나 카테고리를 선택해 주세요.