ax() API

Structured generation APIs for typed programs.

Most Used

`Ax.ax`

Create an AxGen program from a string or parsed signature.

Field	Value
Kind	`function`
Ax concept	`ax`
API section	AxGen
Form	`Ax.ax(signature)`
Returns	AxGen

Important Options

functions
examples
demos
sample count
result picker
modelConfig
maxRetries
streaming assertions
field processors
control
asyncMode

Examples

Java

AxGen qa = Ax.ax("question:string -> answer:string");

Full reference

`AxGen`

Structured generation program with indexed multi-sampling, winner selection, forward, streaming, optimization, trace, usage, and tool-call behavior.

Field	Value
Kind	`type`
Ax concept	`AxGen`
API section	AxGen
Form	`new AxGen(signature)`
Returns	program object

Important Options

signature
functions
examples
demos
sample count
result picker
memory
prompt template

Full reference

`Ax.fn`

Build a typed function tool. Rust uses tool because fn is reserved.

Field	Value
Kind	`function`
Ax concept	`fn`
API section	Tools
Form	`Ax.fn(name).description(...).arg(...).handler(...).build()`
Returns	tool builder or Tool

Important Options

name
description
args
returns
handler
execution: blocking or background
cancellation-aware handler

Examples

Java

Tool search = Ax.fn("search").description("Search docs").build();

Full reference

Advanced / internals / full reference

`Ax.runControl`

Create a controller for scoped steering, reasoning updates, cancellation, and queued/applied lifecycle events. Pass it through forward options.

Field	Value
Kind	`function`
Ax concept	`run_control`
API section	AxGen
Form	`Ax.runControl()`
Returns	AxRunControl

Examples

Java

var control = Ax.runControl();

Full reference

`AxRunControl`

Run control shared by active and future descendant programs. Cancellation reports unresolved work and does not undo external effects.

Field	Value
Kind	`type`
Ax concept	`AxRunControl`
API section	AxGen
Form	`AxRunControl`
Returns	run controller

Important Options

steer
thinking token budget
target path
abort
event listener

Full reference

`AxCachingFunction`

TypeScript’s cachingFunction: read and store finished AxGen outputs by key. The forward call’s function comes first, then the program’s, then the process-wide one, and a run control skips the cache.

Field	Value
Kind	`type`
Ax concept	`AxCachingFunction`
API section	AxGen
Form	`Map<String, Object> apply(String key, Map<String, Object> value)`
Returns	stored output or miss

Important Options

read
store
SHA-256 key
streamed hit as one delta

Examples

Java

AxGen qa = new AxGen(Ax.s("question:string -> answer:string"), Map.of("cachingFunction", cache));

Full reference

`AxGlobals.setCachingFunction`

Field	Value
Kind	`function`
Ax concept	`set_caching_function`
API section	AxGen
Form	`AxGlobals.setCachingFunction(fn)`
Returns	void

Important Options

caching function
clear

Examples

Java

AxGlobals.setCachingFunction(cache);

Full reference

`Tool`

Callable tool descriptor with JSON-schema-compatible parameters and a host handler.

Field	Value
Kind	`type`
Ax concept	`Tool`
API section	Tools
Form	`Tool`
Returns	tool descriptor

Important Options

parameters
returns
handler

Full reference

Full Reference

Open the full Java reference. This page highlights the ax symbols most relevant to everyday use.