Home/Data & Retrieval/evidentiality_qa
evidentiality_qa logo

evidentiality_qa

AkariAsai/evidentiality_qa

Evidentiality-guided Generator for Knowledge-Intensive NLP Tasks

GraphCanon updated 2w · GitHub synced 2w

44 stars0 forksLast push 3y Python MIT

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
PyPI

Similar 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.

Python runtimePython

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.zip includes 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.zip includes 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:

  1. Training a base Fusion-in-Decoder model (base generator)
  2. Run leave-one-out generation approach to collect training data for evidentiality labeling model (M) using the base generator.
  3. Train M using data from step 2.
  4. Run M on all of the passages included in training data for a evidentiality-guided generator to obtain silver evidentiality labels.
  5. 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.

Was this helpful?

Anonymous feedback helps us improve pages and translations.