ax() API

Structured generation APIs for typed programs.

Most Used

`ax`

Create an AxGen program from a string or parsed signature.

Field	Value
Kind	`function`
Ax concept	`ax`
API section	AxGen
Form	`ax(spec: &str)`
Returns	AxResult

Important Options

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

Examples

Rust

let qa = 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	`AxGen`
Returns	program object

Important Options

signature
functions
examples
demos
sample count
result picker
memory
prompt template

Full reference

`tool`

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

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

Important Options

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

Examples

Rust

let search = tool("search").description("Search docs").build();

Full reference

Advanced / internals / full reference

`run_control`

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	`run_control()`
Returns	AxRunControl

Examples

Rust

let control = run_control();

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	`Arc<dyn Fn(&str, Option<&Value>) -> AxResult<Option<Value>> + Send + Sync>`
Returns	stored output or miss

Important Options

read
store
SHA-256 key
streamed hit as one delta

Examples

Rust

let qa = ax("question:string -> answer:string")?.with_caching_function(cache);

Full reference

`set_caching_function`

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

Important Options

caching function
clear

Examples

Rust

set_caching_function(Some(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 Rust reference. This page highlights the ax symbols most relevant to everyday use.