엣지(Edge)와 그래프

버킷 엣지는 버킷 내 노드 간의 관계를 나타냅니다(supersedes, references, part_of 등). Schift는 콘텐츠를 적재하면서 이 엣지를 만듭니다. 개별 엣지를 추가·조회·삭제하는 공개 API는 없습니다.

2026-08-24 제거됨. v1 라우트 POST·GET·DELETE /v1/buckets/{bucket_id}/edges 는 여기서 “더 이상 사용되지 않지만 내부 호출자를 위해 유지”라고 안내돼 있었습니다. 실제로는 어느 API 표면에도 등록된 적이 없어 항상 404 였습니다. 부를 수 없는 것을 계속 문서로 두는 대신 라우트를 삭제했습니다.

엣지는 어떻게 만들어지나

엣지는 업로드한 콘텐츠의 구조에서 적재 파이프라인이 파생합니다 — 문서 계층, 상호 참조, 대체 관계 신호. 따로 요청할 것이 없습니다. 관계 타입은 고정이며 사용자 정의 타입은 지원하지 않습니다.

그래프 조회

curl "${API_BASE_URL:-https://api.schift.io}/v1/buckets/550e8400-e29b-41d4-a716-446655440000/graph?query=%EC%96%B4%EB%8A%90%20%EC%A0%95%EC%B1%85%EC%9D%B4%20%EA%B5%AC%20%ED%99%98%EB%B6%88%20%EA%B7%9C%EC%A0%95%EC%9D%84%20%EB%8C%80%EC%B2%B4%ED%95%98%EB%82%98&top_k=10" \
  -H "Authorization: Bearer $SCHIFT_API_KEY"

질의의 시맨틱 검색 결과를 중심으로 한 부분 그래프를 돌려줍니다.

SDK 도 같은 엔드포인트를 노출합니다.

const graph = await client.bucketGraph("my-bucket", "contract terms", 10);

graph = client.buckets.graph("bucket-id", query="contract terms", top_k=10)

사용자 대면 검색에는 v2 버킷 검색을 씁니다

curl -X POST ${API_BASE_URL:-https://api.schift.io}/v2/buckets/550e8400-e29b-41d4-a716-446655440000/search \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "어느 정책이 구 환불 규정을 대체하나요?",
    "top_k": 8,
    "options": {
      "rerank": {"enabled": true}
    }
  }'

함께 보기

• 버킷
• 버킷 검색