Update src/vector_store.py

This commit is contained in:
2026-06-05 11:29:32 +00:00
parent 686525b3de
commit d3b002627c
+37 -107
View File
@@ -1,125 +1,55 @@
"""Vector store and knowledge base implementation using Qdrant and Ollama embeddings.
This module defines a `KnowledgeBase` class that manages a Qdrant collection, provides methods to add documents (with chunking) and perform semantic search.
"""
from __future__ import annotations
import os
from pathlib import Path from pathlib import Path
from typing import List, Dict, Any from uuid import uuid4
from langchain_ollama import OllamaEmbeddings from langchain_ollama import OllamaEmbeddings
from langchain_qdrant import QdrantVectorStore from langchain_qdrant import QdrantVectorStore
from langchain_core.documents import Document
from langchain_text_splitters import RecursiveCharacterTextSplitter
from qdrant_client import QdrantClient from qdrant_client import QdrantClient
from qdrant_client.http.models import Distance, VectorParams from qdrant_client.http.models import Distance, VectorParams
from langchain_text_splitters import RecursiveCharacterTextSplitter
# Default configuration constants from langchain_core.documents import Document
DEFAULT_COLLECTION_NAME = "knowledge_base"
DEFAULT_VECTOR_SIZE = 3072 # size of nomic-embed-text embeddings
DEFAULT_DISTANCE = Distance.COSINE
DEFAULT_QDRANT_PATH = Path("./qdrant_data")
class KnowledgeBase: class KnowledgeBase:
"""A thin wrapper around QdrantVectorStore. """A simple wrapper around Qdrant for storing and searching documents."""
def __init__(self, collection_name: str = "rag_kb", persist_path: str = "qdrant_data"):
The class ensures that the collection is created only once and provides # Initialize Qdrant client (inmemory or ondisk)
convenient methods for adding documents and performing semantic search. self.client = QdrantClient(path=persist_path)
""" # Create collection with cosine distance and 3072dim vectors (nomicembedtext output)
self.client.create_collection(
def __init__( collection_name=collection_name,
self, vectors_config=VectorParams(size=3072, distance=Distance.COSINE),
collection_name: str = DEFAULT_COLLECTION_NAME, )
host: str | None = None, # Create vector store wrapper
port: int | None = None, self.vector_store = QdrantVectorStore(
path: str | None = None,
api_key: str | None = None,
) -> None:
"""Create or connect to a Qdrant collection.
Parameters
----------
collection_name: str
Name of the Qdrant collection.
host, port: str/int
Optional host and port for a remote Qdrant instance.
path: str
Path for an ondisk Qdrant instance (used in local mode).
api_key: str
API key for Qdrant Cloud.
"""
# Determine client connection.
if host and port:
self.client = QdrantClient(url=f"{host}:{port}")
elif path:
self.client = QdrantClient(path=path)
else:
# Default to a persistent ondisk client.
self.client = QdrantClient(path=str(DEFAULT_QDRANT_PATH))
self.collection_name = collection_name
# Create collection if it does not exist.
if collection_name not in self.client.get_collections().collections:
self.client.create_collection(
collection_name=collection_name,
vectors_config=VectorParams(size=DEFAULT_VECTOR_SIZE, distance=DEFAULT_DISTANCE),
)
# Embedding model from Ollama.
self.embeddings = OllamaEmbeddings(model="nomic-embed-text")
# Vector store wrapper.
self.store = QdrantVectorStore(
client=self.client, client=self.client,
collection_name=collection_name, collection_name=collection_name,
embedding=self.embeddings, embedding=OllamaEmbeddings(model="nomic-embed-text"),
) )
# Text splitter for chunking documents
self.splitter = RecursiveCharacterTextSplitter(chunk_size=1000, chunk_overlap=200)
# Text splitter for chunking. def add_document(self, title: str, content: str):
self.splitter = RecursiveCharacterTextSplitter(
chunk_size=500, chunk_overlap=50, length_function=len
)
# ---------------------------------------------------------------------
# Public API
# ---------------------------------------------------------------------
def add_document(self, title: str, content: str) -> None:
"""Add a document to the knowledge base. """Add a document to the knowledge base.
The content is split into chunks, embedded, and stored. The content is split into chunks, each chunk is embedded and stored.
""" """
# Split into Document objects with metadata. # Create Document objects with metadata
docs = self.splitter.create_documents([content]) docs = self.splitter.create_documents([content], metadata={"title": title})
for i, doc in enumerate(docs): # Add to vector store
# Attach metadata: title and chunk index. self.vector_store.add_documents(docs)
doc.metadata.update({"title": title, "chunk_index": i})
# Add to store.
self.store.add_documents(docs)
def search(self, query: str, limit: int = 5) -> List[Dict[str, Any]]: def search(self, query: str, limit: int = 10):
"""Perform a semantic search and return results. """Search the knowledge base for the most relevant documents.
Returns a list of dictionaries containing the chunk content and metadata. Returns a list of dictionaries containing page_content, metadata and score.
""" """
results = self.store.similarity_search(query, k=limit) results = self.vector_store.similarity_search_with_score(query, k=limit)
output = [] return [
for doc in results: {
output.append( "page_content": doc.page_content,
{ "metadata": doc.metadata,
"content": doc.page_content, "score": score,
"title": doc.metadata.get("title"), }
"chunk_index": doc.metadata.get("chunk_index"), for doc, score in results
} ]
)
return output
def get_all_documents(self) -> List[Document]: # Global singleton instance used by tools and the agent
"""Return all documents stored in the collection.""" kb = KnowledgeBase()
return self.store.get_all_documents()
# End of src/vector_store.py