update tool descrition to not overlaping

prepare_env.py

@@ -225,98 +225,100 @@ def create_section_tools(embedding_function, llm):
         guide_retriever = create_retriever(guide_vstore, guide_docs, llm)
     else:
         guide_retriever = None
+        # Primary + Secondary Document Paths
+    immunization_path = './data/Immunization in Practice_WHO_eng_2015.json'
+
+    # WHO Immunization in Practice Tool
+    if os.path.exists(immunization_path):
+        immunization_vstore, immunization_docs = create_vectorstore_from_json(
+            immunization_path,
+            "Immunization_in_Practice_WHO_eng_2015",
+            embedding_function
+        )
+        immunization_retriever = create_retriever(immunization_vstore, immunization_docs, llm)
+    else:
+        immunization_retriever = None
+
     # General-purpose tool (entire Algerian guide)
     def guide_retrieval_tool(query: str) -> str:
         """
         General-purpose retrieval tool for the entire Algerian National Vaccination Guide (2023).
 
-        Use this tool when a query spans multiple sections or cannot be routed confidently to a specific tool.
-        This is the fallback and all-encompassing tool to retrieve any vaccination-related information 
-        from the national guide.
+        Use ONLY when a query spans multiple unrelated sections or cannot be confidently routed
+        to a more specific tool. This tool provides a fallback when the intent is ambiguous
+        or multi-topic (e.g., combining schedule, cold chain, and public outreach in one query).
 
-        Secondary source: The WHO Immunization Guide can be queried separately via `Immunization_in_Practice_tool`.
+        Do NOT use this tool for clearly scoped questions related to vaccination schedules, disease profiles,
+        vaccine logistics, or procedural workflows — use the specific section tools instead.
+
+        Secondary source: WHO Immunization Guide (use `immunization_tool` when broader context is required).
 
         Args:
-            query (str): A general or complex question related to vaccination policy, schedules, or practice.
+            query (str): A general, complex, or cross-sectional vaccination query.
 
         Returns:
-            str: Synthesized response based on the full Algerian guide.
+            str: Synthesized answer from the entire national guide.
         """
         if not guide_retriever:
             return "Guide retriever not available"
         return section_tool_wrapper(guide_retriever, guide_path, query)
 
-    # Primary + Secondary Document Paths
-    immunization_path = './data/Immunization in Practice_WHO_eng_2015.json'
-
-    # WHO Immunization in Practice Tool
-    if os.path.exists(immunization_path):
-        immunization_vstore, immunization_docs = create_vectorstore_from_json(
-            immunization_path,
-            "Immunization_in_Practice_WHO_eng_2015",
-            embedding_function
-        )
-        immunization_retriever = create_retriever(immunization_vstore, immunization_docs, llm)
-    else:
-        immunization_retriever = None
 
     def immunization_tool(query: str) -> str:
         """
         WHO Immunization in Practice 2015 retrieval tool.
 
-        Use this tool to provide global best practices and operational guidance on immunization,
-        especially when context or clarification is needed beyond the Algerian national guide.
-        This can serve as a secondary source for training, logistics, and procedural reference.
+        Use ONLY when global guidance or procedural context is needed that is not covered or
+        is unclear in the Algerian guide. This is a secondary reference for training standards,
+        general immunization logistics, and vaccine delivery practices.
+
+        Do NOT use this tool to answer country-specific policy or scheduling questions.
 
         Args:
-            query (str): A question related to immunization practice in general.
+            query (str): A question seeking global immunization practices.
 
         Returns:
-            str: Retrieved guidance from the WHO Immunization in Practice manual (2015).
+            str: Content from the WHO Immunization in Practice guide.
         """
         if not immunization_retriever:
             return "Immunization in Practice retriever not available"
         return section_tool_wrapper(immunization_retriever, immunization_path, query)
 
 
