Skip to main content

Bulk Operations

Learn how to efficiently manage multiple cache entries simultaneously using bulk operations.

What Are Bulk Operations?โ€‹

Bulk operations let you perform actions on many cache entries at once, saving time and effort when managing large numbers of entries.

Benefitsโ€‹

  • โฑ๏ธ Save time: Update 20 entries in minutes instead of hours
  • ๐ŸŽฏ Consistency: Apply the same changes across multiple entries
  • ๐Ÿ“Š Efficiency: Maintain large cache libraries effectively
  • ๐Ÿ”„ Scalability: Handle growth without proportional time investment

Available Bulk Operationsโ€‹

The admin panel currently supports one bulk operation:

๐Ÿค– Generate Variations (Bulk)โ€‹

Generate AI-powered question variations for multiple cache entries simultaneously.

Use when:

  • Creating variations for newly added entries
  • Improving underperforming entries (low "Times Served")
  • Updating entries after major content changes
  • Expanding cache coverage for popular topics

Learn more: Generating Variations


Selecting Entries for Bulk Operationsโ€‹

Step 1: Navigate to Cache Managementโ€‹

Go to Cache Management in the sidebar.


Before selecting entries, narrow down the list using filters:

Example Filters:

  • Status: Active only
  • Sort: Times Served (Low โ†’ High) to find underused entries
  • Search: Topic-specific keyword (e.g., "internship")

Why filter first?

  • Easier to see relevant entries
  • Avoid accidentally selecting wrong entries
  • Process entries with similar characteristics together

Step 3: Select Entriesโ€‹

Method 1: Individual Selection

Click the checkbox next to each entry you want to include.

Tips:

  • โœ… Check the box on the left side of each row
  • โœ… Selected entries show a checkmark โœ“
  • โœ… Click again to deselect

Method 2: Select All (If Available)

Some interfaces offer a "Select All" checkbox at the top of the list to select all visible entries at once.

Select All Limitation

"Select All" typically only selects entries on the current page (not all pages). If you have 50 entries across 5 pages, you must select each page separately.


Step 4: Verify Selection Countโ€‹

Check how many entries you've selected:

  • Look for a count indicator (e.g., "5 selected")
  • Or visually count checkmarks

Recommended Batch Sizes:

  • First time: 5-10 entries to test
  • Experienced users: 15-20 entries per batch
  • Maximum: 25 entries (larger batches increase timeout risk)
Start Small

For your first bulk operation, select just 3-5 entries to get comfortable with the process.


Performing Bulk Operationsโ€‹

Bulk Generate Variationsโ€‹

Step 1: Select Entriesโ€‹

Follow the selection process above.

Step 2: Click "Generate Variations (Bulk)"โ€‹

At the top of the Cache Management page, click the "๐Ÿค– Generate Variations (Bulk)" button.

No Selection Alert

If you haven't selected any entries, an alert appears: "Please select at least one entry."

Solution: Select entries first, then click the button.


Step 3: Confirm Bulk Operationโ€‹

A confirmation dialog appears:

"Generate variations for [X] selected entries?"

  • Number shown: Confirms how many entries will be processed
  • Click "OK": Proceed with bulk generation
  • Click "Cancel": Abort the operation

Double-check: Make sure the number matches your expected selection count!


Step 4: Monitor Progressโ€‹

The system processes entries in the background:

What happens:

  1. AI generates variations for each entry sequentially
  2. Progress may be shown (depending on implementation)
  3. Entries are saved automatically as they complete

Estimated Time:

EntriesExpected Duration
51-2 minutes
102-5 minutes
155-10 minutes
20+10-20 minutes
Stay on Page

Don't navigate away or close the browser while bulk operations are running. This can interrupt processing.


Step 5: Review Resultsโ€‹

After completion:

  1. Success message appears (green notification or modal)
  2. Entries show updated "Last Updated" timestamps
  3. Activity log records bulk operation

Recommended: Spot-check 2-3 entries to verify variations were added correctly.


Best Practices for Bulk Operationsโ€‹

