Update app.py

app.py

@@ -336,7 +336,7 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                     avatar_images = (None,"data-collection.png"),
                 )
 
-                # feedback UI
+                #---------------- FEEDBACK ----------------------
                 with gr.Column(elem_id="feedback-container"):
                     with gr.Row(visible=False) as feedback_row:
                         gr.Markdown("Was this response helpful?")
@@ -345,10 +345,25 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                             not_okay_btn = gr.Button("👎 Not to expectations", elem_classes="feedback-button")
                     feedback_thanks = gr.Markdown("Thanks for the feedback!", visible=False)
                     feedback_state = gr.State()
-                
-
 
+                #---------------- WARNINGS ----------------------
+                # No filters selected warning
+                with gr.Row(visible=False, elem_id="warning-row", elem_classes="warning-message") as warning_row:
+                    with gr.Column():
+                        gr.Markdown("<span class='warning-icon'>⚠️</span> **No report filter selected. Are you sure you want to proceed?**")
+                        with gr.Row(elem_classes="warning-buttons"):
+                            proceed_btn = gr.Button("Proceed", elem_classes="proceed")
+                            cancel_btn = gr.Button("Cancel", elem_classes="cancel")
+
+                # Short query warning (< 4 words)
+                with gr.Row(visible=False, elem_id="warning-row", elem_classes="warning-message") as short_query_warning_row:
+                    with gr.Column():
+                        gr.Markdown("<span class='warning-icon'>⚠️</span> **Your query is too short. Please lengthen your query to ensure the app has adequate context.**")
+                        with gr.Row(elem_classes="warning-buttons"):
+                            short_query_proceed_btn = gr.Button("OK", elem_classes="proceed")
+                
 
+                #---------------- QUERY INPUT ----------------------
                 with gr.Row(elem_id = "input-message"):
                     textbox=gr.Textbox(placeholder="Ask me anything here!",show_label=False,scale=7,
                                        lines = 1,interactive = True,elem_id="input-textbox")
@@ -383,23 +398,7 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                                 value=default_report_value,
                                 interactive=True,
                             )
-                        
-                        #----- First level filter for selecting Report source/category ----------
 
-                        #with gr.Group(visible=True) as report_name_section:
-                        #    # Get default report value from config if present
-                        #    default_report = model_config.get('app', 'dropdown_default', fallback=None)
-                        #    # Check if it actually exists in the master list
-                        #    default_report_value = [default_report] if default_report in new_report_list else None
-                        #    
-                        #    dropdown_reports = gr.Dropdown(
-                        #        new_report_list,
-                        #        label="Select one or more reports (scroll or type to search)",
-                        #        multiselect=True,
-                        #        value=default_report_value,
-                        #        interactive=True,
-                        #    )
-                        
                         #---------------- SELECT BY FILTERS SECTION ------------
                         with gr.Group(visible=False) as filters_section:
                             #----- First level filter for selecting Report source/category ----------
@@ -416,29 +415,16 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                                 value=None,
                                 label = "Filter for Sub-Type",
                                 interactive=True)
-                            
-                        #dropdown_sources = gr.Dropdown(
-                        #    ["Consolidated","Ministry, Department and Agency","Project","Hospital","Local Government","Value for Money","Thematic"],
-                        #    label="Select Report Category",
-                        #    value="Consolidated",
-                        #    interactive=True,
-                        #)
-
-                        #------ second level filter for selecting subtype within the report category selected above
-                        #dropdown_category = gr.Dropdown(
-                        #    new_files["Consolidated"],
-                        #    multiselect = True,                        
-                        #    value = new_files["Consolidated"][0],
-                        #    label = "Filter for Sub-reports",
-                        #    interactive=True)
-
-                        #----------- update the secodn level filter abse don values from first level ----------------
-                        def rs_change(rs):
-                            return gr.update(choices=new_files[rs], value=new_files[rs])
-                        dropdown_sources.change(fn=rs_change, inputs=[dropdown_sources], outputs=[dropdown_category])
 
+                            #----------- update the secodn level filter abse don values from first level ----------------
+                            def rs_change(rs):
+                                if rs:  # Only update choices if a value is selected
+                                    return gr.update(choices=new_files[rs], value=None)  # Set value to None (no preselection)
+                                else:
+                                    return gr.update(choices=[], value=None)  # Empty choices if nothing selected
+                            dropdown_sources.change(fn=rs_change, inputs=[dropdown_sources], outputs=[dropdown_category])
 
-                        # Toggle visibility based on search method
+                         # Toggle visibility based on search method
                         def toggle_search_method(method):
                             """Note - this function removes the default value from report search when toggled"""
                             if method == "Search by Report Name":
@@ -461,7 +447,7 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                                     gr.update(),              # dropdown_year
                                     gr.update(value=[])       # dropdown_reports
                                 )
