Examples

Every Java example here is runnable source under src/examples/java/ 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

• Java Typed Generation - Runs a small typed generation program against OpenAI. Run: npm run example -- java src/examples/java/generation/BasicGenerationExample.java.
• Java Structured Extraction - Extracts structured fields and labels from support text with OpenAI. Run: npm run example -- java src/examples/java/generation/StructuredGenerationExample.java.
• Java Contextual Generation - Answers from supplied context and returns compact citations with OpenAI. Run: npm run example -- java src/examples/java/generation/ContextGenerationExample.java.

Agents

• Java 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 -- java src/examples/java/short-agents/BasicAgentExample.java.
• Java 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 -- java src/examples/java/short-agents/ToolsAgentExample.java.
• Java 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 -- java src/examples/java/short-agents/HandoffAgentExample.java.
• Java 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 -- java src/examples/java/short-agents/ModelPanelExample.java.

Long-Horizon Agents

• Java 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 -- java src/examples/java/long-agents/IncidentLogForensicsExample.java.
• Java 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 -- java src/examples/java/long-agents/CodebasePeekMapExample.java.
• Java 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 -- java src/examples/java/long-agents/DataAnalystWithToolsExample.java.
• Java 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 -- java src/examples/java/long-agents/SelfImprovingLabExample.java.
• Java 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 -- java src/examples/java/long-agents/SkillsAndMemoryAssistantExample.java.

Flows

• Java Sequential Flow - Runs a two-step Ax flow against OpenAI. Run: npm run example -- java src/examples/java/flows/SequentialFlowExample.java.
• Java Branching Flow - Routes a classification through follow-up flow logic backed by OpenAI. Run: npm run example -- java src/examples/java/flows/BranchFlowExample.java.
• Java Composed Flow - Composes multiple typed programs into one OpenAI-backed flow. Run: npm run example -- java src/examples/java/flows/ComposedFlowExample.java.

Audio

• Java Text To Speech - Generates speech audio through OpenAI. Run: npm run example -- java src/examples/java/audio/SpeechAudioExample.java.
• Java Speech To Text - Transcribes a checked-in WAV file through OpenAI. Run: npm run example -- java src/examples/java/audio/TranscribeAudioExample.java.
• Java Audio Summary Pipeline - Transcribes audio and summarizes the transcript with an OpenAI-backed generator. Run: npm run example -- java src/examples/java/audio/PipelineAudioExample.java.

Optimization

• Java AxGen Optimization - Runs a baseline OpenAI prediction and applies an optimizer artifact. Run: npm run example -- java src/examples/java/optimization/AxgenOptimizationExample.java.
• Java GEPA Optimization - Pairs a real OpenAI baseline with a local GEPA optimization pass. Run: npm run example -- java src/examples/java/optimization/GepaOptimizationExample.java.
• Java Optimization Artifact Reuse - Saves and reapplies an optimizer artifact after a real OpenAI baseline. Run: npm run example -- java src/examples/java/optimization/ArtifactOptimizationExample.java.

Source

• Catalog: npm run example -- list --json from scripts/example-catalog.mjs
• Files: src/examples/java/

Pages

• Generation Generation — Java examples backed by real provider calls.
• Agents Agents — Java examples backed by real provider calls.
• Long-Horizon Agents Long-Horizon Agents — Java examples backed by real provider calls.
• Flows Flows — Java examples backed by real provider calls.
• Audio Audio — Java examples backed by real provider calls.
• Optimization Optimization — Java examples backed by real provider calls.