Spaces:
Build error
Build error
File size: 6,442 Bytes
7640b67 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 | # ๐ Deep Dive: End-to-End Testing
## ๐ง Why E2E Testing for RAG?
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ RAG PIPELINE COMPONENTS โ
โ โ
โ Each component can work individually but may fail together: โ
โ โ
โ [Loader] โ [Chunker] โ [Embeddings] โ [VectorStore] โ
โ โ โ
โ [Retriever] โ [LLM] โ [Answer] โ
โ โ
โ E2E tests verify the ENTIRE chain works together โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## ๐ Test Script Architecture
```
scripts/
โโโ test_e2e.py # Comprehensive test suite
โโโ demo.py # Interactive demo
```
---
## ๐ฏ test_e2e.py - Comprehensive Test Suite
### Test Flow:
```python
1. test_document_loading() # Load sample documents
โ
2. test_chunking() # Split into chunks
โ
3. test_embeddings() # Initialize embedding model
โ
4. test_vector_store() # Store chunks with embeddings
โ
5. test_retrieval() # Search for relevant docs
โ
6. test_llm() # Test LLM generation
โ
7. test_rag_pipeline() # Full RAG query
โ
8. cleanup_test_collection() # Remove test data
```
### Key Test Methods:
#### `test_document_loading()`
```python
loader = MultiFormatDocumentLoader()
documents = loader.load_directory(sample_dir)
# Verifies: Files are read, metadata is extracted
```
#### `test_chunking()`
```python
chunker = DocumentChunker(chunk_size=500, chunk_overlap=50)
chunks = chunker.chunk_documents(documents)
# Verifies: Documents are split, stats are correct
```
#### `test_embeddings()`
```python
manager = EmbeddingsManager()
vector = manager.embed_text("What is RAG?")
# Verifies: Model loads, produces 384-dim vectors
```
#### `test_vector_store()`
```python
store = create_vector_store(embeddings, collection_name="test_collection")
ids = store.add_documents(chunks)
# Verifies: Chunks are stored, IDs are returned
```
#### `test_retrieval()`
```python
retriever = Retriever(vector_store=store, default_k=3)
result = retriever.retrieve("What is RAG?")
# Verifies: Relevant docs are returned with scores
```
#### `test_llm()`
```python
manager = LLMManager()
response = manager.generate("Say hello")
# Verifies: API key works, model responds
```
#### `test_rag_pipeline()`
```python
pipeline = create_rag_pipeline(collection_name="test_collection")
result = pipeline.query("What is RAG?", include_sources=True)
# Verifies: Full pipeline works, sources included
```
---
## ๐ฎ demo.py - Interactive Demo
### Usage:
```bash
python scripts/demo.py
```
### Flow:
```
1. Load documents from data/sample_docs/
2. Chunk documents
3. Index in vector store
4. Start interactive Q&A loop
5. User asks questions
6. Pipeline retrieves + generates
7. Display answer with sources
```
### Interactive Loop:
```python
while True:
question = input("Your question: ")
result = pipeline.query(question, include_sources=True)
print(f"Answer: {result['answer']}")
print(f"Sources: {result['sources']}")
```
---
## ๐ง Running the Tests
### Full Test Suite:
```bash
# Activate virtual environment
venv\Scripts\activate
# Run E2E tests
python scripts/test_e2e.py
```
### Interactive Demo:
```bash
# Activate virtual environment
venv\Scripts\activate
# Run demo
python scripts/demo.py
```
---
## โ
Expected Output
```
============================================================
๐ RAG Pipeline End-to-End Test Suite
============================================================
============================================================
1. Testing Document Loading
============================================================
โ
Loaded 1 document(s)
- sample.txt: 1024 chars
============================================================
2. Testing Document Chunking
============================================================
โ
Created 3 chunks
- Average chunk size: 341 chars
============================================================
3. Testing Embeddings
============================================================
โ
Embedding model loaded: sentence-transformers/all-MiniLM-L6-v2
- Vector dimensions: 384
============================================================
4. Testing Vector Store
============================================================
โ
Added 3 chunks to vector store
- Collection: test_collection
- Document count: 3
============================================================
5. Testing Retrieval
============================================================
๐ Query: 'What is RAG?'
Retrieved 3 documents
Top score: 0.8542
============================================================
6. Testing LLM
============================================================
โ
LLM configured: gemini-2.5-flash
- Test response: Hello, RAG!
============================================================
7. Testing Complete RAG Pipeline
============================================================
โ
RAG Pipeline created
๐ Testing query: 'What is RAG and what are its benefits?'
๐ฌ Answer: Based on the documentation, RAG is a technique...
============================================================
8. Cleanup
============================================================
โ
Test collection cleaned up
============================================================
Test Summary
============================================================
โ
All tests passed!
๐ Phase 1 Complete: Core RAG Pipeline is working!
```
---
## ๐ Summary
| Script | Purpose | When to Use |
|--------|---------|-------------|
| `test_e2e.py` | Verify all components | After code changes |
| `demo.py` | Interactive testing | Demo to users |
|