Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pengbaolin/SC-GPT
Few-shot Natural Language Generation for Task-Oriented Dialog
https://github.com/pengbaolin/SC-GPT
Last synced: 2 days ago
JSON representation
Few-shot Natural Language Generation for Task-Oriented Dialog
- Host: GitHub
- URL: https://github.com/pengbaolin/SC-GPT
- Owner: pengbaolin
- Created: 2020-02-27T04:09:49.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-11-21T22:47:17.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T13:27:11.232Z (3 months ago)
- Language: Python
- Homepage: https://aka.ms/scgpt
- Size: 397 KB
- Stars: 189
- Watchers: 8
- Forks: 31
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Few-shot Natural Language Generation for Task-Oriented Dialog
This repository contains the dataset, source code and trained model for the following paper:
[Few-shot Natural Language Generation for Task-Oriented Dialog](https://arxiv.org/abs/2002.12328)
Baolin Peng, Chenguang Zhu, Chunyuan Li, Xiujun Li, Jinchao Li, Michael Zeng and Jianfeng Gao
ArXiv paper: [https://arxiv.org/abs/2002.12328](https://arxiv.org/abs/2002.12328)
This repository is based on hugginface transformer package and OpenAI GPT-2, containing model training code and pretrained medium model checkpoint. Some evaluation scripts are adapted from [RNNLG]([https://github.com/shawnwun/RNNLG](https://github.com/shawnwun/RNNLG)). The results indicate that with minimal training examples, SC-GPT is able to generate natural language response given dialog acts naturally and adequately. It can be used to train an NLG model in new domains with very limited examples.
The include scripts can be used to reproduce the results reported in the paper.
Project and demo webpage: [https://aka.ms/scgpt](https://aka.ms/scgpt)
## Dataset: FewShotWoz
*FewShotWoz* is constructed using dataset from RNNLG and MultiWoz.
**Data files includes**
{domain}/train.json: training set in json format used for evaluation, other package like RNNLG also need this format.
{domain}/train.txt: linearized training set for GPT-2 models.
{domain}/test.json: testing set in json format.
{domain}/test.txt: linearized testing set for GPT-2 models.
**Data format**
```json
[
"inform(name='hakka restaurant';pricerange=moderate)",
"hakka restaurant is moderate -ly priced",
"hakka restaurant is moderate -ly priced"
]
First item: dialog act
Second item: corresponding natural language description
Thrid item: repeated for evaluation script
Linearized as:
inform ( name = hakka restaurant ; pricerange = moderate ) & hakka restaurant is moderate -ly priced
```
## Pipeline
*The code is still under cleanup. More details of code usage will be added soon*
**Setup**
Please use the below command to clone and install the requirements.
```bash
git clone https://github.com/pengbaolin/SC-GPT.git
cd SC-GPT
pip install -r requirements.txt
```
Fetch and unzip the checkpoint
```bash
wget https://bapengstorage.blob.core.windows.net/fileshare/scgpt.tar.gz
tar -xvf scgpt.tar.gz
```
**Training**
```bash
export CUDA_VISIBLE_DEVICES=0
python train.py --output_dir=MODEL_SAVE_PATH --model_type=gpt2 --model_name_or_path=PRE_TRINED_MODEL_PATH --do_train --do_eval --eval_data_file=data/restaurant/train.txt --per_gpu_train_batch_size 1 --num_train_epochs EPOCH --learning_rate LR --overwrite_cache --use_tokenize --train_data_file=data/restaurant/train.txt --overwrite_output_dir
```
MODEL_SAVE_PATH : Path of the saving model .
PRE_TRAINED_MODEL_PATH : Initial checkpoint; Could start from gpt2, gpt2-meidum or our provided scgpt folder.
EPOCH : Number of training epochs; 5 is enough for a reasonable performance
LR : Learning rate; 5e-5, 1e-5, or 1e-4
**Decoding**
```bash
export CUDA_VISIBLE_DEVICES=0
python generate.py --model_type=gpt2 --model_name_or_path=MODEL_SAVE_PATH --num_samples 5 --input_file=data/restaurant/test.txt --top_k 5 --output_file=results.json --length 80
```
**Evaluate**
```bash
python evaluator.py --domain restaurant results.json
```
*script for attraction/train/taxi will be provided soon*
**Interact**
```
python interact.py --model_type=gpt2 --model_name_or_path=MODEL_SAVE_PATH --length 50 --num_samples 5
```
## Try our demo
The live demo is at [https://aka.ms/scgpt](https://aka.ms/scgpt). Please refer the examples on top to input dialog acts.
## Disclaimer
This repository aims to facilitate research in large-scale pretraining for NLG in the context of dialog systems. This toolkit contains only part of the modeling machinery needed to actually produce a model weight file in a running dialog. On its own, this model provides only information about the weights of various text spans; in order for a researcher to actually use it, they will need to bring conversational data of their own and decode the response generation from the pretrained system. Microsoft is not responsible for any generation from the 3rd party utilization of the pretrained system.
## Citation
if you use this code and data in your research, please cite our arxiv paper:
```
@misc{peng2020scgpt,
title={Few-shot Natural Language Generation for Task-Oriented Dialog},
author={Baolin Peng, Chenguang Zhu, Chunyuan Li, Xiujun Li, Jinchao Li, Michael Zeng, Jianfeng Gao},
archivePrefix={arXiv},
year={2020},
eprint={2002.12328},
primaryClass={cs.CL}
}
```