Skip to main content
Version: 0.20.x

JSON/Regex Structured Inference

Takeoff allows you to generate outputs which match a given regular expression or JSON Schema. This lets you output data with a consistent format, adhering to any type requirements.

Using Regex​

To constrain the output to follow a given regex, use the regex_string parameter. Use of an invalid regex string will raise an error in the terminal.

Example Regex Command & Outputs
  curl -X 'POST'
  'http://localhost:3000/generate'
  -H 'accept: application/json'
  -H 'Content-Type: application/json'
  -d '{
  "consumer_group": "primary",
  "max_new_tokens": 300,
  "regex_string": "[+-]?([0-9]*[.])?[0-9]+",
  "sampling_temperature": 0.9,
  "sampling_topk": 10,
  "sampling_topp": 0.9,
  "text": "The value of pi is "
}

Outputs:

Without RegexWith Regex
$$\pi = \frac{223.14159265
caution

Regex support is driven by interegular which supports most (but not all) of the regex specification. See the interegular docs.

Using JSON​

  • To generate JSON output, first define the required structure of your output in terms of a JSON Schema. An easy way to do this is to use Pydantic and its inbuilt converter.
  • Pass the outputted schema as json with the json_schema parameter.
Example Pydantic Model, JSON Schema & Output

This example is designed to extract information about Zagreb, Croatia.

import json
from enum import Enum
from typing import List
from pydantic import BaseModel, Field 

class Country(BaseModel):
    name: str   

class Schema(BaseModel):
    country: Country
    dasl: int = Field(alias='M above sea level')
    city_districts: List[str] = Field(alias='Example districts in city')
    population: int = Field(alias='Total Population of city')
    dimensions: List[int] = Field(alias='Dimensions of city in miles')
    mayor: str = Field(alias='First mayor')    

print(json.dumps(Schema.model_json_schema()))
# Ensure the 'takeoff_client' package is installed
# To install it, use the command: `pip install takeoff_client`
from takeoff_client import TakeoffClient

from typing import List
from pydantic import BaseModel, Field 

class Country(BaseModel):
    name: str   

class Schema(BaseModel):
    country: Country
    dasl: int = Field(alias='M above sea level')
    city_districts: List[str] = Field(alias='Example districts in city')
    population: int = Field(alias='Total Population of city')
    dimensions: List[int] = Field(alias='Dimensions of city in miles')
    mayor: str = Field(alias='First mayor')    


client = TakeoffClient(base_url="http://localhost", port=3000)
input_text = """<Information about Zagreb>

Extract the required information about Zagreb."""

generated_text = client.generate(input_text,
                                 json_schema = Schema.schema_json(),
                                sampling_temperature=0.1)
print(generated_text)

  • When using the GUI, only syntactically valid JSON can be submitted. This does not check whether the input is valid Json Schema. You can use a tool like this to check, but currently the best way to ensure success is to create the schema via pydantic.
caution

The entire JSON Schema specification is not yet supported in Takeoff or by Pydantic. The majority of features expressible in Pydantic are available for use with Takeoff, but key exceptions include:

  • Field attributes other than min_length/max_length.
  • Tuples - Use lists with bounded lengths instead.

See more on the differences between the Pydantic specification and JSON Schema here.

Tips​

  • Since the keys in the JSON schema come right before the generated tokens, you can add extra context or units. For example, use "Height in CM".
  • If fields are not marked as required, they are often ignored even if they should be generated. Ensure important fields are marked as required.
  • The order of keys in a JSON schema cannot be fixed for performance reasons. You should reorder them in post-processing.
  • JSON and Regex cannot be used together. If both are submitted, only the Regex will be used and a warning will appear in the terminal.
  • Performance can be highly sensitive to the tokens at the end of the prompt. If results are unexpected, try adding or removing a space or newline at the end of your prompt.
  • To improve performance, guide the model to follow the format by adding instructions like "Output the answer as a list of 5 items" or "Output the values for each required item".

Supported Models & Backends​

Structured inference is supported on all causal models (e.g. not BART).