Update README.md
Browse files
README.md
CHANGED
|
@@ -17,7 +17,7 @@ A machine learning model for classifying banking customer-support messages into
|
|
| 17 |
|
| 18 |
This project demonstrates a complete machine-learning workflow, including dataset inspection, data cleaning, train/validation/test splitting, model training, evaluation, error analysis, and prediction.
|
| 19 |
|
| 20 |
-
##
|
| 21 |
|
| 22 |
Customer-support systems receive a large number of messages every day. Automatically identifying the intent behind each message can help route customer queries to the correct support workflow.
|
| 23 |
|
|
@@ -53,7 +53,7 @@ cancel_transfer
|
|
| 53 |
|
| 54 |
---
|
| 55 |
|
| 56 |
-
##
|
| 57 |
|
| 58 |
**Text Classification / Customer Intent Classification**
|
| 59 |
|
|
@@ -69,7 +69,7 @@ One of 77 predefined banking customer-support intents.
|
|
| 69 |
|
| 70 |
---
|
| 71 |
|
| 72 |
-
##
|
| 73 |
|
| 74 |
The model was trained using the **Banking77** dataset.
|
| 75 |
|
|
@@ -97,7 +97,7 @@ Final Test Evaluation
|
|
| 97 |
|
| 98 |
---
|
| 99 |
|
| 100 |
-
##
|
| 101 |
|
| 102 |
The trained model is a **scikit-learn text-classification model** saved using `joblib`.
|
| 103 |
|
|
@@ -129,7 +129,7 @@ Expected output:
|
|
| 129 |
|
| 130 |
---
|
| 131 |
|
| 132 |
-
##
|
| 133 |
|
| 134 |
The model was evaluated using separate validation and test datasets.
|
| 135 |
|
|
@@ -173,7 +173,7 @@ The final test evaluation was performed on data that was not used during model t
|
|
| 173 |
|
| 174 |
---
|
| 175 |
|
| 176 |
-
##
|
| 177 |
|
| 178 |
Error analysis was performed on the validation dataset to understand where the model makes incorrect predictions.
|
| 179 |
|
|
@@ -207,7 +207,7 @@ reports/validation_predictions.csv
|
|
| 207 |
|
| 208 |
---
|
| 209 |
|
| 210 |
-
##
|
| 211 |
|
| 212 |
The model supports 77 banking customer-support intents, including:
|
| 213 |
|
|
@@ -293,7 +293,7 @@ wrong_exchange_rate_for_cash_withdrawal
|
|
| 293 |
|
| 294 |
---
|
| 295 |
|
| 296 |
-
##
|
| 297 |
|
| 298 |
The complete project contains:
|
| 299 |
|
|
@@ -311,7 +311,7 @@ The complete project contains:
|
|
| 311 |
|
| 312 |
---
|
| 313 |
|
| 314 |
-
##
|
| 315 |
|
| 316 |
```text
|
| 317 |
customer-support-annotation/
|
|
@@ -351,7 +351,7 @@ customer-support-annotation/
|
|
| 351 |
|
| 352 |
---
|
| 353 |
|
| 354 |
-
##
|
| 355 |
|
| 356 |
The project includes an interactive prediction script.
|
| 357 |
|
|
@@ -373,7 +373,7 @@ Predicted Intent: card_arrival
|
|
| 373 |
|
| 374 |
---
|
| 375 |
|
| 376 |
-
##
|
| 377 |
|
| 378 |
The model is also integrated into a web application that allows users to enter customer-support messages and receive predicted intents.
|
| 379 |
|
|
@@ -387,7 +387,7 @@ Add your Streamlit application URL here.
|
|
| 387 |
|
| 388 |
---
|
| 389 |
|
| 390 |
-
##
|
| 391 |
|
| 392 |
Clone the project:
|
| 393 |
|
|
@@ -410,7 +410,7 @@ python scripts/predict.py
|
|
| 410 |
|
| 411 |
---
|
| 412 |
|
| 413 |
-
##
|
| 414 |
|
| 415 |
The complete source code, training scripts, evaluation scripts, dataset-processing pipeline, and application code are available on GitHub.
|
| 416 |
|
|
@@ -420,7 +420,7 @@ https://github.com/princechouhan3/customer-support-ai
|
|
| 420 |
|
| 421 |
---
|
| 422 |
|
| 423 |
-
##
|
| 424 |
|
| 425 |
This type of intent-classification model can be used as a component of:
|
| 426 |
|
|
@@ -436,7 +436,7 @@ The model itself is a classification component and can be integrated into a larg
|
|
| 436 |
|
| 437 |
---
|
| 438 |
|
| 439 |
-
##
|
| 440 |
|
| 441 |
This model was trained and evaluated using the Banking77 dataset.
|
| 442 |
|
|
@@ -456,7 +456,7 @@ The model is intended primarily as a machine-learning project and portfolio demo
|
|
| 456 |
|
| 457 |
---
|
| 458 |
|
| 459 |
-
##
|
| 460 |
|
| 461 |
Possible future improvements include:
|
| 462 |
|
|
@@ -473,7 +473,7 @@ Possible future improvements include:
|
|
| 473 |
|
| 474 |
---
|
| 475 |
|
| 476 |
-
##
|
| 477 |
|
| 478 |
**Customer Support AI β Banking Intent Classification**
|
| 479 |
|
|
@@ -481,6 +481,6 @@ This project demonstrates an end-to-end machine-learning workflow from raw custo
|
|
| 481 |
|
| 482 |
---
|
| 483 |
|
| 484 |
-
##
|
| 485 |
|
| 486 |
This project is released under the MIT License.
|
|
|
|
| 17 |
|
| 18 |
This project demonstrates a complete machine-learning workflow, including dataset inspection, data cleaning, train/validation/test splitting, model training, evaluation, error analysis, and prediction.
|
| 19 |
|
| 20 |
+
## Project Overview
|
| 21 |
|
| 22 |
Customer-support systems receive a large number of messages every day. Automatically identifying the intent behind each message can help route customer queries to the correct support workflow.
|
| 23 |
|
|
|
|
| 53 |
|
| 54 |
---
|
| 55 |
|
| 56 |
+
## Task
|
| 57 |
|
| 58 |
**Text Classification / Customer Intent Classification**
|
| 59 |
|
|
|
|
| 69 |
|
| 70 |
---
|
| 71 |
|
| 72 |
+
## Dataset
|
| 73 |
|
| 74 |
The model was trained using the **Banking77** dataset.
|
| 75 |
|
|
|
|
| 97 |
|
| 98 |
---
|
| 99 |
|
| 100 |
+
## Model
|
| 101 |
|
| 102 |
The trained model is a **scikit-learn text-classification model** saved using `joblib`.
|
| 103 |
|
|
|
|
| 129 |
|
| 130 |
---
|
| 131 |
|
| 132 |
+
## Model Performance
|
| 133 |
|
| 134 |
The model was evaluated using separate validation and test datasets.
|
| 135 |
|
|
|
|
| 173 |
|
| 174 |
---
|
| 175 |
|
| 176 |
+
## Error Analysis
|
| 177 |
|
| 178 |
Error analysis was performed on the validation dataset to understand where the model makes incorrect predictions.
|
| 179 |
|
|
|
|
| 207 |
|
| 208 |
---
|
| 209 |
|
| 210 |
+
## Supported Intent Categories
|
| 211 |
|
| 212 |
The model supports 77 banking customer-support intents, including:
|
| 213 |
|
|
|
|
| 293 |
|
| 294 |
---
|
| 295 |
|
| 296 |
+
## Project Features
|
| 297 |
|
| 298 |
The complete project contains:
|
| 299 |
|
|
|
|
| 311 |
|
| 312 |
---
|
| 313 |
|
| 314 |
+
## Project Structure
|
| 315 |
|
| 316 |
```text
|
| 317 |
customer-support-annotation/
|
|
|
|
| 351 |
|
| 352 |
---
|
| 353 |
|
| 354 |
+
## Interactive Prediction
|
| 355 |
|
| 356 |
The project includes an interactive prediction script.
|
| 357 |
|
|
|
|
| 373 |
|
| 374 |
---
|
| 375 |
|
| 376 |
+
## Live Demo
|
| 377 |
|
| 378 |
The model is also integrated into a web application that allows users to enter customer-support messages and receive predicted intents.
|
| 379 |
|
|
|
|
| 387 |
|
| 388 |
---
|
| 389 |
|
| 390 |
+
## Installation
|
| 391 |
|
| 392 |
Clone the project:
|
| 393 |
|
|
|
|
| 410 |
|
| 411 |
---
|
| 412 |
|
| 413 |
+
## Source Code
|
| 414 |
|
| 415 |
The complete source code, training scripts, evaluation scripts, dataset-processing pipeline, and application code are available on GitHub.
|
| 416 |
|
|
|
|
| 420 |
|
| 421 |
---
|
| 422 |
|
| 423 |
+
## Potential Applications
|
| 424 |
|
| 425 |
This type of intent-classification model can be used as a component of:
|
| 426 |
|
|
|
|
| 436 |
|
| 437 |
---
|
| 438 |
|
| 439 |
+
## Limitations
|
| 440 |
|
| 441 |
This model was trained and evaluated using the Banking77 dataset.
|
| 442 |
|
|
|
|
| 456 |
|
| 457 |
---
|
| 458 |
|
| 459 |
+
## Future Improvements
|
| 460 |
|
| 461 |
Possible future improvements include:
|
| 462 |
|
|
|
|
| 473 |
|
| 474 |
---
|
| 475 |
|
| 476 |
+
## Project
|
| 477 |
|
| 478 |
**Customer Support AI β Banking Intent Classification**
|
| 479 |
|
|
|
|
| 481 |
|
| 482 |
---
|
| 483 |
|
| 484 |
+
## License
|
| 485 |
|
| 486 |
This project is released under the MIT License.
|