> ## 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.

# v0.1.6

> Collections API — 브랜드별 프라이빗 지식 그래프 및 근거 기반 Q&A

<Update label="2026-06-29" description="v0.1.6 — 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 비동기 수집 (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에 검증에 충분한 정보가 없음                   |
</Update>