Examples

Every Rust example here is runnable source under src/examples/rust/ and calls a real provider API. The website and npm run example -- list are generated from each file’s ax-example header.

Groups

• Generation - 6 examples.
• Agents - 4 examples.
• Long-Horizon Agents - 6 examples.
• Flows - 5 examples.
• Audio - 3 examples.
• MCP - 3 examples.
• Optimization - 4 examples.

Generation

• Rust Typed Generation - Runs a small typed generation program against OpenAI. Run: npm run example -- rust src/examples/rust/generation/basic_generation.rs.
• Rust Structured Extraction - Extracts structured fields and labels from support text with OpenAI. Run: npm run example -- rust src/examples/rust/generation/structured_generation.rs.
• Rust Signature Constraints - Builds native constrained fields and runs the signature with OpenAI. Run: npm run example -- rust src/examples/rust/generation/signature-constraints.rs.
• Centralized Usage Observer - Attributes every completed model call to a tenant, user, and request from one global observer. Run: npm run example -- rust src/examples/rust/generation/usage_observer.rs.
• Rust Contextual Generation - Answers from supplied context and returns compact citations with OpenAI. Run: npm run example -- rust src/examples/rust/generation/context_generation.rs.
• Rust Adaptive Provider Balancing - Routes equivalent chat traffic using shared reliability, latency, and cost statistics. Run: npm run example -- rust src/examples/rust/generation/adaptive_balancer.rs.

Agents

• Rust 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 -- rust src/examples/rust/short-agents/basic_agent.rs.
• Rust 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 -- rust src/examples/rust/short-agents/tools_agent.rs.
• Rust 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 -- rust src/examples/rust/short-agents/handoff_agent.rs.
• Rust 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 -- rust src/examples/rust/short-agents/model_panel.rs.

Long-Horizon Agents

• Rust 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 -- rust src/examples/rust/long-agents/incident_log_forensics.rs.
• Rust 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 -- rust src/examples/rust/long-agents/codebase_peek_map.rs.
• Rust 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 -- rust src/examples/rust/long-agents/data_analyst_with_tools.rs.
• Rust 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 -- rust src/examples/rust/long-agents/self_improving_lab.rs.
• Rust 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 -- rust src/examples/rust/long-agents/skills_and_memory_assistant.rs.
• Rust Smart Defaults Agent - Shows AxAgent smart defaults: oversized undeclared context stays out of the prompt while relevance hints and runtime tools guide the agent. Run: npm run example -- rust src/examples/rust/long-agents/smart_defaults_agent.rs.

Flows

• Rust Sequential Flow - Runs a two-step Ax flow against OpenAI. Run: npm run example -- rust src/examples/rust/flows/sequential_flow.rs.
• Rust Branching Flow - Routes a classification through follow-up flow logic backed by OpenAI. Run: npm run example -- rust src/examples/rust/flows/branch_flow.rs.
• Rust Parallel Flow - Runs two independent OpenAI-backed steps in parallel before joining their results. Run: npm run example -- rust src/examples/rust/flows/parallel-flow.rs.
• Rust Composed Flow - Composes multiple typed programs into one OpenAI-backed flow. Run: npm run example -- rust src/examples/rust/flows/composed_flow.rs.
• Rust Refinement Flow - Drafts, critiques, and revises an answer through three OpenAI-backed steps. Run: npm run example -- rust src/examples/rust/flows/refine-flow.rs.

Audio

• Rust Text To Speech - Generates speech audio through OpenAI. Run: npm run example -- rust src/examples/rust/audio/speech_audio.rs.
• Rust Speech To Text - Transcribes a checked-in WAV file through OpenAI. Run: npm run example -- rust src/examples/rust/audio/transcribe_audio.rs.
• Rust Audio Summary Pipeline - Transcribes audio and summarizes the transcript with an OpenAI-backed generator. Run: npm run example -- rust src/examples/rust/audio/pipeline_audio.rs.

MCP

• Rust Native MCP Tools - Attaches a live MCP client directly to AxGen without a lossy function adapter. Run: npm run example -- rust src/examples/rust/mcp/native_mcp_tools.rs.
• Rust MCP Resource Wake - Subscribes over real Streamable HTTP and lets AxEventRuntime wake an authenticated Agent automatically. Run: npm run example -- rust src/examples/rust/mcp/resource_wake_agent.rs.
• Rust MCP Task Continuation - Creates an owned continuation and resumes an AxFlow from real MCP progress and terminal task notifications. Run: npm run example -- rust src/examples/rust/mcp/task_resume_flow.rs.

Optimization

• Rust AxGen Optimization - Runs a baseline OpenAI prediction and applies an optimizer artifact. Run: npm run example -- rust src/examples/rust/optimization/axgen_optimization.rs.
• Rust GEPA Optimization - Pairs a real OpenAI baseline with a local GEPA optimization pass. Run: npm run example -- rust src/examples/rust/optimization/gepa_optimization.rs.
• Rust Optimization Artifact Reuse - Saves and reapplies an optimizer artifact after a real OpenAI baseline. Run: npm run example -- rust src/examples/rust/optimization/artifact_optimization.rs.
• Rust Agent Playbook — Learn And Verify - Attach a persistent playbook, add validated hidden citations and stage guidance, then mine a task set into playbook rules with a verification gate. Run: npm run example -- rust src/examples/rust/optimization/agent_playbook_evolve.rs.

Source

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

Pages

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