Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.isaacus.com/llms.txt

Use this file to discover all available pages before exploring further.

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 the Kanon Answer Extractor extractive QA model, available through our extractive QA endpoint. For a complete specification of the parameters and response format of our extractive QA endpoint, please refer to the API reference documentation.

​
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). 
import httpx # NOTE `httpx` is already a dependency of `isaacus`.

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 = httpx.get("https://examples.isaacus.com/github-tos.md").text

# 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%)