AI 모델LLM openai/gpt-oss-20b Hugging Face Router · 추론 low임베딩 sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2 컨테이너 로컬 · 384차원 · CPU
기술RAG(검색 증강 생성) · FastAPI 0.115.12 · PostgreSQL 16.15 + pgvector 0.8.6 (HNSW·코사인) · Docker
라이브러리sentence-transformers 6.2.0 · PyTorch 2.15.0 (CPU) · transformers 5.22.2 · pypdf 7.0.1 · httpx 0.28.1 · SQLAlchemy 2.0.40 · asyncpg 0.30.0 · marked 15.0.12 · DOMPurify 3.2.6
업무 도구RAG 문서 질의응답 상태 확인 중…

RAG 문서 질의응답

PDF·텍스트 문서를 올려 벡터 검색과 LLM 으로 근거 있는 답변을 받는 문서 질의응답 도구

등록 문서– 
색인 청크– 
임베딩 모델– 
벡터 DB– 

문서 업로드

PDF · TXT · MD

    문서 목록

    불러오는 중…

    질의응답

    Ctrl + Enter 로 전송

    답변

    질문을 입력하면 답변이 여기에 표시됩니다 문서에서 찾은 근거를 [번호] 로 인용해 Markdown 으로 정리합니다.

    RAG API 엔드포인트

    main.py 에 등록된 /rag 라우터
    GET/rag/status

    RAG 상태 조회

    DB·pgvector·임베딩 모델·LLM 구성과 색인 통계를 조회합니다.

    열기Swagger
    GET/rag/routes

    RAG 라우터 정보

    main.py 에 등록된 RAG 라우트 목록(경로·메서드·설명)을 조회합니다.

    열기Swagger
    GET/rag/documents

    문서 목록

    색인된 문서 목록을 최신순으로 조회합니다.

    열기Swagger
    POST/rag/documents

    문서 업로드·색인

    PDF·TXT·MD 파일을 업로드하면 텍스트 추출 → 청크 분할 → 로컬 임베딩 → pgvector 저장까지 수행합니다.

    Swagger
    GET/rag/documents/{document_id}

    문서 상세

    문서 메타데이터를 조회합니다.

    Swagger
    GET/rag/documents/{document_id}/chunks

    문서 청크 조회

    문서가 분할된 청크(페이지·토큰 수·본문)를 순서대로 조회합니다.

    Swagger
    DELETE/rag/documents/{document_id}

    문서 삭제

    문서와 해당 청크·임베딩을 삭제합니다.

    Swagger
    DELETE/rag/documents

    전체 문서 삭제

    색인된 모든 문서·청크·임베딩을 삭제합니다.

    Swagger
    POST/rag/query

    질의응답

    질문을 임베딩해 관련 청크를 검색하고, LLM 이 출처 번호와 함께 Markdown 답변을 생성합니다.

    Swagger

    문서 청크