Acronyms & Query Expansion Overview

The Acronyms & Query Expansion feature helps the chatbot understand specialized terms and jargon. This page explains what these features do and why they matter.

What Are Acronyms?

Acronyms are abbreviations that users might type when asking questions. The chatbot automatically expands these to their full meanings for better search results.

Example

When a user types:

"What are the HFIM requirements?"

The chatbot knows that HFIM means "Hospitality and Food Industry Management" and can find relevant documents that use either the acronym or the full name.

Think of It Like...

Imagine a translator who knows all the shorthand:

• Without acronyms: User says "CAES" and the chatbot has no idea what they mean
• With acronyms: The chatbot understands "CAES" means "College of Agricultural and Environmental Sciences" and searches appropriately

What Is Query Expansion?

Query Expansion adds related terms to user searches to improve results. This is broader than acronyms - it handles synonyms, role titles, and domain-specific language.

Example

When a user asks:

"Who runs the HFIM program?"

Query expansion adds terms like "director," "head," "chair," and "coordinator" to the search, increasing the chances of finding the right information.

Types of Expansions

Type	Purpose	Example
Synonym	Word equivalents	"program" → "program department"
Role	Leadership titles	"runs" → "director head coordinator"
Unit Type	Organizational terms	"office" → "office department"
Extension	Extension-specific	"agent" → "county extension agent"

Why This Matters

1. Better Search Results

Without expansions:

• "HFIM advisor" might miss documents that say "Hospitality advisor"
• "Who heads the department?" might miss "Department Chair" listings

With expansions:

• The chatbot finds relevant results regardless of exact wording
• Users don't need to know the "right" terminology

2. Domain Expertise

HFIM and UGA Extension use specialized language:

• Program-specific acronyms (HFIM, FACS, FDNS)
• Department abbreviations (CAES, FACS)
• Role titles (County Agent, Extension Specialist)

Your acronym database teaches the chatbot this vocabulary.

3. Improved User Experience

Users can ask questions naturally:

• They don't need to spell out acronyms
• They can use common phrases like "who runs" or "in charge of"
• The chatbot understands them regardless

The Interface

Statistics Dashboard

At the top of the page, you'll see:

Stat	Meaning
Total Acronyms	Number of acronyms in the database
Active Expansions	Number of active query expansions
In Memory	Expansions currently loaded for use

Two Tabs

The page has two tabs:

1. Acronyms Tab - Manage abbreviation → definition mappings
2. Query Expansions Tab - Manage term → expansion rules

Reload Cache Button

The Reload Cache button refreshes the in-memory expansions without restarting the server. Use this after making changes to ensure they take effect immediately.

How It Works Behind the Scenes

When a user asks a question:

1. User types: "HFIM internship requirements"
                        ↓
2. Acronym expansion: "Hospitality and Food Industry Management internship requirements"
                        ↓
3. Query expansion: Adds related terms for better matching
                        ↓
4. Enhanced search finds more relevant documents
                        ↓
5. Better answer for the user!

Processing Order

1. Acronym expansion happens first - replacing known abbreviations
2. Query expansion happens second - adding related search terms
3. The expanded query is used for vector search
4. Results are ranked and presented

Common Tasks

Task	Where to Do It
Add a new acronym	Managing Acronyms
Edit an acronym	Managing Acronyms
Add query expansion	Query Expansions
Apply changes immediately	Click "Reload Cache" button

Best Practices Overview

For Acronyms

• Add all HFIM-specific abbreviations
• Include common misspellings if applicable
• Keep definitions clear and consistent
• Categorize for easy management

For Query Expansions

• Focus on terms that cause search misses
• Don't over-expand (can reduce precision)
• Test changes to ensure improvement
• Use the right type classification

Start Simple

Begin by adding the most common acronyms your users encounter. You can always expand the database over time based on conversation analysis.

When to Update

Add New Entries When:

• Users are asking questions with unfamiliar terms
• New programs or departments are created
• You notice search misses for common questions

Review Existing Entries When:

• Programs are renamed or reorganized
• Acronyms change meaning
• Feedback suggests search quality issues

Next Steps

• Managing Acronyms - Add and edit acronyms
• Query Expansions - Configure search expansions
• Best Practices - Tips for effective configuration

---

Remember: Good acronym and expansion management makes the chatbot feel like it truly understands your domain!