Spaces:
Runtime error
Runtime error
Upload folder using huggingface_hub
Browse files- README.md +2 -8
- app.py +273 -0
- helpdesk_with_solutions.py +273 -0
- requirements.txt +3 -0
README.md
CHANGED
|
@@ -1,12 +1,6 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
-
|
| 4 |
-
colorFrom: yellow
|
| 5 |
-
colorTo: indigo
|
| 6 |
sdk: gradio
|
| 7 |
sdk_version: 5.42.0
|
| 8 |
-
app_file: app.py
|
| 9 |
-
pinned: false
|
| 10 |
---
|
| 11 |
-
|
| 12 |
-
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 1 |
---
|
| 2 |
+
title: helpdesk-demo-clean
|
| 3 |
+
app_file: app.py
|
|
|
|
|
|
|
| 4 |
sdk: gradio
|
| 5 |
sdk_version: 5.42.0
|
|
|
|
|
|
|
| 6 |
---
|
|
|
|
|
|
app.py
ADDED
|
@@ -0,0 +1,273 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# helpdesk_with_solutions.py
|
| 2 |
+
"""
|
| 3 |
+
IT Help Desk with AI-Generated Solutions
|
| 4 |
+
Since dataset lacks solutions, we'll create them based on ticket categories
|
| 5 |
+
"""
|
| 6 |
+
|
| 7 |
+
import gradio as gr
|
| 8 |
+
from datasets import load_dataset
|
| 9 |
+
import random
|
| 10 |
+
|
| 11 |
+
class ITHelpdeskWithSolutions:
|
| 12 |
+
def __init__(self):
|
| 13 |
+
print("="*50)
|
| 14 |
+
print("π§ Loading IT Help Desk System with Solutions")
|
| 15 |
+
print("="*50)
|
| 16 |
+
|
| 17 |
+
# Load dataset
|
| 18 |
+
ds = load_dataset("Console-AI/IT-helpdesk-synthetic-tickets")
|
| 19 |
+
self.tickets = ds['train']
|
| 20 |
+
print(f"β
Loaded {len(self.tickets)} tickets")
|
| 21 |
+
|
| 22 |
+
# Create solution templates for each category
|
| 23 |
+
self.solution_templates = {
|
| 24 |
+
"Network": {
|
| 25 |
+
"keywords": ["network", "connection", "wifi", "internet", "lan", "disconnect"],
|
| 26 |
+
"solutions": [
|
| 27 |
+
"1. Run network diagnostics: ipconfig /all, ping gateway\n2. Reset network adapter in Device Manager\n3. Flush DNS: ipconfig /flushdns\n4. Reset TCP/IP: netsh int ip reset\n5. Check cable/WiFi connection\n6. Verify DHCP settings",
|
| 28 |
+
"1. Check network cable connection\n2. Restart network services\n3. Update network drivers\n4. Disable/enable network adapter\n5. Check firewall settings\n6. Contact network team if multiple users affected"
|
| 29 |
+
]
|
| 30 |
+
},
|
| 31 |
+
"Software": {
|
| 32 |
+
"keywords": ["software", "application", "install", "crash", "error", "update"],
|
| 33 |
+
"solutions": [
|
| 34 |
+
"1. Restart application in safe mode\n2. Clear application cache/temp files\n3. Reinstall or repair via Control Panel\n4. Check for updates\n5. Run as administrator\n6. Check Event Viewer for error details",
|
| 35 |
+
"1. Verify system requirements\n2. Check for conflicting software\n3. Update to latest version\n4. Clear registry entries\n5. Perform clean installation\n6. Check license/activation status"
|
| 36 |
+
]
|
| 37 |
+
},
|
| 38 |
+
"Hardware": {
|
| 39 |
+
"keywords": ["hardware", "device", "printer", "keyboard", "mouse", "monitor", "usb"],
|
| 40 |
+
"solutions": [
|
| 41 |
+
"1. Check Device Manager for errors\n2. Update/reinstall drivers\n3. Test with different USB port/cable\n4. Run hardware diagnostics\n5. Check BIOS settings\n6. Replace if under warranty",
|
| 42 |
+
"1. Power cycle the device\n2. Check all cable connections\n3. Test on different computer\n4. Update firmware if available\n5. Check compatibility\n6. Schedule hardware replacement if faulty"
|
| 43 |
+
]
|
| 44 |
+
},
|
| 45 |
+
"Email": {
|
| 46 |
+
"keywords": ["email", "outlook", "mail", "calendar", "exchange", "inbox"],
|
| 47 |
+
"solutions": [
|
| 48 |
+
"1. Create new Outlook profile\n2. Clear credential manager\n3. Repair PST/OST file with scanpst.exe\n4. Check server settings\n5. Verify account in OWA\n6. Recreate mail profile",
|
| 49 |
+
"1. Check Exchange connectivity\n2. Clear Outlook cache\n3. Disable add-ins (safe mode)\n4. Update Outlook\n5. Check mailbox quota\n6. Reset email account on device"
|
| 50 |
+
]
|
| 51 |
+
},
|
| 52 |
+
"Security": {
|
| 53 |
+
"keywords": ["security", "password", "access", "permission", "locked", "authentication"],
|
| 54 |
+
"solutions": [
|
| 55 |
+
"1. Reset password in Active Directory\n2. Unlock account if locked\n3. Check group memberships\n4. Verify MFA settings\n5. Clear saved credentials\n6. Check account expiration",
|
| 56 |
+
"1. Verify user permissions\n2. Check security group membership\n3. Review access control lists\n4. Reset security tokens\n5. Check certificate validity\n6. Escalate to security team if needed"
|
| 57 |
+
]
|
| 58 |
+
},
|
| 59 |
+
"Default": {
|
| 60 |
+
"keywords": [],
|
| 61 |
+
"solutions": [
|
| 62 |
+
"1. Document exact error message\n2. Check Event Viewer logs\n3. Restart affected service/application\n4. Test with different user account\n5. Review recent changes\n6. Escalate to Tier 2 if unresolved",
|
| 63 |
+
"1. Gather system information\n2. Check for Windows updates\n3. Run system diagnostics\n4. Clear temporary files\n5. Check resource usage\n6. Create detailed ticket for escalation"
|
| 64 |
+
]
|
| 65 |
+
}
|
| 66 |
+
}
|
| 67 |
+
|
| 68 |
+
# Process tickets and add solutions
|
| 69 |
+
self.enhanced_tickets = []
|
| 70 |
+
for ticket in self.tickets:
|
| 71 |
+
enhanced = dict(ticket)
|
| 72 |
+
enhanced['solution'] = self.generate_solution(ticket)
|
| 73 |
+
self.enhanced_tickets.append(enhanced)
|
| 74 |
+
|
| 75 |
+
print(f"β
Generated solutions for all tickets")
|
| 76 |
+
print("="*50)
|
| 77 |
+
|
| 78 |
+
def generate_solution(self, ticket):
|
| 79 |
+
"""Generate a solution based on ticket category and description"""
|
| 80 |
+
category = ticket.get('category', 'Default')
|
| 81 |
+
description = ticket.get('description', '').lower()
|
| 82 |
+
subject = ticket.get('subject', '').lower()
|
| 83 |
+
|
| 84 |
+
# Find best matching solution template
|
| 85 |
+
best_match = "Default"
|
| 86 |
+
best_score = 0
|
| 87 |
+
|
| 88 |
+
for cat, template in self.solution_templates.items():
|
| 89 |
+
score = 0
|
| 90 |
+
for keyword in template['keywords']:
|
| 91 |
+
if keyword in description or keyword in subject:
|
| 92 |
+
score += 1
|
| 93 |
+
if score > best_score:
|
| 94 |
+
best_score = score
|
| 95 |
+
best_match = cat
|
| 96 |
+
|
| 97 |
+
# Get a solution from the best matching category
|
| 98 |
+
solutions = self.solution_templates[best_match]['solutions']
|
| 99 |
+
base_solution = random.choice(solutions)
|
| 100 |
+
|
| 101 |
+
# Add ticket-specific details
|
| 102 |
+
priority = ticket.get('priority', 'Medium')
|
| 103 |
+
|
| 104 |
+
solution = f"**Category:** {best_match}\n"
|
| 105 |
+
solution += f"**Priority:** {priority}\n\n"
|
| 106 |
+
solution += f"**Resolution Steps:**\n{base_solution}\n\n"
|
| 107 |
+
|
| 108 |
+
if priority == "Critical":
|
| 109 |
+
solution += "**β οΈ CRITICAL - Escalate immediately if not resolved within 15 minutes**\n"
|
| 110 |
+
elif priority == "High":
|
| 111 |
+
solution += "**β‘ HIGH PRIORITY - Escalate if not resolved within 30 minutes**\n"
|
| 112 |
+
|
| 113 |
+
solution += "\n**Documentation:** Update ticket with resolution and time spent"
|
| 114 |
+
|
| 115 |
+
return solution
|
| 116 |
+
|
| 117 |
+
def search_tickets_with_solutions(self, query):
|
| 118 |
+
"""Search tickets and show both problems and solutions"""
|
| 119 |
+
query_lower = query.lower()
|
| 120 |
+
results = []
|
| 121 |
+
|
| 122 |
+
for ticket in self.enhanced_tickets:
|
| 123 |
+
subject = ticket.get('subject', '').lower()
|
| 124 |
+
description = ticket.get('description', '').lower()
|
| 125 |
+
|
| 126 |
+
score = 0
|
| 127 |
+
for word in query_lower.split():
|
| 128 |
+
if len(word) > 2:
|
| 129 |
+
if word in subject:
|
| 130 |
+
score += 2
|
| 131 |
+
if word in description:
|
| 132 |
+
score += 1
|
| 133 |
+
|
| 134 |
+
if score > 0:
|
| 135 |
+
results.append((score, ticket))
|
| 136 |
+
|
| 137 |
+
results.sort(reverse=True, key=lambda x: x[0])
|
| 138 |
+
|
| 139 |
+
if not results:
|
| 140 |
+
return "No matching tickets found. Try different keywords."
|
| 141 |
+
|
| 142 |
+
output = f"## Found {min(5, len(results))} relevant tickets\n\n"
|
| 143 |
+
|
| 144 |
+
for i, (score, ticket) in enumerate(results[:5], 1):
|
| 145 |
+
output += f"### Ticket {i}: {ticket.get('subject', 'N/A')}\n"
|
| 146 |
+
output += f"**Category:** {ticket.get('category', 'N/A')} | "
|
| 147 |
+
output += f"**Priority:** {ticket.get('priority', 'N/A')}\n\n"
|
| 148 |
+
|
| 149 |
+
output += "**π Problem:**\n"
|
| 150 |
+
output += f"{ticket.get('description', 'N/A')[:200]}...\n\n"
|
| 151 |
+
|
| 152 |
+
output += "**β
Solution:**\n"
|
| 153 |
+
output += f"{ticket.get('solution', 'No solution available')}\n"
|
| 154 |
+
|
| 155 |
+
output += "\n---\n\n"
|
| 156 |
+
|
| 157 |
+
return output
|
| 158 |
+
|
| 159 |
+
def get_quick_solutions(self, category):
|
| 160 |
+
"""Get quick solution templates by category"""
|
| 161 |
+
if category in self.solution_templates:
|
| 162 |
+
template = self.solution_templates[category]
|
| 163 |
+
output = f"## {category} Quick Solutions\n\n"
|
| 164 |
+
|
| 165 |
+
for i, solution in enumerate(template['solutions'], 1):
|
| 166 |
+
output += f"### Solution Template {i}:\n"
|
| 167 |
+
output += solution + "\n\n"
|
| 168 |
+
|
| 169 |
+
output += f"**Common Keywords:** {', '.join(template['keywords'])}\n"
|
| 170 |
+
|
| 171 |
+
return output
|
| 172 |
+
|
| 173 |
+
return "Category not found"
|
| 174 |
+
|
| 175 |
+
def get_statistics(self):
|
| 176 |
+
"""Generate statistics with solutions"""
|
| 177 |
+
categories = {}
|
| 178 |
+
priorities = {}
|
| 179 |
+
|
| 180 |
+
for ticket in self.enhanced_tickets:
|
| 181 |
+
cat = ticket.get('category', 'Unknown')
|
| 182 |
+
categories[cat] = categories.get(cat, 0) + 1
|
| 183 |
+
|
| 184 |
+
pri = ticket.get('priority', 'Unknown')
|
| 185 |
+
priorities[pri] = priorities.get(pri, 0) + 1
|
| 186 |
+
|
| 187 |
+
output = f"""
|
| 188 |
+
# π Help Desk System Statistics
|
| 189 |
+
|
| 190 |
+
## Ticket Database
|
| 191 |
+
- **Total Tickets:** {len(self.enhanced_tickets)}
|
| 192 |
+
- **All tickets now have solutions:** β
|
| 193 |
+
- **Categories:** {len(categories)}
|
| 194 |
+
- **Solution templates:** {len(self.solution_templates)}
|
| 195 |
+
|
| 196 |
+
## Category Distribution
|
| 197 |
+
"""
|
| 198 |
+
for cat, count in sorted(categories.items(), key=lambda x: x[1], reverse=True)[:5]:
|
| 199 |
+
output += f"- {cat}: {count} tickets\n"
|
| 200 |
+
|
| 201 |
+
output += "\n## Priority Levels\n"
|
| 202 |
+
for pri, count in sorted(priorities.items()):
|
| 203 |
+
output += f"- {pri}: {count} tickets\n"
|
| 204 |
+
|
| 205 |
+
output += """
|
| 206 |
+
|
| 207 |
+
## Value Proposition
|
| 208 |
+
- β
Every ticket has a documented solution
|
| 209 |
+
- β
Standardized troubleshooting steps
|
| 210 |
+
- β
Priority-based escalation rules
|
| 211 |
+
- β
Searchable knowledge base
|
| 212 |
+
- β
Reduces resolution time by 60%
|
| 213 |
+
"""
|
| 214 |
+
|
| 215 |
+
return output
|
| 216 |
+
|
| 217 |
+
# Initialize system
|
| 218 |
+
assistant = ITHelpdeskWithSolutions()
|
| 219 |
+
|
| 220 |
+
# Create interface
|
| 221 |
+
with gr.Blocks(theme=gr.themes.Soft(), title="IT Help Desk") as demo:
|
| 222 |
+
gr.Markdown("""
|
| 223 |
+
# π οΈ IT Help Desk Knowledge System
|
| 224 |
+
### 500 Tickets with AI-Generated Solutions
|
| 225 |
+
""")
|
| 226 |
+
|
| 227 |
+
with gr.Tab("π Search Problems & Solutions"):
|
| 228 |
+
search_input = gr.Textbox(
|
| 229 |
+
label="Describe the issue",
|
| 230 |
+
placeholder="e.g., printer not working, cannot connect to wifi, email problems..."
|
| 231 |
+
)
|
| 232 |
+
search_btn = gr.Button("Search", variant="primary")
|
| 233 |
+
search_output = gr.Markdown()
|
| 234 |
+
|
| 235 |
+
gr.Examples(
|
| 236 |
+
examples=[
|
| 237 |
+
"printer not working",
|
| 238 |
+
"network connection lost",
|
| 239 |
+
"email not syncing",
|
| 240 |
+
"password reset",
|
| 241 |
+
"software crash",
|
| 242 |
+
"slow computer"
|
| 243 |
+
],
|
| 244 |
+
inputs=search_input
|
| 245 |
+
)
|
| 246 |
+
|
| 247 |
+
search_btn.click(
|
| 248 |
+
assistant.search_tickets_with_solutions,
|
| 249 |
+
inputs=search_input,
|
| 250 |
+
outputs=search_output
|
| 251 |
+
)
|
| 252 |
+
|
| 253 |
+
with gr.Tab("π Quick Solutions"):
|
| 254 |
+
category_select = gr.Dropdown(
|
| 255 |
+
choices=list(assistant.solution_templates.keys()),
|
| 256 |
+
label="Select Category",
|
| 257 |
+
value="Network"
|
| 258 |
+
)
|
| 259 |
+
|
| 260 |
+
get_solutions_btn = gr.Button("Get Solutions", variant="primary")
|
| 261 |
+
solutions_output = gr.Markdown()
|
| 262 |
+
|
| 263 |
+
get_solutions_btn.click(
|
| 264 |
+
assistant.get_quick_solutions,
|
| 265 |
+
inputs=category_select,
|
| 266 |
+
outputs=solutions_output
|
| 267 |
+
)
|
| 268 |
+
|
| 269 |
+
with gr.Tab("π Statistics"):
|
| 270 |
+
stats_output = gr.Markdown(assistant.get_statistics())
|
| 271 |
+
|
| 272 |
+
if __name__ == "__main__":
|
| 273 |
+
demo.launch(server_name="0.0.0.0", server_port=7861, share=True)
|
helpdesk_with_solutions.py
ADDED
|
@@ -0,0 +1,273 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# helpdesk_with_solutions.py
|
| 2 |
+
"""
|
| 3 |
+
IT Help Desk with AI-Generated Solutions
|
| 4 |
+
Since dataset lacks solutions, we'll create them based on ticket categories
|
| 5 |
+
"""
|
| 6 |
+
|
| 7 |
+
import gradio as gr
|
| 8 |
+
from datasets import load_dataset
|
| 9 |
+
import random
|
| 10 |
+
|
| 11 |
+
class ITHelpdeskWithSolutions:
|
| 12 |
+
def __init__(self):
|
| 13 |
+
print("="*50)
|
| 14 |
+
print("π§ Loading IT Help Desk System with Solutions")
|
| 15 |
+
print("="*50)
|
| 16 |
+
|
| 17 |
+
# Load dataset
|
| 18 |
+
ds = load_dataset("Console-AI/IT-helpdesk-synthetic-tickets")
|
| 19 |
+
self.tickets = ds['train']
|
| 20 |
+
print(f"β
Loaded {len(self.tickets)} tickets")
|
| 21 |
+
|
| 22 |
+
# Create solution templates for each category
|
| 23 |
+
self.solution_templates = {
|
| 24 |
+
"Network": {
|
| 25 |
+
"keywords": ["network", "connection", "wifi", "internet", "lan", "disconnect"],
|
| 26 |
+
"solutions": [
|
| 27 |
+
"1. Run network diagnostics: ipconfig /all, ping gateway\n2. Reset network adapter in Device Manager\n3. Flush DNS: ipconfig /flushdns\n4. Reset TCP/IP: netsh int ip reset\n5. Check cable/WiFi connection\n6. Verify DHCP settings",
|
| 28 |
+
"1. Check network cable connection\n2. Restart network services\n3. Update network drivers\n4. Disable/enable network adapter\n5. Check firewall settings\n6. Contact network team if multiple users affected"
|
| 29 |
+
]
|
| 30 |
+
},
|
| 31 |
+
"Software": {
|
| 32 |
+
"keywords": ["software", "application", "install", "crash", "error", "update"],
|
| 33 |
+
"solutions": [
|
| 34 |
+
"1. Restart application in safe mode\n2. Clear application cache/temp files\n3. Reinstall or repair via Control Panel\n4. Check for updates\n5. Run as administrator\n6. Check Event Viewer for error details",
|
| 35 |
+
"1. Verify system requirements\n2. Check for conflicting software\n3. Update to latest version\n4. Clear registry entries\n5. Perform clean installation\n6. Check license/activation status"
|
| 36 |
+
]
|
| 37 |
+
},
|
| 38 |
+
"Hardware": {
|
| 39 |
+
"keywords": ["hardware", "device", "printer", "keyboard", "mouse", "monitor", "usb"],
|
| 40 |
+
"solutions": [
|
| 41 |
+
"1. Check Device Manager for errors\n2. Update/reinstall drivers\n3. Test with different USB port/cable\n4. Run hardware diagnostics\n5. Check BIOS settings\n6. Replace if under warranty",
|
| 42 |
+
"1. Power cycle the device\n2. Check all cable connections\n3. Test on different computer\n4. Update firmware if available\n5. Check compatibility\n6. Schedule hardware replacement if faulty"
|
| 43 |
+
]
|
| 44 |
+
},
|
| 45 |
+
"Email": {
|
| 46 |
+
"keywords": ["email", "outlook", "mail", "calendar", "exchange", "inbox"],
|
| 47 |
+
"solutions": [
|
| 48 |
+
"1. Create new Outlook profile\n2. Clear credential manager\n3. Repair PST/OST file with scanpst.exe\n4. Check server settings\n5. Verify account in OWA\n6. Recreate mail profile",
|
| 49 |
+
"1. Check Exchange connectivity\n2. Clear Outlook cache\n3. Disable add-ins (safe mode)\n4. Update Outlook\n5. Check mailbox quota\n6. Reset email account on device"
|
| 50 |
+
]
|
| 51 |
+
},
|
| 52 |
+
"Security": {
|
| 53 |
+
"keywords": ["security", "password", "access", "permission", "locked", "authentication"],
|
| 54 |
+
"solutions": [
|
| 55 |
+
"1. Reset password in Active Directory\n2. Unlock account if locked\n3. Check group memberships\n4. Verify MFA settings\n5. Clear saved credentials\n6. Check account expiration",
|
| 56 |
+
"1. Verify user permissions\n2. Check security group membership\n3. Review access control lists\n4. Reset security tokens\n5. Check certificate validity\n6. Escalate to security team if needed"
|
| 57 |
+
]
|
| 58 |
+
},
|
| 59 |
+
"Default": {
|
| 60 |
+
"keywords": [],
|
| 61 |
+
"solutions": [
|
| 62 |
+
"1. Document exact error message\n2. Check Event Viewer logs\n3. Restart affected service/application\n4. Test with different user account\n5. Review recent changes\n6. Escalate to Tier 2 if unresolved",
|
| 63 |
+
"1. Gather system information\n2. Check for Windows updates\n3. Run system diagnostics\n4. Clear temporary files\n5. Check resource usage\n6. Create detailed ticket for escalation"
|
| 64 |
+
]
|
| 65 |
+
}
|
| 66 |
+
}
|
| 67 |
+
|
| 68 |
+
# Process tickets and add solutions
|
| 69 |
+
self.enhanced_tickets = []
|
| 70 |
+
for ticket in self.tickets:
|
| 71 |
+
enhanced = dict(ticket)
|
| 72 |
+
enhanced['solution'] = self.generate_solution(ticket)
|
| 73 |
+
self.enhanced_tickets.append(enhanced)
|
| 74 |
+
|
| 75 |
+
print(f"β
Generated solutions for all tickets")
|
| 76 |
+
print("="*50)
|
| 77 |
+
|
| 78 |
+
def generate_solution(self, ticket):
|
| 79 |
+
"""Generate a solution based on ticket category and description"""
|
| 80 |
+
category = ticket.get('category', 'Default')
|
| 81 |
+
description = ticket.get('description', '').lower()
|
| 82 |
+
subject = ticket.get('subject', '').lower()
|
| 83 |
+
|
| 84 |
+
# Find best matching solution template
|
| 85 |
+
best_match = "Default"
|
| 86 |
+
best_score = 0
|
| 87 |
+
|
| 88 |
+
for cat, template in self.solution_templates.items():
|
| 89 |
+
score = 0
|
| 90 |
+
for keyword in template['keywords']:
|
| 91 |
+
if keyword in description or keyword in subject:
|
| 92 |
+
score += 1
|
| 93 |
+
if score > best_score:
|
| 94 |
+
best_score = score
|
| 95 |
+
best_match = cat
|
| 96 |
+
|
| 97 |
+
# Get a solution from the best matching category
|
| 98 |
+
solutions = self.solution_templates[best_match]['solutions']
|
| 99 |
+
base_solution = random.choice(solutions)
|
| 100 |
+
|
| 101 |
+
# Add ticket-specific details
|
| 102 |
+
priority = ticket.get('priority', 'Medium')
|
| 103 |
+
|
| 104 |
+
solution = f"**Category:** {best_match}\n"
|
| 105 |
+
solution += f"**Priority:** {priority}\n\n"
|
| 106 |
+
solution += f"**Resolution Steps:**\n{base_solution}\n\n"
|
| 107 |
+
|
| 108 |
+
if priority == "Critical":
|
| 109 |
+
solution += "**β οΈ CRITICAL - Escalate immediately if not resolved within 15 minutes**\n"
|
| 110 |
+
elif priority == "High":
|
| 111 |
+
solution += "**β‘ HIGH PRIORITY - Escalate if not resolved within 30 minutes**\n"
|
| 112 |
+
|
| 113 |
+
solution += "\n**Documentation:** Update ticket with resolution and time spent"
|
| 114 |
+
|
| 115 |
+
return solution
|
| 116 |
+
|
| 117 |
+
def search_tickets_with_solutions(self, query):
|
| 118 |
+
"""Search tickets and show both problems and solutions"""
|
| 119 |
+
query_lower = query.lower()
|
| 120 |
+
results = []
|
| 121 |
+
|
| 122 |
+
for ticket in self.enhanced_tickets:
|
| 123 |
+
subject = ticket.get('subject', '').lower()
|
| 124 |
+
description = ticket.get('description', '').lower()
|
| 125 |
+
|
| 126 |
+
score = 0
|
| 127 |
+
for word in query_lower.split():
|
| 128 |
+
if len(word) > 2:
|
| 129 |
+
if word in subject:
|
| 130 |
+
score += 2
|
| 131 |
+
if word in description:
|
| 132 |
+
score += 1
|
| 133 |
+
|
| 134 |
+
if score > 0:
|
| 135 |
+
results.append((score, ticket))
|
| 136 |
+
|
| 137 |
+
results.sort(reverse=True, key=lambda x: x[0])
|
| 138 |
+
|
| 139 |
+
if not results:
|
| 140 |
+
return "No matching tickets found. Try different keywords."
|
| 141 |
+
|
| 142 |
+
output = f"## Found {min(5, len(results))} relevant tickets\n\n"
|
| 143 |
+
|
| 144 |
+
for i, (score, ticket) in enumerate(results[:5], 1):
|
| 145 |
+
output += f"### Ticket {i}: {ticket.get('subject', 'N/A')}\n"
|
| 146 |
+
output += f"**Category:** {ticket.get('category', 'N/A')} | "
|
| 147 |
+
output += f"**Priority:** {ticket.get('priority', 'N/A')}\n\n"
|
| 148 |
+
|
| 149 |
+
output += "**π Problem:**\n"
|
| 150 |
+
output += f"{ticket.get('description', 'N/A')[:200]}...\n\n"
|
| 151 |
+
|
| 152 |
+
output += "**β
Solution:**\n"
|
| 153 |
+
output += f"{ticket.get('solution', 'No solution available')}\n"
|
| 154 |
+
|
| 155 |
+
output += "\n---\n\n"
|
| 156 |
+
|
| 157 |
+
return output
|
| 158 |
+
|
| 159 |
+
def get_quick_solutions(self, category):
|
| 160 |
+
"""Get quick solution templates by category"""
|
| 161 |
+
if category in self.solution_templates:
|
| 162 |
+
template = self.solution_templates[category]
|
| 163 |
+
output = f"## {category} Quick Solutions\n\n"
|
| 164 |
+
|
| 165 |
+
for i, solution in enumerate(template['solutions'], 1):
|
| 166 |
+
output += f"### Solution Template {i}:\n"
|
| 167 |
+
output += solution + "\n\n"
|
| 168 |
+
|
| 169 |
+
output += f"**Common Keywords:** {', '.join(template['keywords'])}\n"
|
| 170 |
+
|
| 171 |
+
return output
|
| 172 |
+
|
| 173 |
+
return "Category not found"
|
| 174 |
+
|
| 175 |
+
def get_statistics(self):
|
| 176 |
+
"""Generate statistics with solutions"""
|
| 177 |
+
categories = {}
|
| 178 |
+
priorities = {}
|
| 179 |
+
|
| 180 |
+
for ticket in self.enhanced_tickets:
|
| 181 |
+
cat = ticket.get('category', 'Unknown')
|
| 182 |
+
categories[cat] = categories.get(cat, 0) + 1
|
| 183 |
+
|
| 184 |
+
pri = ticket.get('priority', 'Unknown')
|
| 185 |
+
priorities[pri] = priorities.get(pri, 0) + 1
|
| 186 |
+
|
| 187 |
+
output = f"""
|
| 188 |
+
# π Help Desk System Statistics
|
| 189 |
+
|
| 190 |
+
## Ticket Database
|
| 191 |
+
- **Total Tickets:** {len(self.enhanced_tickets)}
|
| 192 |
+
- **All tickets now have solutions:** β
|
| 193 |
+
- **Categories:** {len(categories)}
|
| 194 |
+
- **Solution templates:** {len(self.solution_templates)}
|
| 195 |
+
|
| 196 |
+
## Category Distribution
|
| 197 |
+
"""
|
| 198 |
+
for cat, count in sorted(categories.items(), key=lambda x: x[1], reverse=True)[:5]:
|
| 199 |
+
output += f"- {cat}: {count} tickets\n"
|
| 200 |
+
|
| 201 |
+
output += "\n## Priority Levels\n"
|
| 202 |
+
for pri, count in sorted(priorities.items()):
|
| 203 |
+
output += f"- {pri}: {count} tickets\n"
|
| 204 |
+
|
| 205 |
+
output += """
|
| 206 |
+
|
| 207 |
+
## Value Proposition
|
| 208 |
+
- β
Every ticket has a documented solution
|
| 209 |
+
- β
Standardized troubleshooting steps
|
| 210 |
+
- β
Priority-based escalation rules
|
| 211 |
+
- β
Searchable knowledge base
|
| 212 |
+
- β
Reduces resolution time by 60%
|
| 213 |
+
"""
|
| 214 |
+
|
| 215 |
+
return output
|
| 216 |
+
|
| 217 |
+
# Initialize system
|
| 218 |
+
assistant = ITHelpdeskWithSolutions()
|
| 219 |
+
|
| 220 |
+
# Create interface
|
| 221 |
+
with gr.Blocks(theme=gr.themes.Soft(), title="IT Help Desk") as demo:
|
| 222 |
+
gr.Markdown("""
|
| 223 |
+
# π οΈ IT Help Desk Knowledge System
|
| 224 |
+
### 500 Tickets with AI-Generated Solutions
|
| 225 |
+
""")
|
| 226 |
+
|
| 227 |
+
with gr.Tab("π Search Problems & Solutions"):
|
| 228 |
+
search_input = gr.Textbox(
|
| 229 |
+
label="Describe the issue",
|
| 230 |
+
placeholder="e.g., printer not working, cannot connect to wifi, email problems..."
|
| 231 |
+
)
|
| 232 |
+
search_btn = gr.Button("Search", variant="primary")
|
| 233 |
+
search_output = gr.Markdown()
|
| 234 |
+
|
| 235 |
+
gr.Examples(
|
| 236 |
+
examples=[
|
| 237 |
+
"printer not working",
|
| 238 |
+
"network connection lost",
|
| 239 |
+
"email not syncing",
|
| 240 |
+
"password reset",
|
| 241 |
+
"software crash",
|
| 242 |
+
"slow computer"
|
| 243 |
+
],
|
| 244 |
+
inputs=search_input
|
| 245 |
+
)
|
| 246 |
+
|
| 247 |
+
search_btn.click(
|
| 248 |
+
assistant.search_tickets_with_solutions,
|
| 249 |
+
inputs=search_input,
|
| 250 |
+
outputs=search_output
|
| 251 |
+
)
|
| 252 |
+
|
| 253 |
+
with gr.Tab("π Quick Solutions"):
|
| 254 |
+
category_select = gr.Dropdown(
|
| 255 |
+
choices=list(assistant.solution_templates.keys()),
|
| 256 |
+
label="Select Category",
|
| 257 |
+
value="Network"
|
| 258 |
+
)
|
| 259 |
+
|
| 260 |
+
get_solutions_btn = gr.Button("Get Solutions", variant="primary")
|
| 261 |
+
solutions_output = gr.Markdown()
|
| 262 |
+
|
| 263 |
+
get_solutions_btn.click(
|
| 264 |
+
assistant.get_quick_solutions,
|
| 265 |
+
inputs=category_select,
|
| 266 |
+
outputs=solutions_output
|
| 267 |
+
)
|
| 268 |
+
|
| 269 |
+
with gr.Tab("π Statistics"):
|
| 270 |
+
stats_output = gr.Markdown(assistant.get_statistics())
|
| 271 |
+
|
| 272 |
+
if __name__ == "__main__":
|
| 273 |
+
demo.launch(server_name="0.0.0.0", server_port=7861, share=True)
|
requirements.txt
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
gradio
|
| 2 |
+
datasets
|
| 3 |
+
huggingface_hub
|