Skip to main content
Extractive question answering or answer extraction is the process of extracting answers to questions from documents, for example, “what is the governing law of this contract?” or “who is the defendant in this case?”. Extractive QA can be used to solve a diverse range of information extraction problems whether it’s as simple as pulling out key dates from a contract or as complex as highlighting legal doctrines relied upon in a judgment. Because answers are taken directly and exclusively from users’ inputs, extractive QA can often prove faster, more precise and more cost-effective than generative QA. Isaacus offers two extractive QA models, Kanon Answer Extractor and Kanon Answer Extractor Mini, available through our extractive QA endpoint.

​
Usage

Our extractive QA endpoint accepts a question and one or more documents and returns answers to the question extracted from the documents. If our answer extractors do not think that there is an answer to the question that can be extracted from any of the documents, it will not return any answers. You can override that behavior by setting the ignore_inextractability parameter to true, which you will want to do if you are already using one of our reranking models to identify documents that answer questions. The code snippet below demonstrates how you could use our extractive QA endpoint to extract the governing law of a contract (please consult our quickstart guide first if you haven’t set up your Isaacus account and API client). 
from isaacus import Isaacus

# Create an Isaacus API client.
client = Isaacus(api_key="PASTE_YOUR_API_KEY_HERE")

# Download the GitHub terms of service as an example.
tos = client.get(path="https://examples.isaacus.com/github-tos.md", cast_to=str)

# Extract the governing law of the contract.
response = client.extractions.qa.create(
    model="kanon-answer-extractor",
    query="What is the governing law of this agreement?",
    texts=[tos],
)

# Unpack the results.
extraction = response.extractions[0]
answer = extraction.answers[0]

# Print the answer.
print(f'Governing law of the contract: {answer.text} (confidence: {answer.score:.2%})')
After running the code snippet above, you should then end up with the following output: 
Governing law of the contract: the federal laws of the United States of 
America and the laws of the State of California (confidence: 74.76%)
⌘I