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.