Project

General

Profile

Feature #1560

open
YK YK

[T56] RAG Q&A API·인용 근거 검증

Feature #1560: [T56] RAG Q&A API·인용 근거 검증

Added by Yeoreum Kim 11 days ago. Updated 8 days ago.

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
12/07/2026
Due date:
12/16/2026 (Due in 29 days)
% Done:

90%

Estimated time:

Description

등록 정보

  • 신청자: 김여름 (GitHub ID: kyrdufmal-summer)
  • 신청 상태: 신청. 사용자 요청으로 담당자 김여름(계정 표시명: Yeoreum Kim) 지정. PM 승인 여부는 별도 확인.
  • 영역: Backend/AI / 작업지시서 우선순위: P2
  • 등록은 착수·완료 또는 PM 승인 확정을 의미하지 않음. 일정 미정.

목적

검색 근거로만 답변하고 인용 chunk/ref와 모델 버전·거부/근거없음 상태 반환.

개발 범위

근거 없는 질문·허위 인용·프롬프트 인젝션·시간초과·비용/토큰 상한·사용자 ACL 검증.

선행조건

  • 선행 일감: T25,T54
  • 관련 요구사항 및 DB/API 계약의 확정·미확정 사항 확인. 선행 결과의 실제 완료 증빙 또는 명시적으로 승인된 mock 계약 확인 후 구현. 선행 미완료 시 설계/mock 범위로 제한하고 실제 연동은 HOLD.
  • 참조: docs/FULL_SCOPE_TRACEABILITY.md, docs/API_CONTRACT.md, database/FULL_DATABASE_MODEL.md, docs/AI_SYSTEM_ARCHITECTURE.md

산출물

/api/v1/knowledge/answer·citation verifier·pytest.

  • 개인 브랜치: task/t56-short-description (담당 확정 후 생성)

완료 기준

  • 응답 인용이 실제 권한 있는 chunk와 일치, 근거없음 처리 PASS.
  • 정상·오류·입력 경계 및 권한/보안 테스트의 재현 가능한 증빙 제출.
  • 코드·문서·테스트 PR 리뷰 및 CI 결과 확인. mock/격리 환경만 검증했거나 CI가 범위를 검증하지 못하면 PARTIAL, 미실행 검사를 PASS로 표시하지 않음.
  • 작업과 무관한 변경 및 비밀정보·실제 사용자 개인정보 노출 없음.

테스트 증빙 (개발 후 제출)

  • 실제 실행 명령과 재현 방법, 테스트 로그, 정상 및 예외/거부 사례.
  • Swagger 또는 해당 화면 캡처(비밀정보 마스킹), PR URL, CI 실행 URL, 테스트 커밋 SHA.
  • 영향 범위, 미해결 항목, BLOCKER 기록. 현재 개발·테스트 미수행.

제한·중단 조건

  • 사용자 자료 외부 전송·LLM 제공자 확정 이전에는 fixture/mock로 검증.
  • 승인 없이 공용 Staging DB Schema/DDL/Seed 및 운영 컨테이너·배포 설정 변경 금지. 로컬/격리 테스트 우선.

GitHub 작업지시서 원문

https://github.com/ai-career-platform/ai-career-platform/blob/docs/next-30-work-orders-20261106/docs/work-orders/next-30/T56.md


Add

Subtasks


Add

Related issues

길문 Updated by 길래 문 11 days ago Actions #1

  • Due date set to 12/16/2026
  • Start date set to 12/07/2026

YK Updated by Yeoreum Kim 11 days ago Actions #2

  • Description updated (diff)
  • Assignee set to Yeoreum Kim

YK Updated by Yeoreum Kim 8 days ago Actions #3

  • Status changed from New to In Progress
  • % Done changed from 0 to 90

[T56 진행 기록 — PR 리뷰 대기] (2026-11-09)

  • PR #176: https://github.com/ai-career-platform/ai-career-platform/pull/176
  • 구현: POST /api/v1/knowledge/answers — 내 문서+공용 자료만 근거(SQL 권한 필터 + 인용 재검증), 근거 없으면 답변 안 함, 허위 인용 시 답변 폐기, 문서 속 지시문 미준수, 질문 원문 미저장(sha256), 시간초과 504·장애 503, retrieval_runs·retrieval_citations 기록
  • 테스트: API 38 + PostgreSQL 2 passed, 전체 565 passed / DB Schema·Staging 변경 없음
  • 상태: PARTIAL — 선행 T53(색인)·T54(검색) 미완료, LLM 미승인 → 본문·검색·생성은 교체 가능한 mock

Also available in: PDF Atom