-
-    # Section-Specific Tools (Primary: Algerian National Vaccination Guide)
+    # Section-Specific Tools
 
     def section_one_tool(query: str) -> str:
         """
         Section 1: Programme Élargi de Vaccination (PEV)
 
-        Use this tool to retrieve information about the Algerian immunization program:
-        its objectives, historical background, strengths and weaknesses, and justification
-        for calendar updates.
+        Use for queries about the national immunization program structure: its objectives,
+        history, evaluation, and rationale for updates to the Algerian calendar.
 
-        Primary source: Algerian National Vaccination Guide, Section 1.
-        Secondary source for operational benchmarks: WHO Immunization in Practice (optional).
+        Do NOT use for vaccine schedules, disease information, or administration techniques.
 
         Args:
-            query (str): A question about Algeria’s national immunization strategy.
+            query (str): A question about the foundation or evolution of the PEV.
 
         Returns:
-            str: Relevant content from Section 1 of the guide.
+            str: Response from Section 1.
         """
         return section_tool_wrapper(section_retrievers['one'], section_paths['one'], query)
 
 
     def section_two_tool(query: str) -> str:
         """
-        Section 2: Maladies Ciblées par la Vaccination
+        Section 2: Maladies Ciblées
 
-        Use this tool for questions about the diseases targeted by the national vaccination calendar:
-        symptoms, transmission, complications, and prevention strategies.
+        Use ONLY for questions about the characteristics of vaccine-preventable diseases:
+        symptoms, transmission, complications, and prevention.
 
-        Primary source: Algerian National Guide, Section 2.
-        Secondary source: WHO guide may support contextual insights.
+        Do NOT use for questions about vaccines, administration schedules, or procedures.
 
         Args:
-            query (str): A question about a vaccine-preventable disease (e.g. polio, rougeole).
+            query (str): A question about a disease covered by the national vaccination program.
 
         Returns:
-            str: Disease-specific guidance from Section 2.
+            str: Disease-specific content from Section 2.
         """
         return section_tool_wrapper(section_retrievers['two'], section_paths['two'], query)
 
@@ -325,14 +327,16 @@ def create_section_tools(embedding_function, llm):
         """
         Section 3: Vaccins du Calendrier
 
-        Use this tool to retrieve technical and procedural information about the vaccines used in the calendar:
-        names, contents, administration method, and dosing details.
+        Use ONLY for questions about the vaccines themselves: their types, compositions,
+        methods of administration, and how they work.
+
+        Do NOT use for schedule timing, catch-up protocols, or disease information.
 
         Args:
-            query (str): A question about a specific vaccine's type or method of use.
+            query (str): A question about a vaccine's formulation or method of delivery.
 
         Returns:
-            str: Vaccine information from Section 3.
+            str: Vaccine info from Section 3.
         """
         return section_tool_wrapper(section_retrievers['three'], section_paths['three'], query)
 
@@ -341,30 +345,34 @@ def create_section_tools(embedding_function, llm):
         """
         Section 4: Rattrapage Vaccinal
 
-        Use this tool to determine catch-up strategies for children who missed or delayed one or more doses.
-        It provides age-adjusted rescheduling rules and justifications.
+        Use ONLY when the question involves missed or delayed vaccinations and how to reschedule them
+        based on the child’s current age.
+
+        Do NOT use for standard schedules (on-time), vaccine properties, or cold chain issues.
 
         Args:
-            query (str): A question about how to manage missed vaccinations.
+            query (str): A question about catch-up vaccination based on delay or omission.
 
         Returns:
-            str: Catch-up guidelines from Section 4.
+            str: Catch-up guidance from Section 4.
         """
         return section_tool_wrapper(section_retrievers['four'], section_paths['four'], query)
 
 
     def section_five_tool(query: str) -> str:
         """
-        Section 5: Vaccination des Populations Particulières
+        Section 5: Populations Particulières
+
+        Use ONLY for vaccination questions concerning special populations:
+        preterm infants, immunosuppressed patients, chronic illness, or allergy conditions.
 
-        Use this tool to retrieve recommendations for specific medical contexts:
-        preterm infants, immunocompromised children, allergies (e.g. eggs), and chronic diseases.
+        Do NOT use for general population, standard calendar, or vaccine preparation.
 
         Args:
-            query (str): A question about vaccination adaptations for vulnerable groups.
+            query (str): A question about tailored vaccination for vulnerable groups.
 
         Returns:
-            str: Guidelines from Section 5.
+            str: Custom recommendations from Section 5.
         """
         return section_tool_wrapper(section_retrievers['five'], section_paths['five'], query)
 
