공식 문서AQI AI에서 직접 테스트하지 않음

RAG 시작 전: 올바른 자료 검색 확인

가상 문서 6개·질문 6개로 검색·출처 ID·답변 불가 사례를 확인합니다. 모델 없는 자체 오프라인 Node.js 예제입니다.

최근 확인일: 2026-10-22버전: 1.0.0

확인할 모델

핵심 용어 안내

모델은 생성과 추론을 담당합니다. 에이전트는 도구를 사용해 작업을 수행합니다. Harness는 에이전트의 실행 환경을 관리합니다. MCP는 도구와 데이터를 연결하는 프로토콜입니다. Skill은 재사용 가능한 작업 지침입니다.

시작 전 준비

사전 조건

Node.js 22+·압축 해제·새 쓰기 폴더. GPU·Python·계정·키·모델 불필요. 영어 자료는 8개 언어 평가가 아닙니다.

모델 / 서비스

처음에는 모델 없이 단어 일치 검색과 지표만 계산합니다.

에이전트 / 실행 환경

Agent·MCP·서버 없이 문서 텍스트는 데이터로만 처리합니다.

예상 소요 시간

20–30 min

실행 단계

파일 4개를 풀고 README·MIT를 읽으세요. 비공개 문서·비밀은 넣지 마세요.
해당 폴더에서 Node.js 22 이상 확인 후 node retrieval.mjs 실행. npm 패키지·모델·DB 불필요.
후보 ID와 relevantIds를 비교하고 원문을 읽으세요. 높은 점수는 단어 일치일 뿐 근거의 정확성 보장이 아닙니다.
k=1·k=2를 비교하세요. 백업 질문은 정답 문서 2개이므로 첫 항목이 맞아도 Recall@1은 0.5입니다.
답변 불가 질문 2개를 보세요. 하나는 빈 결과, 하나는 오검색입니다. 후보를 AI 답변·안전 인증으로 보지 마세요.
복사본 저장 후 참조 ID를 missing-id로 바꾸어 오류·비정상 종료를 확인하세요. 원본 복원 후 다시 실행하세요.
권한 있는 작은 자료에 정답을 독립 표시하세요. 모델 비교 시 자료·라벨·k를 고정하고 라이선스·백엔드·비용을 별도 확인하세요.

명령과 예제

AQI AI에서 직접 테스트하지 않음

# In the extracted example folder; original synthetic English data only.
node --version
node retrieval.mjs
node retrieval.mjs fixture.json 1
node retrieval.mjs fixture.json 2
# Back up fixture.json, change one relevant ID to missing-id, and rerun.
# Expect a nonzero input error, then restore the original file and rerun.

검증 항목

Windows/Node.js에서 자체 어휘 일치 연습만 실행했습니다. 원본·잘못된 참조 실패·복원·k=1 확인. 실제 모델·RAG 답변 미검증이며 답변 불가 오검색 1개를 의도적으로 보여 줍니다.

자주 발생하는 문제

파일 누락은 압축 해제 폴더에서 실행하세요. missing-id 오류 후 복원하세요. 재현율은 답변 정확도가 아니며 음성 사례를 지워 수치를 높이지 마세요.

비용

무료 소프트웨어입니다. 라이선스와 컴퓨팅 비용은 별도로 확인하세요

MIT 예제는 무료·API 호출 없음. 기기·전력은 별도이며 실제 모델·호스팅 비용은 따로 확인하세요.

제한과 적용 범위

권한과 위험

선택한 예제 파일을 읽어 콘솔에 출력할 뿐 네트워크·업로드·포트·자격 증명 접근은 없습니다. 실제 서비스 추가 시 데이터 경로를 재확인하세요.

대안과 다음 단계

오픈 소스 대안도 하드웨어나 모델 호출에 비용이 들 수 있습니다.

프로그램 없이 표로 질문·정답 ID·검색 건수를 기록할 수도 있습니다. 실제 모델·서비스 비용·라이선스·하드웨어는 별도 확인하세요.

원본 출처

Sentence Transformers · Retrieve & Re-Rank ↗
www.sbert.net · 2026-10-22 · 공식 문서
Sentence Transformers · InformationRetrievalEvaluator ↗
www.sbert.net · 2026-10-22 · 공식 문서
Nemotron 3.5: 파싱·검색·재순위 구분 ↗
huggingface.co · 2026-10-22 · 공식 문서