신규: Collections API
여러 URL을 하나의 통합 TKG(Temporal Knowledge Graph)에 수집해 브랜드별 프라이빗 지식 그래프를 구축하고, 근거 기반 답변과 Q&A 검증 기능을 제공합니다.사용 흐름
- 브랜드 단위로 Collection 생성 (예: 현대자동차 UK)
- URL 수집(Ingest) — 각 페이지를 claims/predictions/causal edges로 추출해 통합 TKG에 누적
- 해당 코퍼스만을 근거로 질문에 답변 (
/answer) - 기존 Q&A 쌍을 지식 그래프와 비교해 검증 (
/qa-verify)
신규 엔드포인트
| Method | Path | 설명 |
|---|---|---|
POST | /api/v1/collections | Collection 생성 |
GET | /api/v1/collections | 내 Collection 목록 조회 |
GET | /api/v1/collections/{id} | Collection 상세 + 수집된 URL 목록 |
DELETE | /api/v1/collections/{id} | Collection 및 모든 데이터 삭제 |
POST | /api/v1/collections/{id}/ingest | URL 비동기 수집 (202 즉시 응답) |
GET | /api/v1/collections/{id}/ingest-status | 수집 진행 상황 폴링 |
GET | /api/v1/collections/{id}/graph | 통합 지식 그래프 조회 |
POST | /api/v1/collections/{id}/answer | Collection 기반 근거 답변 |
POST | /api/v1/collections/{id}/qa-verify | 기존 Q&A 검증 |
주요 특징
- 비동기 수집 —
POST /ingest는202를 즉시 반환합니다./ingest-status로processing→completed/failed상태를 폴링하세요. - 통합 TKG — Collection 내 모든 URL이 하나의 지식 그래프에 누적됩니다. 동일 제목의 엔티티는 자동으로 병합됩니다.
- 시맨틱 검색 —
/answer와/qa-verify는 pgvector를 사용해 질문과 관련된 청크를 먼저 검색한 후 답변을 생성합니다. - Grounded 플래그 — Collection에 충분한 정보가 없으면 환각 방지를 위해
grounded: false를 반환합니다. - 테넌트 격리 — Collection은 개인 액세스 토큰 단위로 격리됩니다. 마스터 키로는 접근할 수 없습니다.
Q&A 검증 판정값
| 판정 | 의미 |
|---|---|
correct | 지식 그래프가 답변을 지지함 |
incorrect | 답변이 지식 그래프와 모순됨 — correction 필드에 올바른 답변 제공 |
unsupported | Collection에 검증에 충분한 정보가 없음 |