evidentiality_qa
Evidentiality-guided Generator for Knowledge-Intensive NLP Tasks
GraphCanon updated 2w · GitHub synced 2w
Decision brief
Evidentiality-guided Generator for enhancing knowledge-intensive NLP tasks using multi-task learning.
Good fit when
- When aiming to improve performance in open question answering, fact verification, or knowledge-enhanced dialogue with retrieval-augmented methods.
- For applications requiring high accuracy and reliability where supporting evidence from passages is critical.
Avoid when
- In tasks that do not benefit from passage evidentiality considerations such as free-form text generation without factual reliance.
- When working with datasets for which silver evidentiality labels cannot be generated using the provided methodology.
Observed Jul 12, 2026 · Source: enrich:decision_facts
Verify the decision
Maintenance and security
Full trust report- Maintenance
- Dormant (1314d since push)
- As of 2w
- Provenance
- Not a fork · Personal account
- As of 2w
- Security (OSV)
- No lockfile
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
pip install evidentiality_qa PyPISimilar tools
Same-category neighbours. No typed graph edges are catalogued for this tool yet.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
Implementation of evidentiality-guided generator model incorporating passage evidentiality into training via multi-task learning. Aims at improving tasks like open question answering, fact verification, and knowledge-enhanced dialogue.
Capability facts
- Languages
- python
Source: github.language · Aug 1, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Aug 1, 2026)
CUDA_VISIBLE_DEVICES=0 python test_reader.py \Source link
Tags
README
Evidentiality-guided Generator
This is the official implementation of the following paper: Akari Asai, Matt Gardner and Hannaneh Hajishirzi. Evidentiality-guided Generation for Knowledge-Intensive NLP Tasks. In Proc. NAACL. 2021.
In this paper, we introduce Evidentiality-guided Generator, which incorporates evidentiality of passages---whether a passage contains correct evidence to support the output---into training the generator via multi-task learning of answer generation and evidentiality prediction for retrieval-augmented generation. Experimental results show large improvements across three knowledge intensive tasks: open question answering, fact verification and knowledge-enhanced dialogue.
Directories
-
evi_gen: codes for our evidentiality-guided generator model. The implementation is built upon Fusion-in-Decoder (Izacard and Grave, 2020). -
mining: code for our evidentiality labeling model used to obtain silver evidentiality data.
Please see the training and evaluation details in each directories.
Data and Models
Retrieved data (train / dev / test )
We release the DPR retrieved results and the results with our silver evidentiality labels. All of the data can be downloaded from here.
evidentiality_dpr.zipincludes the retrieval results with our newly mined silver evidentiality labels for train sets for each target dataset. For each query, we include top 20 passages.eval_dpr.zipincludes the retrieval results for dev / test sets for each target dataset.
Fine-tuned models
You can download the fine-tuned models from the google drive repositories.
Evaluations
To reproduce the original results, you can go to evi_gen directory and then run the command below:
CUDA_VISIBLE_DEVICES=0 python test_reader.py \
--model_path model/nq_ours \
--eval_data data/nq_test.json \
--per_gpu_batch_size 48 \
--n_context 20 \
--name sanity_nq_test \
--checkpoint_dir checkpoint \
--n_gpus 1 \
--write_results
For WoW, please set the --metric f1
Training
Overview of Training
Our evidentiality-guided generator will conduct a multi-task learning of evidentiality prediction and generation.
To supervised this learning, we need to obtain silver evidentiality data.
Our training procedures are as follows:
- Training a base Fusion-in-Decoder model (base generator)
- Run leave-one-out generation approach to collect training data for evidentiality labeling model (M) using the base generator.
- Train M using data from step 2.
- Run M on all of the passages included in training data for a evidentiality-guided generator to obtain silver evidentiality labels.
- Train the evidentiality-guided generator with the multi-task loss.
See more detailed instructions in the evi_gen and mining directories.
Training our evidentiality generator
If you want to quickly start training our evidentiality-guided generator, we provide the resulting training data here.
To train our evide
For agents
This page has a .md twin and JSON over the API.