Give 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. typescript academy academy/topics/signature-semantic-contract website/content-src/academy/course.mjs academy Give every AI call a clear contract
ax
TypeScript @ax-llm/ax
TypeScript Python Java C++ Go Rust
Unit 1 · Build AI features you can measure

Give 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
Worked example

See the idea in context

const ticket = s('message:string -> category:class \"billing, technical, other\", urgency:number');
  1. Separate input from output

    The arrow puts message on the input side and the generated fields on the output side.

  2. Use a class for fixed choices

    category cannot drift beyond billing, technical, or other.

  3. Reuse the parsed signature

    s() creates a contract you can inspect, share, and compose.

Run itIn your own project
npm install @ax-llm/ax

import { ai, ax } from '@ax-llm/ax';

const llm = ai({ name: 'openai', apiKey: process.env.OPENAI_APIKEY! });
const classify = ax('review:string -> sentiment:class "positive, negative, neutral"');

const result = await classify.forward(llm, {
  review: 'Useful and boring in the best way.',
});

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 -- typescript src/examples/typescript/generation/structured.ts
Active practice

Show that you can use it

Answer 2 in a row to learn this · attempt 1
Keep exploring

Source-backed follow-up