@@ -373,14 +381,16 @@ def create_section_tools(embedding_function, llm):
         """
         Section 6: Chaîne du Froid
 
-        Use this tool for logistics, storage conditions, temperature monitoring,
-        and emergency procedures in case of cold chain failure.
+        Use ONLY for questions about vaccine storage, transport, cold chain equipment,
+        temperature monitoring, or cold chain failures.
+
+        Do NOT use for dose timing, administration methods, or disease information.
 
         Args:
-            query (str): A question about how vaccines should be stored and transported.
+            query (str): A logistics-related question about vaccine temperature management.
 
         Returns:
-            str: Operational cold chain standards from Section 6.
+            str: Cold chain instructions from Section 6.
         """
         return section_tool_wrapper(section_retrievers['six'], section_paths['six'], query)
 
@@ -389,30 +399,34 @@ def create_section_tools(embedding_function, llm):
         """
         Section 7: Sécurité des Injections
 
-        Use this tool to ensure injection safety: handling equipment, preventing needle-stick injuries,
-        and disposing of biomedical waste.
+        Use ONLY for questions related to the safe administration of vaccines:
+        equipment use, technique, safety precautions, and waste disposal.
+
+        Do NOT use for vaccine types, schedules, or cold chain issues.
 
         Args:
-            query (str): A question about safe injection practices.
+            query (str): A question about how to inject vaccines safely.
 
         Returns:
-            str: Procedures and guidelines from Section 7.
+            str: Best practices from Section 7.
         """
         return section_tool_wrapper(section_retrievers['seven'], section_paths['seven'], query)
 
 
     def section_eight_tool(query: str) -> str:
         """
-        Section 8: Tenue d'une Séance de Vaccination & Vaccinovigilance
+        Section 8: Séance de Vaccination & Vaccinovigilance
 
-        Use this tool to plan and monitor vaccination sessions, including material preparation,
-        injection recording, and handling of adverse events post-immunization (AEFI).
+        Use ONLY for questions about running a vaccination session, preparing the setting,
+        recording injections, and monitoring for adverse events (AEFI).
+
+        Do NOT use for disease, vaccine, or scheduling details.
 
         Args:
-            query (str): A question about session operations or vaccine side effect monitoring.
+            query (str): A question about operational conduct during vaccination.
 
         Returns:
-            str: Guidelines from Section 8.
+            str: Workflow and safety monitoring details from Section 8.
         """
         return section_tool_wrapper(section_retrievers['eight'], section_paths['eight'], query)
 
@@ -421,14 +435,16 @@ def create_section_tools(embedding_function, llm):
         """
         Section 9: Planification des Séances de Vaccination
 
-        Use this tool to support logistical planning: mapping, resource estimation,
-        scheduling, and stock management.
+        Use ONLY for planning and logistics questions: session scheduling, stock estimation,
+        and operational preparation at the facility level.
+
+        Do NOT use for vaccine info, schedules, or injection techniques.
 
         Args:
-            query (str): A question about planning and organizing vaccination sessions.
+            query (str): A question about how to plan or organize vaccination services.
 
         Returns:
-            str: Recommendations from Section 9.
+            str: Planning and stock guidance from Section 9.
         """
         return section_tool_wrapper(section_retrievers['nine'], section_paths['nine'], query)
 
@@ -437,17 +453,18 @@ def create_section_tools(embedding_function, llm):
         """
         Section 10: Mobilisation Sociale
 
-        Use this tool for strategies to increase public engagement, combat vaccine hesitancy,
-        and manage misinformation.
+        Use ONLY for questions about communication strategies, overcoming vaccine hesitancy,
+        rumor management, or community outreach.
+
+        Do NOT use for medical, logistical, or procedural topics.
 
         Args:
-            query (str): A question about public communication and trust-building around vaccines.
+            query (str): A question about public engagement or communication for vaccination.
 
         Returns:
-            str: Social mobilization approaches from Section 10.
+            str: Public mobilization strategies from Section 10.
         """
         return section_tool_wrapper(section_retrievers['ten'], section_paths['ten'], query)
-    
     # Create FunctionTool objects
     tools = [
         FunctionTool.from_defaults(name="Guide_vector_tool", fn=guide_retrieval_tool),