하이브리드 검색 지식 베이스와 MCP로 국가 법령정보를 검색하는 Agentic RAG 서비스 개발
배경
- 대국민 법령 검색 서비스 legalQ(리걸큐) 개발 (베타 공개). 일반인이 일상어로 질문하면 관련 법 조항과 위법 여부, 범칙금 등을 근거와 함께 안내.
- 법령 약 3,046개를 Markdown 파일과 Git 이력으로 정리한 공개 저장소 legalize-kr와, 같은 파일을 적재한 Seahorse 벡터 DB 활용

대상 법령
법령명, 소관부처, 공포일과 시행일, 출처 링크. 법령 파일의 frontmatter에서 가져온 정보.
조문 원문 인용
조·항 번호를 그대로 두고 요약이나 의역 없이 인용
제26, 27, 28, 30, 31, 33조 인용 생략

절차 요약 표
인용한 조문의 기한을 단계별로 정리
주의와 면책
적용 범위 주의와 면책 문구, 국가법령정보센터 링크로 마감
문제
옆으로 밀어 전체 보기
구성 요소
- 이전(벡터 DB 1회 조회): 질문 (질문); 하이브리드 검색, 1회 호출; 청크 3개, 1,000자 단위; 답변 생성 (LLM 호출)
- 이후(두 지식원을 쓰는 에이전트): 질문 (질문); 에이전트, 의도 → 경로 → 검증 (에이전트 반복); 벡터 DB, 의미로 찾기; 법령 파일, 정확한 현행 원문; 이력/통계, 커밋/메타데이터; 원문 인용 답변, 출처/면책 (LLM 호출)
연결
- 질문 (이전(벡터 DB 1회 조회)) 다음 하이브리드 검색
- 하이브리드 검색 다음 청크 3개
- 청크 3개 다음 답변 생성
- 질문 (이후(두 지식원을 쓰는 에이전트)) 다음 에이전트
- 에이전트, 벡터 DB 연동
- 에이전트, 법령 파일 연동
- 에이전트, 이력/통계 연동
- 에이전트 다음 원문 인용 답변
필요한 만큼 반복
고충
- 조문이 청크 경계에서 잘림 (하이브리드 검색)
- 필요한 조문이 3개 초과 (청크 3개)
- 개정 이력/과거 원문 없음 (답변 생성)
- "해외직구 세금이 어떻게 되나요?"처럼 일상어로 묻는 질문. 답은 대개 여러 조문, 관련 법령, 시행령과 시행규칙에 분산.
- 에이전트 없이 벡터 DB를 한 번 조회하는 워크플로우로는 복합 질의와 일상어 질의에 대응 불가. 개정 시점을 묻는 질문에 필요한 개정 이력도 벡터 DB에는 없는 상태.
- 요약, 의역, 개정 전 조문 인용은 이용자를 오도하므로 답변에는 조문번호와 출처를 붙인 최신 원문 인용 필요
역할
- ML 엔지니어로 참여해 전체 아키텍처, 벡터 DB, 에이전트 시스템 프롬프트를 설계하고 서비스 배포 담당
- 법령을 조·항 단위로 벡터 DB에 적재하고 에이전트가 법령 저장소에 결정론적으로 접근하는 MCP 서버 설계
접근
- 두 지식원을 MCP로 하나의 에이전트에 연결. 벡터 DB에서 의미로 조문을 찾고 Markdown 저장소에서 정확한 현행 원문, 개정 이력, 통계를 조회하도록 설계.
- 벡터 DB를 교통과 기업 법령 12개에서 전체 약 3,046개로 확장. 법령과 조문 메타데이터를 붙여 조·항 단위로 다시 적재하고 Dense/BM25 하이브리드 검색에 사용.
- 질문을 6가지 의도로 분류해 벡터 DB, 법령 파일, 부칙, 파일 메타데이터 중 경로를 고르는 시스템 프롬프트 설계. 최신성 신호가 있으면 저장소 최신 원문으로 다시 확인하고 벡터 결과가 빗나가면 키워드 검색으로 전환.
- 저장소의 폴더 구조, 파일명 규칙, 작성 규약을 프롬프트에 미리 넣어 에이전트가 검색 없이 파일 경로를 만들고 조문을 찾도록 구성
주요 결정
| 결정 | 이유 | 트레이드오프 |
|---|---|---|
| 서로 보완하는 두 지식원 | 벡터 DB로는 일상어로 조문을 찾고 벡터 DB에 없는 정확한 현행 원문, 이력, 통계는 저장소에서 조회 | 두 지식원의 동기화와 라우팅 규칙 관리 부담 |
| 단일 에이전트의 프롬프트로 의도 라우팅 | 토큰 사용량이 크게 늘어나는 멀티에이전트보다 의도 규칙을 둔 단일 에이전트가 단순 질문을 적은 호출로 처리 | 규칙이 늘수록 길어지는 시스템 프롬프트 |
| 프롬프트에 넣은 저장소 지도 | 에이전트가 검색 호출 없이 파일 경로를 만들어 조문 제목에 바로 접근 | 저장소 구조가 바뀌면 프롬프트도 수정 필요 |
| 조·항 단위 청크 | 조문이 잘리거나 묶여 인접 청크 호출이 늘던 기본 1,000자 청크 대신 조문 단위 행으로 인용 질의를 한 번에 회수 | 자체 파서 유지와 법령이 바뀔 때마다 재적재 |
두 지식원 비교
| 항목 | 벡터 DB(Seahorse) | 법령 저장소(legalize-kr) |
|---|---|---|
| 에이전트 안 역할 | 발견: 의미로 조문 위치 찾기 | 검증: 정확한 현행 원문, 이력, 통계 |
| 검색 방식 | Dense/BM25 하이브리드 | 키워드 검색, 경로로 파일 조회 |
| 일상어 질문 | 강함 | 약함, 법률 용어 필요 |
| 컨텍스트 비용 | 관련 청크만 | 파일 전체, 큰 법령은 부분 조회 |
| 개정 이력/과거 원문 | 없음, 현행만 | Git 커밋으로 조회 |
| 최신성 | 주기적 재적재, 시차 있음 | 저장소 최신 커밋 |
| 구축 비용 | 높음: 청킹, 임베딩, 적재 | 낮음: 저장소 연결 |
에이전트는 벡터 DB로 조문을 찾고 저장소에서 확인
시스템 프롬프트
옆으로 밀어 전체 보기
구성 요소
- 멀티턴 처리, 턴마다 새로 분류; 전처리 규칙, 규칙 4개; 폴백 #0, 별표 즉시 마감; 의도 분류, 의도 6가지; 라우팅 테이블, 6행; 워크 플로우, 작업 유형 5개; 검증 파이프라인, 최신성 키워드 17개; 폴백 #1–#5, 0건/어긋남/오류; 출력 형식, 원문/출처/면책; 참고 지식: 도구 소개, 저장소 구조/스키마, 조회/검증 단계가 참고 (참고 지식); 예외 처리(12가지), 미발견/모호/API 오류 …
연결
- 참고 지식: 도구 소개, 저장소 구조/스키마에서 워크 플로우로 반환
- 참고 지식: 도구 소개, 저장소 구조/스키마에서 폴백 #1–#5로 반환
각 상자 = 시스템 프롬프트의 섹션, 아래 줄 = 그 섹션에 든 규칙 수
옆으로 밀어 전체 보기
저장소(legalize-kr): kr/, 근로기준법/, 법률.md, 시행령.md, 시행규칙.md, 민법/, 법률.md, 도로교통법/, 법률.md …
법령 폴더 약 3,046개
폴더 = 법률, 시행령, 시행규칙 세트
법령 파일 하나: kr/근로기준법/법률.md
- 메타데이터 (대상 법령 표시/통계): 제목: 근로기준법 / 법령구분: 법률 / 소관부처: [고용노동부] / 공포일자: 2026-08-04 / 시행일자: 2026-10-02 / 상태: 시행 / 출처: law.go.kr/법령/근로기준법
- 조문 제목 줄 (검색 없이 바로 찾음): ## 제23조 (해고 등의 제한) / ① 사용자는 근로자에게 정당한 이유 없이 …
- 부칙 표시 (개정 이력의 근거): ## 부칙 / 부칙 <제{번호}호,{공포일자}>
커밋 메시지: 법률: 근로기준법 (일부개정). 개정 1건 = 커밋 1개 → 시점 비교
아키텍처
옆으로 밀어 전체 보기
구성 요소
- 이용자: 웹 챗 legalQ, 데스크톱/모바일 (이용자); 대화 기록, 브라우저 암호화 저장
- 에이전트 서버: 가드레일, IP 제한/동시성/개인정보; 에이전트, 도구 호출 반복(최대 8턴) (에이전트/LLM); Claude Sonnet 4.6 (에이전트/LLM); 시스템 프롬프트, 의도/라우팅/저장소 지도 (시스템 프롬프트)
- Seahorse MCP: search; adjacent chunks
- GitHub MCP: search_code; get_file_contents; list_commits
- 지식원: Seahorse 벡터 DB, Dense/BM25 하이브리드, 조·항 단위 청크; legalize-kr 저장소, 법령 약 3,046개 Markdown, Git 이력; 조·항 단위 재적재; 원천: 국가법령정보센터 (외부 원천)
연결
- 웹 챗 legalQ, 에이전트 연동
- 에이전트, Seahorse MCP 연동
- 에이전트, GitHub MCP 연동
- Seahorse MCP, Seahorse 벡터 DB 연동
- GitHub MCP, legalize-kr 저장소 연동
- legalize-kr 저장소 다음 조·항 단위 재적재
- 조·항 단위 재적재 다음 Seahorse 벡터 DB
- 원천: 국가법령정보센터 다음 legalize-kr 저장소
서비스 흐름
옆으로 밀어 전체 보기
구성 요소
- 질문 (조건부 호출); 전처리, 공백/가운뎃점 정규화; 별표?; 국가법령정보센터 안내, 추가 호출 없이 마감; 의도 분류, 의도 6가지 (LLM 판단); 원문 인용, 출처, 면책, 조·항·호 번호 그대로 (LLM 판단)
- 벡터 DB(Seahorse MCP): search, 의미 검색; search, 404면 법령명 확인 (조건부 호출); search, "법령명 부칙"; search, 주제 기반이면 (조건부 호출)
- 법령 저장소(GitHub MCP): get_file_contents, 최신성 신호가 있으면 (조건부 호출); search_code, 0건/불일치 (조건부 호출); get_file_contents, 경로로 직행; get_file_contents, 부족하면 부칙 파싱 (조건부 호출); list_commits → get_file_contents ×2, 두 시점의 커밋; get_file_contents ×N, 법령마다 1회; search_code, frontmatter(근사치)
연결
- 질문 다음 전처리
- 전처리 다음 별표?
- 별표? 다음 국가법령정보센터 안내
- 별표? 다음 의도 분류
- search (벡터 DB(Seahorse MCP)) 다음 get_file_contents (법령 저장소(GitHub MCP))
- search (벡터 DB(Seahorse MCP))에서 search_code (법령 저장소(GitHub MCP))로 반환
- get_file_contents (법령 저장소(GitHub MCP))에서 search (벡터 DB(Seahorse MCP))로 반환
- search (벡터 DB(Seahorse MCP))에서 get_file_contents (법령 저장소(GitHub MCP))로 반환
- get_file_contents ×N에서 search (벡터 DB(Seahorse MCP))로 반환
- 벡터 DB(Seahorse MCP) 다음 원문 인용, 출처, 면책
- 법령 저장소(GitHub MCP) 다음 원문 인용, 출처, 면책
의미 검색
기본값
조문 검색
개정 이력
시점 간 비교
법령 간 비교
통계
성과
- 생활 법률 질문에 조문 원문, 출처, 면책 문구를 붙여 답하는 legalQ를 대국민 베타로 공개
- 검색 범위를 첫 벡터 DB의 법령 12개에서 저장소 전체 약 3,046개로 확대
- 개정 이력 조회, 멀티턴 후속 질문, 정체성 보호, 개인정보 입력 거절을 반영해 시스템 프롬프트를 6차에 걸쳐 개선