aigw-fundamentals

Explains Envoy AI Gateway CRDs, resource hierarchy, and provider authentication for designing AI gateway architectures.

3|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/missBerg/envoy-skills --skill aigw-fundamentals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aigw-fundamentals
Source: https://github.com/missBerg/envoy-skills/tree/main/ai-gateway/adopters/skills/aigw-fundamentals
Command: npx skills add https://github.com/missBerg/envoy-skills --skill aigw-fundamentals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarifies how Envoy AI Gateway fundamentals work, including CRDs, resource hierarchy, API schemas, and provider authentication, so teams can design and deploy AI gateway architectures with confidence.

Core Features & Use Cases

  • CRD definitions: AIGatewayRoute, AIServiceBackend, BackendSecurityPolicy, GatewayConfig, MCPRoute, and QuotaPolicy.
  • Resource hierarchy guidance: mapping between routes, backends, and models across providers.
  • Use cases: standard OpenAI-compatible backends, model-specific routing, and secure integration with TLS and API keys.

Quick Start

Apply the AIGateway fundamentals to your cluster by creating the core CRDs and outlining your first route and backend configurations according to your deployment plan.

Frequently Asked Questions about aigw-fundamentals

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What CRDs do I need to configure an Envoy AI Gateway?

Configuring an Envoy AI Gateway requires applying CRDs including AIGatewayRoute, AIServiceBackend, BackendSecurityPolicy, GatewayConfig, MCPRoute, and QuotaPolicy. These resources define the routing hierarchy, backend mappings, and security policies for your AI deployment.

How do I secure API keys and TLS for AI service backends in Kubernetes?

Securing AI service backends in Kubernetes involves applying the BackendSecurityPolicy CRD within your Envoy AI Gateway architecture. This policy manages provider authentication by defining TLS validation rules and API key integration for secure backend connections.

Can I route traffic to specific AI models using Envoy AI Gateway?

You can route traffic to specific AI models by defining AIGatewayRoute resources within the Envoy AI Gateway. This CRD maps incoming requests to appropriate AIServiceBackend resources, enabling model-specific routing across standard OpenAI-compatible providers.

How do I map the resource hierarchy between routes, backends, and providers?

Mapping the Envoy AI Gateway resource hierarchy involves linking AIGatewayRoute definitions to AIServiceBackend resources. This structure dictates how requests traverse from the gateway entry point to specific AI models across various configured providers.

What is the best way to deploy an AI gateway architecture with Envoy?

Designing an AI gateway architecture with Envoy involves creating core CRDs to outline route and backend configurations. This approach ensures clear documentation of resource types, integration points with Gateway API components, and security considerations.

Does Envoy AI Gateway support standard OpenAI-compatible backends?

Envoy AI Gateway supports standard OpenAI-compatible backends through the AIServiceBackend CRD. This allows teams to integrate various AI providers into their cluster while maintaining consistent routing and security policies across the gateway.