Learn the schema first
Base the interface on the system’s real dependencies.
AI INFRASTRUCTURE · F5 · NGINX
Turn complex AI gateway configuration into a trustworthy visual workflow

I designed a visual configuration experience for F5 AI Gateway that helps enterprise teams understand LLM traffic without beginning in raw YAML. The work turns routes, policies, profiles, processors, and services into a navigable map while keeping the underlying configuration visible and verifiable.
F5 AI Gateway routes, protects, and observes generative-AI traffic, but its routes, policies, backends, and processors are configured in YAML or JSON. I needed to help people unfamiliar with that syntax configure complex LLM workflows while preserving the relationships and details technical teams need to trust.
Base the interface on the system’s real dependencies.
Reveal hierarchy without flattening meaningful complexity.
Make the map inspectable against its YAML source.
Understanding the system
Before proposing an interface, I learned how the Gateway thinks. I built and traced sample configurations to understand how routes, policies, profiles, processors, and services connect across a real LLM workflow.
I then reconstructed those dependencies as a shared concept map: Route → Policy → Profile → Processor → Service. This gave design, engineering, and product a common language for discussing the configuration before I abstracted it into UI.


Design decision: I used the configuration schema—not a generic flowchart—as the source of the visual model.
Progressive simplification
My first route-level view made every dependency visible, but it carried too much visual weight for a large deployment. I refined the hierarchy so routes act as entry points, policies and profiles organize the middle layer, processors show operational steps, and services anchor the destinations.
The final direction uses a global map of higher-level components. Users can scan a configuration at scale, then drill into a selected node rather than reading every layer at once.


Design decision: I made overview and inspection complementary, so clarity did not require losing system fidelity.
Trust and next phase
I treated the map and YAML as two views of the same configuration. Node-level detail, related-code highlighting, live generation, and schema-aware validation help non-technical users work visually while giving technical users a way to verify what the interface represents.
The launched experience centers the map and YAML views. Form controls and a draggable, editable map are next-phase work—not shipped features—and are intended to extend guided editing without breaking that connection to code.


Design decision: I designed every visual shortcut to retain a clear path back to the configuration it represents.
Launched in June 2025, the experience makes the Gateway’s configuration model easier to approach while keeping its technical structure explicit. It supports a clearer shared understanding across enterprise users and cross-functional teams without reducing the system to a black box.
Learning the YAML schema directly was essential to designing a trustworthy abstraction rather than a decorative diagram. The project reinforced that scalable simplification means revealing the right complexity at the right moment, not removing it.








