feat: improve semantic scholar usage guidance

app/system_instruction.txt

@@ -20,7 +20,11 @@ When using the `search_medical_literature` tool, follow these guidelines for opt
 1. **Extract key medical terms**: Identify the core medical concepts, conditions, procedures, and medications from the user's query
 2. **Use medical terminology**: Convert colloquial terms to proper medical terminology when possible
 3. **Combine related concepts**: Use Boolean operators (AND, OR) to connect relevant terms
-4. **Keep queries focused**: Limit to 2-4 key concepts to avoid overly narrow searches
+4. **Optimize search scope**: Keep keywords broad and conceptual, focusing on 2-4 core medical terms. Avoid overly specific modifiers like "criteria," "indicators," "guidelines," or "recommendations" - instead, let the literature search return comprehensive results that you can then analyze to extract specific criteria, diagnostic indicators, or clinical recommendations. This approach ensures broader coverage of relevant evidence while maintaining search efficiency.
+5. **Search refinement strategy**: If initial results are insufficient or irrelevant, try to search with the tool again and systematically refine your approach:
+   - **Broaden the query**: Remove specific modifiers and use more general medical terms
+   - **Alternative terminology**: Try synonyms or different medical terminology for the same concept
+   - **Reduce keyword count**: Focus on 2-3 most essential terms if the original query was complex
 
 Examples:
 - User query: "When to discontinue oral anticoagulant therapy in a 85 yr patient undergoing a colonoscopy?"
@@ -32,6 +36,9 @@ Examples:
 - User query: "How effective is physical therapy for lower back pain?"
   - Good search query: `search_medical_literature("physical therapy efficacy lower back pain")`
 
+- User query: "What are the criteria for laparoscopic vs open approach in resectable hilar cholangiocarcinoma?"
+  - Good search query: `search_medical_literature("resectable hilar cholangiocarcinoma laparoscopic vs open")`
+
 ## Evidence Hierarchy for Medical Literature (in descending order of strength)
 
 1. **Clinical Practice Guidelines** from governmental agencies (e.g., CDC, FDA), professional medical societies, or major healthcare organizations

app/tools/literature.py

@@ -83,6 +83,17 @@ def format_publication(publication: dict) -> dict:
 def search_medical_literature(query: str) -> list[dict]:
     """Get medical literature related to the query.
 
+    For optimal results, follow these guidelines:
+
+    1. Extract key medical terms: Search for core MEDICAL concepts,
+        conditions, procedures, and medications
+    2. Optimize search scope: Keep keywords broad and conceptual,
+        focusing on 2-4 core medical terms. Avoid modifiers like
+        "criteria," "indicators," "guidelines," "recommendations,"
+        "treatment," or "management"
+    3. Use medical terminology: Convert colloquial terms to proper
+        medical terminology when possible
+
     Args:
         query: keywords, a topic, or a concept to search
             for medical literature.