Give every AI call a clear contractYou use one signature vocabulary across generation, tools, agents, flows, and optimization. That shared meaning makes later Ax features easier to combine.rustacademyacademy/topics/signature-semantic-contractwebsite/content-src/academy/course.mjsacademyGive every AI call a clear contract
You use one signature vocabulary across generation, tools, agents, flows, and optimization. That shared meaning makes later Ax features easier to combine.
s()6 focused minutesNot started
Unit example (nearest native match)
See the idea in context
let qa = ax("question:string -> answer:string, confidence:number")?;
Separate input from output
The arrow puts message on the input side and the generated fields on the output side.
Use a class for fixed choices
category cannot drift beyond billing, technical, or other.
Reuse the parsed signature
s() creates a contract you can inspect, share, and compose.
Run itIn your own project
cargo add axllm
use axllm::{ai, ax};
use serde_json::json;
let llm = ai("openai", json!({"apiKey": std::env::var("OPENAI_API_KEY")?}))?;
let classify = ax("review:string -> sentiment:class \"positive, negative, neutral\"")?;
Set OPENAI_APIKEY in your environment before running provider-backed code.
In the ax repo
From a clone of the ax repo:
npm run example -- rust src/examples/rust/generation/structured_generation.rs