Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
language:
|
| 4 |
+
- en
|
| 5 |
+
tags:
|
| 6 |
+
- ticket-classification
|
| 7 |
+
- it-support
|
| 8 |
+
- distilbert
|
| 9 |
+
- text-classification
|
| 10 |
+
datasets:
|
| 11 |
+
- custom
|
| 12 |
+
metrics:
|
| 13 |
+
- f1
|
| 14 |
+
- accuracy
|
| 15 |
+
---
|
| 16 |
+
|
| 17 |
+
# IT Service Desk Ticket Classifier
|
| 18 |
+
|
| 19 |
+
A DistilBERT-based model for classifying IT support tickets into 12 categories.
|
| 20 |
+
|
| 21 |
+
## Model Description
|
| 22 |
+
|
| 23 |
+
This model classifies IT service desk tickets into the following categories:
|
| 24 |
+
|
| 25 |
+
| Category | Description |
|
| 26 |
+
|----------|-------------|
|
| 27 |
+
| Access Management | Login, permissions, MFA issues |
|
| 28 |
+
| Backup | Backup and restore operations |
|
| 29 |
+
| Database | SQL, database connectivity |
|
| 30 |
+
| Email | Outlook, calendar, mailbox |
|
| 31 |
+
| General Inquiry | How-to questions |
|
| 32 |
+
| Hardware | Physical device issues |
|
| 33 |
+
| Network | WiFi, VPN, connectivity |
|
| 34 |
+
| Other | Miscellaneous |
|
| 35 |
+
| Printing | Printer and scanning |
|
| 36 |
+
| Security | Threats, breaches, security |
|
| 37 |
+
| Software | Application issues |
|
| 38 |
+
| Storage | OneDrive, SharePoint, drives |
|
| 39 |
+
|
| 40 |
+
## Training Details
|
| 41 |
+
|
| 42 |
+
- **Base Model**: DistilBERT (distilbert-base-uncased)
|
| 43 |
+
- **Training Data**: 5,760 IT support tickets
|
| 44 |
+
- **Loss Function**: Focal Loss (for class imbalance)
|
| 45 |
+
- **Framework**: PyTorch + Transformers
|
| 46 |
+
|
| 47 |
+
## Usage
|
| 48 |
+
|
| 49 |
+
```python
|
| 50 |
+
from huggingface_hub import hf_hub_download
|
| 51 |
+
import torch
|
| 52 |
+
|
| 53 |
+
# Download model
|
| 54 |
+
model_path = hf_hub_download(
|
| 55 |
+
repo_id="YOUR_USERNAME/ticket-classifier",
|
| 56 |
+
filename="ticket_classifier.pt"
|
| 57 |
+
)
|
| 58 |
+
|
| 59 |
+
# Load model
|
| 60 |
+
checkpoint = torch.load(model_path, map_location="cpu")
|
| 61 |
+
```
|
| 62 |
+
|
| 63 |
+
## Performance
|
| 64 |
+
|
| 65 |
+
Achieves 85%+ macro F1 score across 12 categories.
|
| 66 |
+
|
| 67 |
+
## License
|
| 68 |
+
|
| 69 |
+
MIT
|