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. python academy academy/topics/signature-semantic-contract website/content-src/academy/course.mjs academy Give every AI call a clear contract
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
Unit example (nearest native match)

See the idea in context

from axllm import ai, ax

qa = ax('question:string -> answer:string, confidence: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
pip install axllm

from axllm import ai, ax

llm = ai('openai', api_key=os.environ['OPENAI_API_KEY'])
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 -- python src/examples/python/generation/structured.py
Active practice

Show that you can use it

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

Source-backed follow-up