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

> chat API 추가, TKG 그래프 편집, 검색 품질 수정

<Update label="2026-07-16" description="v0.1.17: chat, TKG 그래프 편집, 버그 수정">
  ## 추가: `POST /api/v1/chat`

  스트리밍(SSE) 방식의 신규 채팅 엔드포인트입니다.

  * `collection_id`를 지정하면 해당 collection 지식(시맨틱 청크 검색 + 지식그래프 폴백)에 기반해 답변합니다. 세션과 대화 이력이 저장됩니다.
  * `tkg_id`를 지정하면 collection이 아닌 독립된 knowledge graph에 기반해 답변합니다.
  * 둘 다 생략하면 그라운딩 없는 1회성 채팅으로 동작하며 세션은 저장되지 않습니다.
  * `model` 파라미터로 `gpt-5-nano`, `gpt-5-mini`, `gpt-5` 중 선택할 수 있습니다.
  * `use_fact_search` / `use_evidence_finder` / `use_fact_checker`를 켜면 모델이 대화 중 해당 리서치 도구를 자율적으로 호출할 수 있습니다. 각 도구 호출은 실제로 호출될 때만, 해당 단독 엔드포인트와 동일한 크레딧으로 개별 과금됩니다.
  * 이 엔드포인트의 요청 자체는 가격 정책이 확정되기 전까지 현재 무료입니다.

  ## 추가: TKG 그래프 편집 엔드포인트

  `POST/PATCH/DELETE /api/v1/tkgs/{tkgId}/graph/nodes`와 `POST/DELETE /api/v1/tkgs/{tkgId}/graph/edges`를 통해 collection에 속하지 않은 knowledge graph의 노드/엣지를 직접 생성, 수정, 삭제할 수 있습니다 — collection에서 이미 제공하던 그래프 편집 기능을 collection 없이도 사용할 수 있게 되었습니다. 이 엔드포인트들은 무료입니다.

  `PATCH /api/v1/tkgs/{tkgId}/graph/nodes/{nodeId}/annotation` 엔드포인트가 새로 추가되어, belief 노드에 시간 정보(`when` + `precision`: year/quarter/month/day)를 주석으로 붙일 수 있습니다.

  ## 수정: qa-verify 엔티티 매칭

  `POST /api/v1/collections/{id}/qa-verify`가 같은 collection 내 여러 엔티티에 공통으로 들어가는 브랜드/제품군 토큰만으로 과하게 매칭되던 문제를 수정했습니다(예: 같은 브랜드명을 공유한다는 이유만으로 거의 모든 엔티티가 매칭되던 현상). 매칭 정확도가 개선되었습니다.

  ## 수정: 엔티티 연결 fact 개수 제한

  엔티티를 해석할 때 고려하는 연결된 fact 개수의 내부 상한을 20개에서 50개로 올렸습니다. 이전에는 실제로 연결된 fact 중 일부가 relevance 정렬 전에 잘려나가, 더 나은 근거가 있음에도 verdict가 `unsupported`로 표시될 수 있었습니다.
</Update>
