https://github.com/amazon-science/hr-multiwoz-tod-llm-agent

https://github.com/amazon-science/hr-multiwoz-tod-llm-agent

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary

Keywords from Contributors

generic embedded controllers interactive simulations transformers projection sequences archival observability
Last synced: 10 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: amazon-science
  • License: apache-2.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 508 KB
Statistics
  • Stars: 15
  • Watchers: 3
  • Forks: 5
  • Open Issues: 3
  • Releases: 0
Created over 2 years ago · Last pushed about 1 year ago
Metadata Files
Readme Contributing License Code of conduct

README.md

HR-MultiWOZ: A Task Oriented Dialogue (TOD) Dataset for HR LLM Agent

This repository hosts the data generation recipe and benchmarking of HR-MultiWOZ: A Task Oriented Dialogue (TOD) Dataset for HR LLM Agent. This paper is accepted by EACL NLP4HR workshop as presentations.

Introduction

HR-Multiwoz is a fully-labeled dataset of 550 conversations spanning 10 HR domains to evaluate LLM Agent. It is the first labeled open-sourced conversation dataset in the HR domain for NLP research. In this repo we provides a detailed recipe for the data generation procedure described in the paper along with data analysis and human evaluations. The data generation pipeline is transferable and can be easily adapted for labeled conversation data generation in other domains. The proposed data-collection pipeline is mostly based on LLMs with minimal human involvement for annotation, which is time and cost-efficient.

Requirements

Install all required python dependencies:

pip install -r requirements.txt

Citation

@misc{xu2024hrmultiwoz, title={HR-MultiWOZ: A Task Oriented Dialogue (TOD) Dataset for HR LLM Agent}, author={Weijie Xu and Zicheng Huang and Wenxiang Hu and Xi Fang and Rajesh Kumar Cherukuri and Naumaan Nayyar and Lorenzo Malandri and Srinivasan H. Sengamedu}, year={2024}, eprint={2402.01018}, archivePrefix={arXiv}, primaryClass={cs.CL} }

Data

!Please note that the dataset is an independent reimplementation of our methods. It is not release by Amazon.

All dataset is under Data folder.

sgddataset.pkl: This is the schema guided dataset. https://huggingface.co/datasets/xwjzds/hrmultiwoztodsgd

template.pkl: This is the place where you can access the question for each entity.

qadataset.pkl: This is the place where you can get question, context and extractive answers. https://huggingface.co/datasets/xwjzds/extractiveqaquestionanswering_hr

Flow

The workflow of the paper

:trophy: TOD Benchmarks

| JAG | slot accuracy | Method | |--------|-----------------|-------------------------------| | 18.89 | 55.61 | TransferQA with Deberta[11] | | 8.65 | 26.62 | TransferQA with Bert[11] |

Since most of multiwoz dataset is from other domain and is hard to do transfer learning, we can only implement our own baseline. The baseline is inspired by [11] and we select 2 best performing models from below as our base language model. Check leadership/tod_benchmark.py for our implementation.

As you can see, the performance is still really bad. This means that existed SGD method may not be able to transfer to do transfer learning in our use case.

You can follow leaderboard/tod_benchmark.py to benchmark you own methods.

You can also benchmark any question answering model from huggingface using the following code: python3 leaderboard/qa_benchmark_evaluation.py --name [adding model name] --threshold [adding threshold between 0 and 1 to define the confidence]

:trophy: Extractive QA Benchmarks

| F1 | Exact Match | BLEU | Method | |-------|-------------|---------|-------------------------------| |0.786 | 0.598 | 0.174 | bert-large-fintuned-squad [10] | |0.721 | 0.519 | 0.168 | distilbert-base [9] | |0.710 | 0.000 | 0.217 | deberta-v3-large [7] | |0.642 | 0.000 | 0.140 | roberta-base-squad2 [3] | |0.588 | 0.000 | 0.134 | mdeberta-v3-base [8] | |0.045 | 0.000 | 0.011 | bert-base-uncased [1] | |0.047 | 0.000 | 0.010 | distilbert-base-uncased [2] | |0.050 | 0.000 | 0.011 | albert [4] | |0.050 | 0.001 | 0.011 | electra-small-discriminator [5] | |0.072 | 0.000 | 0.020 | xlnet-base [6] |

bert-large-uncased is finetuned through whole word masking on Squad dataset. This method achieves the best performance. https://huggingface.co/google-bert/bert-large-uncased-whole-word-masking-finetuned-squad

The code to benchmark your extractive QA method ``` import pickle import pandas as pd from leaderboard.metric import calculatef1score, calculateexactmatch, calculatebleu, calculaterouge, calculate_meteor

loading qa_dataset

with open('qa_dataset.pkl', 'rb') as f: data = pickle.load(f)

putting your predicted answer in data

data['predicted_answer'] = ...

benchmark

F1 = calculatef1score(evaluations['answer'], evaluations[method]) ExactMatch = calculateexactmatch(evaluations['answer'].tolist(), evaluations[method].tolist()) Bleu = calculatebleu(evaluations['answer'], evaluations[method])

```

Reference

[1] https://arxiv.org/abs/1810.04805

[2] https://arxiv.org/abs/1910.01108

[3] https://huggingface.co/deepset/roberta-base-squad2

[4] https://arxiv.org/abs/1909.11942

[5] https://openreview.net/pdf?id=r1xMH1BtvB

[6] https://proceedings.neurips.cc/paper_files/paper/2019/file/dc6a7e655d7e5840e66733e9ee67cc69-Paper.pdf

[7] https://arxiv.org/abs/2111.09543

[8] https://arxiv.org/abs/2111.09543

[9] https://arxiv.org/abs/1910.01108

[10] https://arxiv.org/abs/1810.04805

[11] https://arxiv.org/pdf/2109.04655.pdf

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

Owner

  • Name: Amazon Science
  • Login: amazon-science
  • Kind: organization

GitHub Events

Total
  • Issues event: 1
  • Watch event: 5
  • Delete event: 1
  • Issue comment event: 1
  • Pull request event: 4
  • Fork event: 2
  • Create event: 3
Last Year
  • Issues event: 1
  • Watch event: 5
  • Delete event: 1
  • Issue comment event: 1
  • Pull request event: 4
  • Fork event: 2
  • Create event: 3

Committers

Last synced: 12 months ago

All Time
  • Total Commits: 28
  • Total Committers: 6
  • Avg Commits per committer: 4.667
  • Development Distribution Score (DDS): 0.679
Past Year
  • Commits: 2
  • Committers: 1
  • Avg Commits per committer: 2.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
xuweijieshuai 9****i 9
Weijie Xu w****u@a****m 7
dependabot[bot] 4****] 6
Zicheng Huang z****g@a****m 4
Amazon GitHub Automation 5****o 1
Xiaoyu Jiang j****w@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 0
  • Total pull requests: 9
  • Average time to close issues: N/A
  • Average time to close pull requests: 22 days
  • Total issue authors: 0
  • Total pull request authors: 2
  • Average comments per issue: 0
  • Average comments per pull request: 0.11
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 8
Past Year
  • Issues: 0
  • Pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 3 months
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.33
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 3
Top Authors
Issue Authors
Pull Request Authors
  • dependabot[bot] (12)
  • xuweijieshuai (2)
  • rbedyakin (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (12) python (2)

Dependencies

requirements.txt pypi
  • nltk ==3.6
  • rouge-score ==0.1
  • torch ==1.11.0
  • transformers ==4.20.1