-                        
+
                         # Pass to the event handler
                         search_method.change(
                             fn=toggle_search_method,
@@ -474,6 +460,37 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
                                 dropdown_reports
                             ]
                         )
+                        #----- First level filter for selecting Report source/category ----------
+
+                        #with gr.Group(visible=True) as report_name_section:
+                        #    # Get default report value from config if present
+                        #    default_report = model_config.get('app', 'dropdown_default', fallback=None)
+                        #    # Check if it actually exists in the master list
+                        #    default_report_value = [default_report] if default_report in new_report_list else None
+                        #    
+                        #    dropdown_reports = gr.Dropdown(
+                        #        new_report_list,
+                        #        label="Select one or more reports (scroll or type to search)",
+                        #        multiselect=True,
+                        #        value=default_report_value,
+                        #        interactive=True,
+                        #    )
+                        
+                        #dropdown_sources = gr.Dropdown(
+                        #    ["Consolidated","Ministry, Department and Agency","Project","Hospital","Local Government","Value for Money","Thematic"],
+                        #    label="Select Report Category",
+                        #    value="Consolidated",
+                        #    interactive=True,
+                        #)
+
+                        #------ second level filter for selecting subtype within the report category selected above
+                        #dropdown_category = gr.Dropdown(
+                        #    new_files["Consolidated"],
+                        #    multiselect = True,                        
+                        #    value = new_files["Consolidated"][0],
+                        #    label = "Filter for Sub-reports",
+                        #    interactive=True)
+                        
 
                         #--------- Select the years for reports -------------------------------------
                         #dropdown_year = gr.Dropdown(
@@ -536,25 +553,29 @@ with gr.Blocks(title="Audit Q&A", css= "style.css", theme=theme,elem_id = "main-
 
     dropdown_samples.change(change_sample_questions,dropdown_samples,samples)
 
-            # ---- New Guidelines Tab ----
+
+    # ---- New Guidelines Tab ----
     with gr.Tab("Guidelines", elem_classes="max-height other-tabs"):
         gr.Markdown("""
-        Welcome to Audit Q&A, your AI-powered assistant for exploring and understanding Uganda's audit reports. This tool leverages advanced language models to help you get clear and structured answers based on audit publications. To get you started, here a few tips on how to use the tool:
-        ### Crafting Effective Prompts
+        #### Welcome to Audit Q&A, your AI-powered assistant for exploring and understanding Uganda's audit reports. This tool leverages advanced language models to help you get clear and structured answers based on audit publications. To get you started, here a few tips on how to use the tool:
+        ## 💬 Crafting Effective Prompts
+        Clear, specific questions will give you the best results. Here are some examples:
+        | ❌ Less Effective | ✅ More Effective |
+        |------------------|-------------------|
+        | "What are the findings?" | "What were the main issues identified in procurement practices in the Ministry of Health in 2022?" |
+        | "Tell me about revenue collection" | "What specific challenges were identified in revenue collection at the local government level in 2021-2022?" |
+        | "Is there corruption?" | "What audit findings related to misappropriation of funds were reported in the education sector between 2020-2023?" |
+        ## ⭐ Best Practices
         - **Be Clear and Specific**: Frame your questions clearly and focus on what you want to learn.
         - **One Topic at a Time**: Break complex queries into simpler, focused questions.
-        - **Be Direct**: Instead of "What are the findings?", try "What were the main issues identified in procurement practices?" or "What challenges were found in revenue collection?"
+        - **Provide Context**: Mentioning specific ministries, years, or projects helps narrow the focus.
+        - **Follow Up**: Ask follow-up questions to explore a topic more deeply.
         
-        ### Best Practices
-        - Start with a simple, focused question.
-        - Follow up with additional questions if your initial query doesn't yield the desired results.
-        - Experiment with different phrasings to get the most accurate answers.
-        - Use the source citations as a reference to validate the provided information.
-        ### Utilizing Filters
+        ## 🔍 Utilizing Filters
         - **Report Category & Subtype**: Use the "Reports" tab to choose your preferred report category and refine your query by selecting a specific sub-type. This will help narrow down the context for your question.
         - **Year Selection**: Choose one or more years from the "Year" filter to target your query to specific time periods.
         - **Specific Reports**: Optionally, select specific reports using the dropdown to focus on a particular document or set of documents.
-        ### Useful Resources
+        ## 📚 Useful Resources
                             
         - <ins>[**Short Course: Generative AI for Everyone** (3 hours)](https://www.deeplearning.ai/courses/generative-ai-for-everyone/)</ins>
         - <ins>[**Short Course: Advanced Prompting** (1 hour)](https://www.deeplearning.ai/courses/ai-for-everyone/)</ins>