Update rag_engine.py

rag_engine.py

@@ -471,13 +471,16 @@ def cached_process_query(query, top_k=5, word_limit=100):
         dict: Dictionary containing the query, answer, and citations
     """
     print(f"\n🔍 Processing query (cached): {query}")
+    # Load all necessary data resources (with caching)
     faiss_index, text_chunks, metadata_dict = cached_load_data_files()
+    # Handle missing data gracefully
     if faiss_index is None or text_chunks is None or metadata_dict is None:
         return {
             "query": query, 
             "answer_with_rag": "⚠️ System error: Data files not loaded properly.", 
             "citations": "No citations available."
         }
+    # Step 1: Retrieve relevant passages using similarity search    
     retrieved_context, retrieved_sources = retrieve_passages(
         query, 
         faiss_index, 
@@ -485,12 +488,15 @@ def cached_process_query(query, top_k=5, word_limit=100):
         metadata_dict,
         top_k=top_k
     )
+    # Step 2: Format citations for display
     sources = format_citations(retrieved_sources) if retrieved_sources else "No citation available."
+    # Step 3: Generate the answer if relevant context was found
     if retrieved_context:
         context_with_sources = list(zip(retrieved_sources, retrieved_context))
         llm_answer_with_rag = answer_with_llm(query, context_with_sources, word_limit=word_limit)
     else:
         llm_answer_with_rag = "⚠️ No relevant context found."
+    # Return the complete response package
     return {"query": query, "answer_with_rag": llm_answer_with_rag, "citations": sources}
 
 def process_query(query, top_k=5, word_limit=100):