Overview Provider-backed runnable examples generated from source headers. go examples examples src/examples/go example Overview

Examples

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

Groups

Generation

  • Go Typed Generation - Runs a small typed generation program against OpenAI. Run: npm run example -- go src/examples/go/generation/basic_generation.go.
  • Go Structured Extraction - Extracts structured fields and labels from support text with OpenAI. Run: npm run example -- go src/examples/go/generation/structured_generation.go.
  • Go Contextual Generation - Answers from supplied context and returns compact citations with OpenAI. Run: npm run example -- go src/examples/go/generation/context_generation.go.

Agents

  • Go 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 -- go src/examples/go/short-agents/basic_agent.go.
  • Go 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 -- go src/examples/go/short-agents/tools_agent.go.
  • Go 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 -- go src/examples/go/short-agents/handoff_agent.go.
  • Go 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 -- go src/examples/go/short-agents/model_panel.go.

Long-Horizon Agents

  • Go 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 -- go src/examples/go/long-agents/incident_log_forensics.go.
  • Go 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 -- go src/examples/go/long-agents/codebase_peek_map.go.
  • Go 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 -- go src/examples/go/long-agents/data_analyst_with_tools.go.
  • Go 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 -- go src/examples/go/long-agents/self_improving_lab.go.
  • Go 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 -- go src/examples/go/long-agents/skills_and_memory_assistant.go.

Flows

  • Go Sequential Flow - Runs a two-step Ax flow against OpenAI. Run: npm run example -- go src/examples/go/flows/sequential_flow.go.
  • Go Branching Flow - Routes a classification through follow-up flow logic backed by OpenAI. Run: npm run example -- go src/examples/go/flows/branch_flow.go.
  • Go Composed Flow - Composes multiple typed programs into one OpenAI-backed flow. Run: npm run example -- go src/examples/go/flows/composed_flow.go.

Audio

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

Optimization

  • Go AxGen Optimization - Runs a baseline OpenAI prediction and applies an optimizer artifact. Run: npm run example -- go src/examples/go/optimization/axgen_optimization.go.
  • Go GEPA Optimization - Pairs a real OpenAI baseline with a local GEPA optimization pass. Run: npm run example -- go src/examples/go/optimization/gepa_optimization.go.
  • Go Optimization Artifact Reuse - Saves and reapplies an optimizer artifact after a real OpenAI baseline. Run: npm run example -- go src/examples/go/optimization/artifact_optimization.go.

Source

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

Pages

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