문서

집계

메타데이터 필드별로 벡터를 그룹화하고 카운트하여 분석 및 패슯 탐색을 수행합니다.

bashPOST /v1/aggregate

컨렉션의 벡터를 메타데이터 키로 그룹화하고 그룹별 카운트를 반환합니다. 패슯 내비게이션, 분석 대시보드, 데이터 품질 확인에 유용합니다.

파라미터타입필수설명
collectionstring예컨렉션 이름
group_bystring예그룹화할 메타데이터 키
filter_keystring아니오그룹화 전 필터링할 키
filter_valuestring아니오필터 키의 값
bash# 카테고리별 문서 수
curl -X POST https://api.schift.io/v1/aggregate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -d '{
    "collection": "product-docs",
    "group_by": "category"
  }'

# 필터링된 하위 집합 내 그룹화
curl -X POST https://api.schift.io/v1/aggregate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -d '{
    "collection": "product-docs",
    "group_by": "author",
    "filter_key": "category",
    "filter_value": "engineering"
  }'

응답: { "groups": [{"value": "engineering", "count": 42}, ...], "total": 156 }

백엔드 지원

Aggregate는 Schift 엔진과 FAISS 백엔드에서 지원됩니다. 다른 백엔드는 501을 반환합니다.