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:
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.
localhostports 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.