❓ Frequently Asked Questions

# Supported Python versions:
 
# - Python 3.12
 
# Check your version
import sys
print(sys.version)

from agentvectordb.embeddings import BaseEmbeddingFunction
import numpy as np
 
class CustomEmbedder(BaseEmbeddingFunction):
    def __init__(self, dimension: int = 384):
        super().__init__(dimension=dimension)
    
    def embed(self, texts: List[str]) -> np.ndarray:
        # Your embedding logic here
        return np.random.rand(len(texts), self.dimension)
 
# Usage
embedder = CustomEmbedder(dimension=384)
collection = store.get_or_create_collection(
    name="memories",
    embedding_function=embedder
)

from agentvectordb import AsyncAgentVectorDBStore
import asyncio
 
async def safe_concurrent_ops():
    store = AsyncAgentVectorDBStore(db_path="./agent_db")
    collection = await store.get_or_create_collection("shared_memories")
    
    # Concurrent operations
    tasks = [
        collection.add(content=f"Memory {i}", type="test")
        for i in range(10)
    ]
    await asyncio.gather(*tasks)

# Recommended batch sizes
BATCH_SIZES = {
    "realtime": 50,     # For real-time applications
    "standard": 500,    # For normal operations
    "bulk": 2000        # For data migration
}
 
def batch_processor(collection, items, batch_size=BATCH_SIZES["standard"]):
    """Process items in optimal batch sizes."""
    for i in range(0, len(items), batch_size):
        batch = items[i:i + batch_size]
        try:
            collection.add_batch(batch)
        except Exception as e:
            print(f"Batch {i}-{i+batch_size} failed: {e}")

# Efficient querying
results = collection.query(
    query_text="important memory",
    k=5,
    filter_sql="type = 'critical' AND importance_score > 0.8",
    include_vectors=False  # Set to True only if needed
)

from agentvectordb.exceptions import (
    AgentVectorDBException,  # Base exception
    InitializationError,     # Database setup issues
    SchemaError,            # Schema validation failures
    QueryError,             # Search/query issues
    OperationError         # General operations
)
 
def safe_operation(func):
    """Decorator for safe memory operations."""
    def wrapper(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except SchemaError as e:
            print(f"Schema validation failed: {e}")
        except QueryError as e:
            print(f"Query failed: {e}")
        except Exception as e:
            print(f"Unexpected error: {e}")
        return None
    return wrapper

# Clone repository
git clone https://github.com/superagenticai/agentvectordb.git
cd agentvectordb
 
# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
 
# Install dependencies
pip install -e ".[dev]"
 
# Install pre-commit hooks
pre-commit install

# Run all tests
pytest
 
# Run with coverage
pytest --cov=agentvectordb

@software{agentvectordb2024,
  title = {AgentVectorDB: The Cognitive Core for AI Agents},
  author = {Jagtap, Shashi and {Superagentic AI}},
  year = {2024},
  url = {https://github.com/superagenticai/agentvectordb}
}