Language ReferenceGeneral BAML Syntax

int / float

Numerical values as denoted more specifically in BAML.

ValueDescription
intInteger
floatFloating point number

We support implicit casting of int -> float, but if you need something to explicitly be a float, use 0.0 instead of 0.

Usage

function DescribeCircle(radius: int | float, pi: float?) -> string {
    client "openai/gpt-5-mini"
    prompt #"
        Describe a circle with a radius of {{ radius }} units.
        Include the area of the circle using pi as {{ pi or 3.14159 }}.
        
        What are some properties of the circle?
    "#
}
test CircleDescription {
    functions [DescribeCircle]
    // will be cast to int
    args { radius 5 }
}
test CircleDescription2 {
    functions [DescribeCircle]
    // will be cast to float
    args { 
        radius 5.0 
        pi 3.14
    }
}