VectorSearchService gRPC API
VectorSearchService provides nearest-neighbor search over dense vector indexes. Backed by a FAISS provider plugin (ADR-016).
Proto file: plugin/grpc/protocol/vectorsearch.proto
Service Methods
| Method | Request | Response | Streaming |
|---|
| Search | VectorSearchRequest | VectorSearchResponse | No |
| AddVectors | AddVectorsRequest | AddVectorsResponse | No |
| CreateIndex | CreateIndexRequest | CreateIndexResponse | No |
Search
Search finds the nearest neighbors to a query vector in a named index.
- Request:
VectorSearchRequest
- Response:
VectorSearchResponse
AddVectors
AddVectors inserts vectors into a named index.
- Request:
AddVectorsRequest
- Response:
AddVectorsResponse
CreateIndex
CreateIndex creates a new named vector index.
- Request:
CreateIndexRequest
- Response:
CreateIndexResponse
Message Types
VectorSearchRequest
| Field | Type | Description |
|---|
| auth_token | string | - |
| index | string | - |
| query_vector | float | - |
| top_k | int32 | - |
VectorSearchResponse
| Field | Type | Description |
|---|
| results | VectorSearchHit | - |
VectorSearchHit
| Field | Type | Description |
|---|
| id | string | - |
| distance | float | - |
AddVectorsRequest
| Field | Type | Description |
|---|
| auth_token | string | - |
| index | string | - |
| vectors | VectorEntry | - |
VectorEntry
| Field | Type | Description |
|---|
| id | string | - |
| vector | float | - |
AddVectorsResponse
| Field | Type | Description |
|---|
| added | int32 | - |
CreateIndexRequest
| Field | Type | Description |
|---|
| auth_token | string | - |
| name | string | - |
| dimensions | int32 | - |
CreateIndexResponse
| Field | Type | Description |
|---|
| name | string | - |
← Back to API Index