1. Filter Before Selectingโ€‹

Why: Ensures you're operating on the right entries

Example Workflow:

Goal: Generate variations for all active entries with 0 "Times Served"

1. Filter by Status: Active
2. Sort by Times Served: Low โ†’ High
3. Select entries with "Times Served" = 0
4. Run bulk generate variations

2. Process in Batchesโ€‹

Why: Smaller batches are more manageable and less risky

Recommended Approach:

  • Batch 1: 10 entries
  • Review results
  • Batch 2: 10 more entries
  • Repeat until all entries are processed

Don't: Select all 100 entries at once (high timeout/error risk)

3. Test Firstโ€‹

Why: Verify bulk operations work as expected before large-scale use

Testing Process:

  1. Select 3-5 test entries
  2. Run bulk operation
  3. Review results carefully
  4. If successful, proceed with larger batches

4. Document Your Processโ€‹

Why: Track what you've done and what remains

Example Documentation:

Date: 1/15/2026
Action: Bulk generated variations for internship-related entries
Entries processed: 15
Results: All successful, added 8-12 variations per entry
Next steps: Review variations for accuracy, test cache hit rate

5. Verify Resultsโ€‹

Why: Catch errors or unexpected outcomes early

Verification Checklist:

  • โœ… Check "Last Updated" timestamps on processed entries
  • โœ… Open 2-3 entries to view generated variations
  • โœ… Verify activity log shows bulk operation
  • โœ… Monitor "Times Served" over next 1-2 weeks

Common Bulk Operation Scenariosโ€‹

Scenario 1: Onboarding New Cache Entriesโ€‹

Goal: Add variations to 20 newly created cache entries

Process:

  1. Filter by "Last Updated" (newest first)
  2. Select the 20 new entries
  3. Run Bulk Generate Variations
  4. Spot-check 5 entries for quality
  5. Manually refine variations as needed

Timeline: 10-15 minutes for full process


Scenario 2: Improving Underperforming Entriesโ€‹

Goal: Boost cache hit rate by adding variations to underused entries

Process:

  1. Filter by Status: Active
  2. Sort by Times Served (Low โ†’ High)
  3. Select top 15 entries with lowest "Times Served"
  4. Run Bulk Generate Variations
  5. Monitor performance over 2 weeks

Expected Impact: 20-50% increase in "Times Served" for targeted entries


Scenario 3: Seasonal Batch Updatesโ€‹

Goal: Update all course-related cache entries for new semester

