Skip to content

Tutorials

The seven parts form a cumulative learning path. Part 1 is the shared tool backend; Parts 2–5 add independent platform capabilities around it. Part 6 adds model routing and failover using Agent Router. Part 7 adds bounded code execution with OpenSandbox. Both run independently of the earlier labs.

Part Build Time Run from
1. Governed MCP tools Quarkus MCP server with typed, validated tools 25 min part1-quarkus-mcp/
2. Gateway security JWT, CEL authorization, and ExtMCP guardrails 35 min part2-agentgateway/
3. Observability OpenTelemetry propagation and Jaeger traces 25 min part3-observability/
4. Multi-agent governance A2A workflow states, approval gates, and Agent Skills playbooks 50 min part4-multi-agent/
5. Evaluation Golden datasets and CI regression checks 35 min part5-evaluation/
6. Model routing Quarkus model backends and Agent Router failover 30 min part6-agent-router/
7. Sandbox execution Quarkus MCP tool, OpenSandbox execution limits, and cleanup evidence 35 min part7-opensandbox/

Follow Parts 1–7 to govern tools, workflows, model traffic, and code execution. All times assume prerequisites are installed; Part 6's Goose, tracing, and quota extensions have separate time estimates. Part 7's time excludes initial image downloads.

Part 5 also offers an optional OpenEnv behavioral evaluation lab (20 minutes), using Python 3.12 and synthetic refund rollouts with separate task and policy gates. It runs independently on port 8085.

Part 5 also has an optional Langfuse + real Goose experiment extension (30 minutes after downloads), comparing prompt variants with separate task, policy, and answer-report scores in a local self-hosted project.

Before you start

Install Java 25+ and Maven 3.9+ for the Java applications. Add Goose, agentgateway, Podman, and Agent Router as required by the part. Build once from the repository root:

mvn clean package -DskipTests

Every part also has a short README for commands and troubleshooting. The tutorial explains design decisions; the README is the operator runbook for the local demo.

Part 6 is included in the Maven build and adds curl and a pinned Agent Router CLI. Follow its prerequisites and installation before starting the timed exercise; no real model or provider credentials are required.

Conventions

  • Commands assume the repository root unless a step changes directories.
  • localhost ports and in-memory data are demo defaults, not deployment recommendations.
  • Example JWTs and policies are for local learning only.
  • Start each part with its start-all.sh. Parts 1–5 provide browser consoles; Part 6 uses terminal exercises and automated HTTP checks. Part 7 provides a same-origin console and real sandbox checks. The required flows do not need an LLM.