Reuse the same contract everywhere You keep a field’s meaning stable as it moves through generators, tools, flows, agents, and events. That makes composed systems easier to validate and evaluate. cpp academy academy/topics/typed-contracts-everywhere website/content-src/academy/course.mjs academy Reuse the same contract everywhere
Unit 2 · Make AI outputs predictable

Reuse the same contract everywhere

You keep a field’s meaning stable as it moves through generators, tools, flows, agents, and events. That makes composed systems easier to validate and evaluate.

6 focused minutesNot started
Unit example (nearest native match)

See the idea in context

auto sig = axllm::s("email:string -> priority:class \"high, normal, low\"");
  1. Name the capability

    lookup gives the model and traces a stable tool name.

  2. Type the boundary

    ticketId and the JSON result use the same field vocabulary as Ax programs.

  3. Keep execution in your app

    The handler owns the real lookup and returns the declared result.

Run itIn your own project
include(FetchContent)
FetchContent_Declare(axllm GIT_REPOSITORY https://github.com/ax-llm/ax GIT_TAG main SOURCE_SUBDIR packages/cpp)
FetchContent_MakeAvailable(axllm)
target_link_libraries(your_app PRIVATE axllm::axllm)

#include <axllm/axllm.hpp>

auto llm = axllm::ai("openai", axllm::object({{"apiKey", std::getenv("OPENAI_API_KEY")}}));
auto classify = axllm::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 -- cpp src/examples/cpp/generation/structured_generation.cpp
Active practice

Show that you can use it

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

Source-backed follow-up