Skip to main content
2026-06-29 · Collections API

신규: Collections API

여러 URL을 하나의 통합 TKG(Temporal Knowledge Graph)에 수집해 브랜드별 프라이빗 지식 그래프를 구축하고, 근거 기반 답변과 Q&A 검증 기능을 제공합니다.

사용 흐름

  1. 브랜드 단위로 Collection 생성 (예: 현대자동차 UK)
  2. URL을 **수집(Ingest)**해 각 페이지를 claims/predictions/causal edges로 추출하고 통합 TKG에 누적
  3. 해당 코퍼스만을 근거로 질문에 답변 (/answer)
  4. 기존 Q&A 쌍을 지식 그래프와 비교해 검증 (/qa-verify)

신규 엔드포인트

주요 특징

  • 동기 수집: POST /ingest는 URL별 처리 결과를 claims_count, predictions_count와 함께 반환합니다. URL당 10~30초가 소요됩니다.
  • 통합 TKG: Collection 내 모든 URL이 하나의 지식 그래프에 누적됩니다. 동일 제목의 엔티티는 자동으로 병합됩니다.
  • 시맨틱 검색: /answer/qa-verify는 pgvector를 사용해 질문과 관련된 청크를 먼저 검색한 후 답변을 생성하며, 단순 RAG 대비 정확도가 높습니다.
  • Grounded 플래그: Collection에 충분한 정보가 없으면 환각 방지를 위해 grounded: false를 반환합니다.
  • 테넌트 격리: Collection은 개인 액세스 토큰 단위로 격리됩니다. 마스터 키로는 접근할 수 없습니다.

Q&A 검증 판정값

2026-06-23 · source 파라미터 통일

변경: Evidence Finder, Fact Checker, Fact Search에 통일된 source 파라미터 적용

POST /api/v1/evidence-finder, POST /api/v1/fact-checker, GET /api/v1/fact-search가 동일한 source 파라미터를 사용하도록 통일됐습니다.

source 파라미터

적용 엔드포인트:하위 호환성: fact-search에서 기존에 사용하던 source=newssource=default의 alias로 계속 동작합니다.
2026-06-18 · Ingest API

신규: Ingest API

어떤 콘텐츠 소스에서도 구조화된 지식을 추출하여 개인 Temporal Knowledge Graph에 저장할 수 있는 두 개의 새로운 엔드포인트입니다.

POST /api/v1/ingest

URL 또는 원본 텍스트를 수집합니다. 자동으로 추출하는 항목:
  • Claims: 검증 가능한 사실 진술
  • Predictions: 측정 가능한 결과를 가진 미래 지향적 진술
  • Causal edges: claims와 predictions 간의 관계 (CAUSES, SUPPORTS, CONTRADICTS 등)
  • 벡터 청크: 전체 콘텐츠의 시맨틱 검색 인덱스

POST /api/v1/ingest/file

PDF, Markdown, 또는 TXT 파일을 직접 업로드하여 수집합니다.

GET /api/v1/fact-search?source=ingest

개인 수집 지식 그래프를 검색합니다. 쿼리와 일치하는 청크, claim, prediction을 반환합니다. 개인 액세스 토큰이 필요하며 본인의 콘텐츠만 반환됩니다.
2026-06-08 · 버그 수정 및 개선

버그 수정 및 개선

이번 릴리스에는 API 전반에 걸친 소규모 버그 수정 및 내부 개선 사항이 포함되어 있습니다.
2026-06-05 · Fact Search 이름 변경

Fact Search 이름 변경

API 범위를 더 명확하게 표현하기 위해 News Search 엔드포인트를 Fact Search로 변경했습니다.

Changed

  • GET /api/v1/news/searchGET /api/v1/fact-search로 이름 변경
마이그레이션: 기존에 /api/v1/news/search를 직접 사용하고 있다면 /api/v1/fact-search로 업데이트하세요. 쿼리 파라미터와 응답 스키마는 동일합니다.