feat: expose KB ↔ vector store binding in list, editor, and detail UI
Backend ------- ListKnowledgeBases now enriches each row with the resolved vector_store metadata (name / source / engine_type / status) via a new buildKBListResponse helper. Store views are batch-resolved once per request through BatchResolveStoreView so an N-KB list costs one vector-store service call rather than N — closing the N+1 limitation flagged in #1372's known-limitations section. Cross-tenant shared KBs continue to render via SharedStoreDisplay so the owning tenant's store inventory cannot be correlated across rows; the underlying vector_store_id UUID is stripped from those responses. Resolver failures degrade gracefully: bound KBs render as unavailable instead of breaking the list. Test coverage pins the env / bound / shared distinction, the batch-call-count invariant, and the graceful-failure path. Frontend -------- KB editor modal gains a new "Vector Store" section. Create mode shows a dropdown that combines the system default (env store) and the tenant's configured user stores, fetched once at mount via the existing listVectorStores API. Edit mode shows the bound store read-only via a new VectorStoreBadge component with an explicit immutability hint — matching the backend's `<-:create` GORM tag and the service-layer UpdateKnowledgeBaseRequest DTO that already omit the field. KB list cards surface a small engine-type badge for own-tenant bound KBs, and a warning badge when the bound store is unavailable. Env-bound and shared KBs render no badge (visual noise control). KB detail header shows the bound store via the same VectorStoreBadge component; shared KBs fall through to the badge's internal "shared" branch with no name / engine / id rendered. The KB editor's create-time error handler translates the typed ErrVectorStoreBindingInvalid (2200) and ErrVectorStoreUnavailable (2201) into localized messages and jumps the user back to the VectorStore section so they can pick a different store or fall back to the system default. The KB row type gains five optional fields (vector_store_id / name / engine_type / source / status). i18n: 18 new keys added to en-US, ko-KR, zh-CN; ru-RU receives English placeholders pending translation (consistent with prior PRs in this locale). Part of #993 (Phase 2: Per-KB VectorStore Binding). Phase 2 roadmap item: PR 5 (KB binding UI + list-response enrichment). Depends on #994, #1310, #1372, #1386 (all backend in the Phase 2 series).
This commit is contained in:
@@ -20,6 +20,38 @@ export function listKnowledgeBases(params?: {
|
||||
return get(qs ? `/api/v1/knowledge-bases?${qs}` : '/api/v1/knowledge-bases');
|
||||
}
|
||||
|
||||
// Read-only vector-store binding metadata enriched onto every KB
|
||||
// response (list, create, get, update, pin). Source carries where the
|
||||
// binding points; status reports whether that target is currently
|
||||
// reachable by the server.
|
||||
//
|
||||
// - source 'env' → KB uses the tenant's env-configured store
|
||||
// (RETRIEVE_DRIVER). vector_store_id is null and
|
||||
// vector_store_name is the localized "System
|
||||
// default" label; vector_store_engine_type still
|
||||
// reports the underlying engine (e.g. "postgres").
|
||||
// - source 'user' → KB is bound to a tenant-owned VectorStore.
|
||||
// vector_store_id / name / engine_type are real.
|
||||
// - source 'shared' → KB belongs to a different tenant and is
|
||||
// readable via cross-organization sharing. The
|
||||
// server strips vector_store_id and engine_type
|
||||
// to avoid leaking the owner tenant's store
|
||||
// inventory; only this source marker arrives.
|
||||
// - status 'unavailable' → the binding cannot be reached right now
|
||||
// (deleted row, registry miss, transient infra
|
||||
// failure). Operators recover via the global
|
||||
// Vector Stores settings page.
|
||||
export type VectorStoreSource = 'env' | 'user' | 'shared' | 'unavailable';
|
||||
export type VectorStoreStatus = 'available' | 'unavailable';
|
||||
|
||||
export interface KnowledgeBaseStoreView {
|
||||
vector_store_id?: string | null;
|
||||
vector_store_name?: string;
|
||||
vector_store_engine_type?: string;
|
||||
vector_store_source?: VectorStoreSource;
|
||||
vector_store_status?: VectorStoreStatus;
|
||||
}
|
||||
|
||||
export function createKnowledgeBase(data: {
|
||||
name: string;
|
||||
description?: string;
|
||||
@@ -27,6 +59,11 @@ export function createKnowledgeBase(data: {
|
||||
chunking_config?: any;
|
||||
embedding_model_id?: string;
|
||||
summary_model_id?: string;
|
||||
// Opt-in binding to a specific tenant-owned VectorStore. Omit (or
|
||||
// send undefined / empty string) to fall back to the env-configured
|
||||
// store. Immutable after creation — UpdateKnowledgeBase intentionally
|
||||
// does not accept this field.
|
||||
vector_store_id?: string;
|
||||
vlm_config?: {
|
||||
enabled: boolean;
|
||||
model_id?: string;
|
||||
|
||||
Reference in New Issue
Block a user