aigw-route

Bind AI backends to a Gateway using AIGatewayRoute resources.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bind AI backends to a Gateway using model-based routing with AIGatewayRoute resources, enabling centralized control over where AI workloads are served.

Core Features & Use Cases

  • Match on the x-ai-eg-model header to route requests to one or more AIServiceBackends.
  • Support traffic splitting (weights) and failover (priorities) across multiple backends.
  • Configure timeouts, model name overrides, and optional InferencePool usage for self-hosted models.

Quick Start

Create an AIGatewayRoute that binds AI backends to a Gateway and routes traffic based on the x-ai-eg-model header.

Frequently Asked Questions about aigw-route

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

FAQPage Schema
How do I route AI inference traffic to multiple backends using a gateway?▼

Route AI inference traffic by creating AIGatewayRoute resources that attach AI backends to a Gateway. This enables model-based routing to control where AI workloads are served across different backend services.

How does model-based routing work for AI gateway requests?▼

Model-based routing works by enforcing explicit model matching through the x-ai-eg-model header. The Gateway inspects this header on incoming requests to direct traffic to the correct AIServiceBackend or InferencePool destination.

Can I configure traffic splitting and failover for AI backends?▼

Yes, you can configure traffic splitting and failover for AI backends. AIGatewayRoute resources support assigning weights for traffic splitting and priorities for priority-based failover across multiple AIServiceBackend resources.

Do I need cross-namespace access controls to reference AI backends?▼

Yes, cross-namespace access controls are required when referencing resources. You must configure explicit permissions if your AIGatewayRoute references AIServiceBackend or InferencePool resources deployed in a different namespace.

Does AI gateway routing support streaming timeouts and model name overrides?▼

Yes, AI gateway routing supports streaming timeouts and model name overrides. You can configure these settings within the AIGatewayRoute resource to manage long-running inference streams and map requested model names to backend-specific names.

What is the best way to route self-hosted models through an AI gateway?▼

The best way to route self-hosted models is by using InferencePool backends within your AIGatewayRoute configuration. This allows the Gateway to direct traffic to self-hosted inference workloads based on the x-ai-eg-model header.