Research Query Management

Create and manage automated research queries that run on schedule to keep users updated on topics they care about.

Tools to Use

For query management, use these tools:

Tool	Purpose
`list_available_sources`	Show source options
`create_research_question`	Create new query
`list_research_questions`	See existing queries
`get_research_question`	Get query details
`update_research_question`	Modify query settings
`delete_research_question`	Remove a query
`run_discovery_for_question`	Test a query

Setting Up a New Recurring Search

Step 1: Understand User Needs

Ask these questions:

•"What topic do you want to track?"
•"How often do you want updates?" (daily/weekly)
•"How many papers per update is manageable for you?"

Step 2: Build the Query

code

list_available_sources()  # Show options

create_research_question(
  title="Descriptive title for this search",
  keywords=["primary_term", "secondary_term", "synonym"],
  sources=["source1", "source2"],
  max_papers=15,
  relevance_threshold=0.7,
  schedule="daily"  # or "weekly"
)

Step 3: Test the Query

code

run_discovery_for_question(question_id="[new query ID]")

Review results with user:

•Are papers relevant?
•Too many/too few results?
•Missing important keywords?

Step 4: Confirm Setup

code

"Your recurring search is set up:

📋 **Query**: [title]
🔑 **Keywords**: [list]
📚 **Sources**: [list]
⏰ **Schedule**: [daily/weekly]
📊 **Expected**: ~[X] papers per run

The system will automatically search for new papers and add them 
to your collection. You'll find new papers in your daily/weekly digest."

Refining Existing Queries

Diagnosis Questions

When user reports issues, ask:

Problem	Ask
Too many papers	"Are most papers relevant, or is there noise?"
Too few papers	"What kinds of papers are you missing?"
Wrong topic	"Can you show me papers you want vs. what you're getting?"

Common Refinements

Too much noise:

code

get_research_question(question_id="[query ID]")

update_research_question(
  question_id="[query ID]",
  relevance_threshold=0.8,  # Raise from 0.7
  keywords=["more", "specific", "terms"]  # Add specificity
)

Missing papers:

code

update_research_question(
  question_id="[query ID]",
  relevance_threshold=0.65,  # Lower threshold
  sources=["add", "more", "sources"],  # Add sources
  keywords=["existing", "plus", "synonyms"]  # Add synonyms
)

Wrong domain:

code

update_research_question(
  question_id="[query ID]",
  keywords=["topic", "-exclude_term"],  # Negative keywords
  sources=["domain_specific_source"]  # Change sources
)

Schedule Recommendations

User Availability	Schedule	Max Papers
10 min/day	daily	10-15
30 min/week	weekly	30-50
1+ hour/week	weekly	50-100
Comprehensive review	weekly	100+

Query Health Check

Periodically review query performance:

code

list_research_questions()

For each query:
  get_research_question(question_id="...")
  
  Check:
  - Last run date
  - Papers found per run
  - User engagement (if tracked)
  
  Recommend adjustments if needed

Workflow Examples

Example 1: New Topic Tracking

User: "Keep me updated on new papers about state space models"

code

1. "I'll set up a recurring search for you. A few questions:
    - How often should I check for new papers? (daily/weekly)
    - How many papers can you review? (~10-15 daily or ~30-50 weekly)"

2. [User: "Weekly, about 30 papers"]

3. create_research_question(
     title="State Space Models Research Updates",
     keywords=["state space model", "SSM", "Mamba", "S4", "linear attention"],
     sources=["arxiv", "semantic_scholar"],
     max_papers=35,
     relevance_threshold=0.7,
     schedule="weekly"
   )

4. run_discovery_for_question(question_id="...")

5. "Found 28 papers in the initial test. Here are the top 5:
    [list]
    
    Does this look like what you're looking for?"

Example 2: Refining a Noisy Query

User: "My attention mechanisms search is giving me too many irrelevant papers"

code

1. list_research_questions()  # Find the query

2. get_research_question(question_id="attention-query-id")
   → Current settings: threshold=0.65, keywords=["attention"]

3. "I see your current search uses broad keywords. Let's refine:
    - What specific type of attention are you interested in?
    - Any domains you want to exclude?"

4. [User: "Just efficient attention for transformers, not general attention"]

5. update_research_question(
     question_id="attention-query-id",
     keywords=["efficient attention", "linear attention", "sparse attention", "flash attention"],
     relevance_threshold=0.75
   )

6. run_discovery_for_question(question_id="attention-query-id")

7. "Updated! Test run found 18 papers (down from 45). 
    Here are the top 5 - are these more relevant?"

Example 3: Multiple Related Queries

User: "I'm researching LLM efficiency - help me set up comprehensive tracking"

code

1. "For comprehensive coverage, I recommend multiple focused queries:
   
   Query 1: Model Architecture Efficiency
   Query 2: Training Efficiency
   Query 3: Inference Optimization
   
   Each will capture different aspects. Shall I set these up?"

2. [Create each query with specific keywords]

3. "You now have 3 queries running weekly:
    - Architecture: ~15 papers/week
    - Training: ~20 papers/week
    - Inference: ~25 papers/week
    
    Total: ~60 papers/week. Manageable for your schedule?"

Response Template

For new query setup:

code

## Research Query Created ✓

**Title**: [query title]
**ID**: [query_id]

**Configuration**:
- Keywords: [list]
- Sources: [list]
- Schedule: [frequency]
- Max papers: [count]
- Relevance threshold: [value]

**Test Results**:
- Papers found: [count]
- Sample papers: [top 3]

**Next steps**:
- Query will run automatically on [schedule]
- Use `get_research_question(question_id="[ID]")` to check status
- Ask me to refine if results aren't quite right