Examples
Every C++ example here is runnable source under src/examples/cpp/ and calls a real provider API. The website and npm run example -- list are generated from each file’s ax-example header.
Groups
- Generation - 3 examples.
- Agents - 4 examples.
- Long-Horizon Agents - 5 examples.
- Flows - 3 examples.
- Audio - 3 examples.
- Optimization - 3 examples.
Generation
- C++ Typed Generation - Runs a small typed generation program against OpenAI. Run:
npm run example -- cpp src/examples/cpp/generation/basic_generation.cpp. - C++ Structured Extraction - Extracts structured fields and labels from support text with OpenAI. Run:
npm run example -- cpp src/examples/cpp/generation/structured_generation.cpp. - C++ Contextual Generation - Answers from supplied context and returns compact citations with OpenAI. Run:
npm run example -- cpp src/examples/cpp/generation/context_generation.cpp.
Agents
- C++ Grounded Support Agent - Answers a support question grounded in a handbook that is kept out of the model prompt via contextFields. Run:
npm run example -- cpp src/examples/cpp/short-agents/basic_agent.cpp. - C++ Incident Triage Agent - Triages a noisy incident report held in contextFields, using a lean contextPolicy to keep the raw log out of the prompt while it reasons. Run:
npm run example -- cpp src/examples/cpp/short-agents/tools_agent.cpp. - C++ Specialist Planner Agent - A specialist that plans a migration from a long brief held in contextFields, using a checkpointed contextPolicy and a runtime-output cap to stay compact. Run:
npm run example -- cpp src/examples/cpp/short-agents/handoff_agent.cpp. - C++ Multi-Model Panel - Fans one question across three providers (OpenAI, Gemini, Anthropic), then judges the candidates and synthesizes a single grounded answer. Run:
npm run example -- cpp src/examples/cpp/short-agents/model_panel.cpp.
Long-Horizon Agents
- C++ Incident Log Forensics (RLM) - Infers service architecture and root-cause findings from a huge CloudWatch export that never enters the prompt – held in contextFields and worked through the runtime under a lean contextPolicy. Run:
npm run example -- cpp src/examples/cpp/long-agents/incident_log_forensics.cpp. - C++ Codebase Q&A with a Peek Context Map - Answers several dependency questions over one large module index by building and reusing an evolving context map (the “peek” orientation cache), so later questions skip re-scanning the corpus. Run:
npm run example -- cpp src/examples/cpp/long-agents/codebase_peek_map.cpp. - C++ Data Analyst (Large Context + Tools) - Combines a large data dictionary held in contextFields with typed warehouse tools, so the agent answers business questions over a big dataset it never has to inline. Run:
npm run example -- cpp src/examples/cpp/long-agents/data_analyst_with_tools.cpp. - C++ Self-Improving Lab Agent - A many-tool agent that runs experiments, grades them against a rubric with an independent verifier, and distills verified rules into memory – iterating until the rubric passes. Run:
npm run example -- cpp src/examples/cpp/long-agents/self_improving_lab.cpp. - C++ Skills + Memory Ops Assistant - An on-call assistant that recalls past decisions from a memory store and loads the right runbook skill on demand, using the agent skills and memories subsystems. Run:
npm run example -- cpp src/examples/cpp/long-agents/skills_and_memory_assistant.cpp.
Flows
- C++ Sequential Flow - Runs a two-step Ax flow against OpenAI. Run:
npm run example -- cpp src/examples/cpp/flows/sequential_flow.cpp. - C++ Branching Flow - Routes a classification through follow-up flow logic backed by OpenAI. Run:
npm run example -- cpp src/examples/cpp/flows/branch_flow.cpp. - C++ Composed Flow - Composes multiple typed programs into one OpenAI-backed flow. Run:
npm run example -- cpp src/examples/cpp/flows/composed_flow.cpp.
Audio
- C++ Text To Speech - Generates speech audio through OpenAI. Run:
npm run example -- cpp src/examples/cpp/audio/speech_audio.cpp. - C++ Speech To Text - Transcribes a checked-in WAV file through OpenAI. Run:
npm run example -- cpp src/examples/cpp/audio/transcribe_audio.cpp. - C++ Audio Summary Pipeline - Transcribes audio and summarizes the transcript with an OpenAI-backed generator. Run:
npm run example -- cpp src/examples/cpp/audio/pipeline_audio.cpp.
Optimization
- C++ AxGen Optimization - Runs a baseline OpenAI prediction and applies an optimizer artifact. Run:
npm run example -- cpp src/examples/cpp/optimization/axgen_optimization.cpp. - C++ GEPA Optimization - Pairs a real OpenAI baseline with a local GEPA optimization pass. Run:
npm run example -- cpp src/examples/cpp/optimization/gepa_optimization.cpp. - C++ Optimization Artifact Reuse - Saves and reapplies an optimizer artifact after a real OpenAI baseline. Run:
npm run example -- cpp src/examples/cpp/optimization/artifact_optimization.cpp.
Source
- Catalog:
npm run example -- list --jsonfromscripts/example-catalog.mjs - Files:
src/examples/cpp/
Pages
- Generation Generation — C++ examples backed by real provider calls.
- Agents Agents — C++ examples backed by real provider calls.
- Long-Horizon Agents Long-Horizon Agents — C++ examples backed by real provider calls.
- Flows Flows — C++ examples backed by real provider calls.
- Audio Audio — C++ examples backed by real provider calls.
- Optimization Optimization — C++ examples backed by real provider calls.