> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factagora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026-06

> 2026-06 Factagora API 릴리스 (v0.1.2 – v0.1.6)

<Update label="v0.1.6" description="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`)

  ### 신규 엔드포인트

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

  ### Q\&A 검증 판정값

  | 판정            | 의미                                           |
  | ------------- | -------------------------------------------- |
  | `correct`     | 지식 그래프가 답변을 지지함                              |
  | `incorrect`   | 답변이 지식 그래프와 모순되며, `correction` 필드에 올바른 답변 제공 |
  | `unsupported` | Collection에 검증에 충분한 정보가 없음                   |
</Update>

<Update label="v0.1.5" description="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` 파라미터

  | 값         | 동작                                               |
  | --------- | ------------------------------------------------ |
  | `default` | 공개 뉴스 소스만 검색합니다. 기본값이며 기존 동작과 동일합니다.             |
  | `ingest`  | 개인 수집 지식 베이스만 검색합니다. 개인 액세스 토큰이 필요합니다.           |
  | `all`     | 뉴스 + 개인 수집 지식 베이스를 합산하여 검색합니다. 개인 액세스 토큰이 필요합니다. |

  **적용 엔드포인트:**

  | 엔드포인트                          | 파라미터     | 기본값       |
  | ------------------------------ | -------- | --------- |
  | `GET /api/v1/fact-search`      | `source` | `default` |
  | `POST /api/v1/evidence-finder` | `source` | `default` |
  | `POST /api/v1/fact-checker`    | `source` | `default` |

  **하위 호환성:** `fact-search`에서 기존에 사용하던 `source=news`는 `source=default`의 alias로 계속 동작합니다.
</Update>

<Update label="v0.1.4" description="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을 반환합니다. 개인 액세스 토큰이 필요하며 본인의 콘텐츠만 반환됩니다.
</Update>

<Update label="v0.1.3" description="2026-06-08 · 버그 수정 및 개선">
  ## 버그 수정 및 개선

  이번 릴리스에는 API 전반에 걸친 소규모 버그 수정 및 내부 개선 사항이 포함되어 있습니다.
</Update>

<Update label="v0.1.2" description="2026-06-05 · Fact Search 이름 변경">
  ## Fact Search 이름 변경

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

  ### Changed

  * `GET /api/v1/news/search` → `GET /api/v1/fact-search`로 이름 변경

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