클라이언트 SDK

Vald는 공식 클라이언트 라이브러리(SDK)를 제공해서 쿠버네티스에 띄운 Vald 클러스터를 응용에서 쉽게 호출할 수 있어요. SDK는 밸브 게이트웨이(Gateway)를 통해 인덱스 생성, 벡터 추가, 이웃 검색, 벡터 삭제 같은 주요 연산을 추상화해 줘요.

일반적인 사용 흐름은 이렇게 돼요.

데이터를 벡터로 변환한다. (예: 임베딩 모델)
SDK로 해당 벡터를 Vald 인덱스에 추가(Insert/Update)한다.
질의 벡터로 이웃 검색(Search)을 호출해 가까운 벡터들(Query, SearchByID 등)을 받아온다.

검색 API의 주요 응답은 매칭된 벡터 목록과 각각의 거리(또는 유사도)로 구성돼요. 자동 인덱싱이 기본이라 따로 인덱스를 수동 관리하지 않아도 최근 추가된 벡터가 곧 검색에 반영돼요. 데모 저장소 vdaas/vald-demo에서 샘플 데이터로 동작을 바로 확인할 수 있어요.