Process:

  1. Search for course or HFIM keywords
  2. Review entries manually (not bulk operated, just filtered)
  3. Identify entries needing updates
  4. Manually edit responses first (bulk operations don't edit responses)
  5. Then select all and run Bulk Generate Variations

Why separate steps?: Bulk operations only generate variations, not edit core content


Scenario 4: Topic-Specific Enhancementโ€‹

Goal: Improve all "admission" related entries

Process:

  1. Search for admission or apply
  2. Select all matching entries
  3. Run Bulk Generate Variations
  4. Cross-check with actual user questions from Conversations
  5. Manually add variations based on real user phrasings

Timeline: 20-30 minutes including manual refinement


Troubleshooting Bulk Operationsโ€‹

Problem 1: "Please select at least one entry" Alertโ€‹

Cause: No entries selected before clicking bulk operation button

Solution:

  1. Click checkboxes next to entries you want to process
  2. Verify checkmarks appear (โœ“)
  3. Click bulk operation button again

Problem 2: Bulk Operation Times Outโ€‹

Cause: Selected too many entries or server is slow

Solution:

  1. Reduce batch size to 10-15 entries
  2. Try again during off-peak hours (early morning, weekends)
  3. If persistent, contact support

Prevention: Always use smaller batches (10-15 max)


Problem 3: Only Some Entries Were Processedโ€‹

Cause: Operation partially failed (network hiccup, timeout, error on specific entry)

Solution:

  1. Check which entries have updated "Last Updated" timestamps
  2. Select unprocessed entries
  3. Re-run bulk operation on remaining entries

How to identify unprocessed entries:

  • Compare "Last Updated" timestamps (unchanged entries weren't processed)
  • Check activity log for completion messages

Problem 4: Can't See Bulk Operation Buttonโ€‹

Cause: Button may be hidden on smaller screens or due to permissions

Solution:

  1. Scroll to top of page
  2. Look for buttons near search/filter controls
  3. Ensure you're logged in with admin permissions
  4. Try refreshing the page

Problem 5: Generated Variations Are Low Qualityโ€‹

Cause: AI misunderstood question intent or received poor input

Solution:

  1. Review and manually refine variations
  2. Consider if main question is clear enough
  3. For future bulk operations, improve question clarity first

Learn more: Generating Variations - Quality Review


Limitations and Considerationsโ€‹

Current Limitationsโ€‹

What bulk operations CAN do:

  • โœ… Generate variations for multiple entries at once

What bulk operations CANNOT do (currently):

  • โŒ Edit response text for multiple entries
  • โŒ Change status (Active/Inactive) in bulk
  • โŒ Update confidence scores in bulk
  • โŒ Modify TTL values in bulk
  • โŒ Delete multiple entries at once

For these tasks: Edit entries individually or contact support for custom bulk updates.

Performance Considerationsโ€‹

Factors affecting speed:

  1. Number of entries - More entries = longer processing time
  2. Complexity of questions - Longer, more complex questions take more time to process
  3. Server load - Peak usage hours may be slower
  4. Network speed - Your internet connection affects responsiveness

Optimal conditions:

  • Small-medium batches (10-15 entries)
  • Off-peak hours (early morning, weekends)
  • Stable internet connection
  • Well-defined, clear questions

Future Bulk Operationsโ€‹

The following bulk operations may be added in future updates:

Planned Featuresโ€‹

  • ๐Ÿ”„ Bulk Status Change - Activate/deactivate multiple entries
  • ๐Ÿ“Š Bulk Confidence Update - Adjust confidence for similar entries
  • ๐Ÿ—‘๏ธ Bulk Delete - Remove multiple obsolete entries
  • ๐Ÿ“ฅ Bulk Import/Export - Upload/download cache entries via CSV
  • โฐ Bulk TTL Update - Set same TTL for related entries

Want to request a feature? See Support


Tips for Large-Scale Cache Managementโ€‹

Managing 50+ Cache Entriesโ€‹

Strategy 1: Batch by Topic

  • Group entries by subject (courses, faculty, admissions, etc.)
  • Process one topic at a time
  • Easier to maintain consistency within topics

Strategy 2: Schedule Regular Maintenance

  • Weekly: Bulk generate variations for new entries
  • Monthly: Bulk process underperforming entries
  • Quarterly: Review all entries for accuracy

Strategy 3: Use Filters Effectively

  • Create "saved searches" (mentally or documented) for common filters
  • Example: "Active + Low Times Served + Courses" for regular review

Managing 100+ Cache Entriesโ€‹

Strategy 1: Delegate by Category

  • Assign specific topics to different admins
  • Example: Admin A handles courses, Admin B handles admissions

Strategy 2: Prioritize High-Impact Entries

  • Focus bulk operations on entries with highest "Times Served"
  • These affect the most users

Strategy 3: Automate Where Possible

  • Use bulk operations for variation generation
  • Document processes for consistency
  • Set reminders for regular maintenance

Bulk Operation Checklistโ€‹

Before running bulk operations, use this checklist:

  • Filtered entries to relevant subset
  • Selected appropriate batch size (10-20 entries)
  • Verified selection count matches expectation
  • Tested with small batch (first time)
  • Stable internet connection
  • Not during peak hours (optional)
  • Time to monitor (don't start right before leaving)
  • Plan to verify results after completion

Next Stepsโ€‹

Now that you understand bulk operations:

  1. Monitor performance metrics to measure impact
  2. Follow best practices for efficient cache management
  3. Troubleshoot issues if problems arise

Remember: Bulk operations are powerful tools for efficiency, but always verify results and start with small batches until you're confident in the process!