Merge branch 'main' into patch-8

artberger · web-flow · commit 013e8c6abf90 · 2026-02-24T13:26:11.000-05:00
Signed-off-by: Art &lt;artberger@users.noreply.github.com&gt;
diff --git a/assets/docs/pages/about/architecture.md b/assets/docs/pages/about/architecture.md
@@ -2,7 +2,7 @@ Learn more about the components that make up the {{< reuse "/docs/snippets/kgate
 
 ## Component architecture
 
-The following image shows the different components that make up the {{< reuse "/docs/snippets/kgateway.md" >}} {{< gloss "Control Plane" >}}control plane{{< /gloss >}} and {{< gloss "Data Plane" >}}data plane{{< /gloss >}}. These components work together to translate gateway custom resources into gateway {{< gloss "Proxy" >}}proxy{{< /gloss >}} configuration. The gateway proxy configuration controls the behavior of the gateway proxies that serve your apps. 
+The following image shows the different components that make up the {{< reuse "/docs/snippets/kgateway.md" >}} {{< gloss "Control Plane" >}} control plane{{< /gloss >}} and {{< gloss "Data Plane" >}}data plane{{< /gloss >}}. These components work together to translate gateway custom resources into gateway {{< gloss "Proxy" >}}proxy{{< /gloss >}} configuration. The gateway proxy configuration controls the behavior of the gateway proxies that serve your apps. 
 
 {{< reuse-image src="img/gw-control-plane-components.svg" caption="Component architecture" >}}
 {{< reuse-image-dark srcDark="img/gw-control-plane-components-dark.svg" caption="Component architecture" >}}
diff --git a/assets/docs/pages/about/overview.md b/assets/docs/pages/about/overview.md
@@ -84,7 +84,7 @@ The Gateway API is an API which can be used to program an ingress or an API gate
   {{< card link="../../traffic-management/destination-types/backends/lambda" title="AWS Lambda" tag="Traffic" >}}
   {{< card link="../../traffic-management/route-delegation/" title="Delegation" tag="Traffic" >}}
   {{< card link="../../traffic-management/direct-response/" title="Direct responses" tag="Traffic" >}}
-  {{< card link="../../traffic-management/ext/" title="Direct responses" tag="Traffic" >}}
+  {{< card link="../../traffic-management/extproc/" title="External processing" tag="Traffic" >}}
   {{< card link="../../setup/customize/" title="Gateway customization" tag="Setup" >}}
   {{< card link="../../integrations/" title="Integrations" tag="Setup" >}}
   {{< card link="../../resiliency/mirroring/" title="Mirroring" tag="Resiliency" >}}
diff --git a/assets/docs/pages/about/proxies.md b/assets/docs/pages/about/proxies.md
@@ -29,7 +29,7 @@ For more information, see the other docs in this [About](../) section.
 | Gateway proxy | Primary use cases | Description |
 | --- | --- | --- |
 | {{< icon "kgateway" >}} kgateway | API, ingress, egress, service mesh | The kgateway project includes its own proxy that is based on Envoy, an L3/L4/L7 network proxy. Beyond Envoy, kgateway provides a set of extensions for advanced configuration, security, and traffic management features. You can also integrate kgateway with the Istio service mesh in sidecar and ambient modes. For more information, see the [kgateway FAQs](../../faqs/) and [Envoy docs](https://www.envoyproxy.io/docs/envoy/latest/intro/what_is_envoy). |
-| {{< icon "agentgateway" >}} agentgateway | AI, A2A, MCP, LLM, Inference Extension | Agentgateway is an enterprise-grade gateway data plane that provides AI connectivity for agents and tools in any environment. <ul><li>For Kubernetes deployments, refer to [kgateway.dev/docs/agentgateway/](https://kgateway.dev/docs/agentgateway/)</li><li>For non-Kubernetes environments such as local or on-prem deployments, refer to the upstream [agentgateway.dev/docs](https://agentgateway.dev/docs/)</li></ul>|
+| {{< icon "agentgateway" >}} agentgateway | AI, A2A, MCP, LLM, Inference Extension | Agentgateway is an enterprise-grade gateway data plane that provides AI connectivity for agents and tools in any environment. <ul><li>For Kubernetes deployments, refer to [https://agentgateway.dev/docs/kubernetes/latest/](https://agentgateway.dev/docs/kubernetes/latest/)</li><li>For non-Kubernetes environments such as local or on-prem deployments, refer to the upstream [https://agentgateway.dev/docs/standalone/latest/](https://agentgateway.dev/docs/standalone/latest/)</li></ul>|
 
 ## Reserved ports
 
diff --git a/assets/docs/pages/reference/glossary.md b/assets/docs/pages/reference/glossary.md
@@ -35,7 +35,7 @@ A secure, policy-driven communication method for AI agents running in an ambient
 ### Agentgateway
 An open-source data plane optimized for agentic AI workloads. Kgateway uses agentgateway to route and manage traffic for LLMs, inference services, and AI-native applications.
 
-**Learn more**: [Agentgateway docs]({{< link-hextra path="/agentgateway/" >}})
+**Learn more**: [Agentgateway docs](https://agentgateway.dev/docs/)
 
 ### Agents
 Autonomous AI components that make decisions, communicate with services, and interact with other agents (with or without sidecars). In Kgateway, agents participate in the mesh and communicate over A2A or Envoy-based traffic.
diff --git a/assets/docs/pages/reference/helm/2.2.x/agentgateway.md b/assets/docs/pages/reference/helm/2.2.x/agentgateway.md
@@ -53,7 +53,7 @@
 | image.registry | string | Set the default image registry. | `"cr.agentgateway.dev"` |
 | image.tag | string | Set the default image tag. | `""` |
 | imagePullSecrets | list | Set a list of image pull secrets for Kubernetes to use when pulling container images from your own private registry instead of the default agentgateway registry. | `[]` |
-| inferenceExtension | object | Configure the integration with the Gateway API Inference Extension project, which lets you use agentgateway to route to AI inference workloads like LLMs that run locally in your Kubernetes cluster. Documentation for Inference Extension can be found here: https://kgateway.dev/docs/latest/agentgateway/inference/ | `{"enabled":false}` |
+| inferenceExtension | object | Configure the integration with the Gateway API Inference Extension project, which lets you use agentgateway to route to AI inference workloads like LLMs that run locally in your Kubernetes cluster. Documentation for Inference Extension can be found here: https://agentgateway.dev/docs/kubernetes/latest/inference/ | `{"enabled":false}` |
 | inferenceExtension.enabled | bool | Enable Inference Extension support in the agentgateway controller. | `false` |
 | nameOverride | string | Add a name to the default Helm base release, which is 'agentgateway'. If you set 'nameOverride: "foo", the name of the resources that the Helm release creates become 'agentgateway-foo', such as the deployment, service, and service account for the agentgateway control plane in the agentgateway-system namespace. | `""` |
 | nodeSelector | object | Set node selector labels for pod scheduling, such as 'kubernetes.io/arch: amd64'. | `{}` |
diff --git a/assets/docs/pages/security/ratelimit/global.md b/assets/docs/pages/security/ratelimit/global.md
@@ -212,7 +212,7 @@ Create a {{< reuse "docs/snippets/trafficpolicy.md" >}} resource that applies ra
 
 The {{< reuse "docs/snippets/trafficpolicy.md" >}} configures the descriptors that define the dimensions for rate limiting. Each descriptor consists of one or more entries that help categorize and count requests. The descriptor entries match on the descriptor keys that you defined previously in the Rate Limit Service.
 
-Entries can be of one of the following types: `RemoteAddress`, `Path`, `Header`, or `Generic`. You can combine different entry types so that they are applied together as a rate limit, such as `RemoteAddress` and `Generic` or `Header` and `Path`. The following table describes the different descriptor entry types. For more information, see the [API docs](../../reference/api/#ratelimitpolicy).
+Entries can be of one of the following types: `RemoteAddress`, `Path`, `Header`, or `Generic`. You can combine different entry types so that they are applied together as a rate limit, such as `RemoteAddress` and `Generic` or `Header` and `Path`. The following table describes the different descriptor entry types. For more information, see the [API docs](../../../reference/api/#ratelimit).
 
 | Type | Description | Additional Fields |
 |------|-------------|-------------------|
diff --git a/assets/docs/snippets/agentgateway-setup.md b/assets/docs/snippets/agentgateway-setup.md
@@ -1,4 +1,4 @@
-1. Create a Gateway that uses the `{{< reuse "docs/snippets/agw-gatewayclass.md" >}}` GatewayClass. The following example sets up a Gateway that uses the [default agentgateway proxy template](https://github.com/kgateway-dev/kgateway/blob/main/pkg/kgateway/helm/agentgateway/templates/deployment.yaml). 
+1. Create a Gateway that uses the `{{< reuse "docs/snippets/agw-gatewayclass.md" >}}` GatewayClass. The following example sets up a Gateway that uses the [default agentgateway proxy template](https://github.com/agentgateway/agentgateway/blob/main/controller/install/helm/agentgateway/templates/deployment.yaml). 
    ```yaml
    kubectl apply -f- <<EOF
    apiVersion: gateway.networking.k8s.io/v1
diff --git a/assets/docs/snippets/agw-prereq-llm.md b/assets/docs/snippets/agw-prereq-llm.md
@@ -1,2 +1,2 @@
-1. [Set up an agentgateway proxy]({{< link-hextra path="/agentgateway/setup/" >}}). 
-2. [Set up access to the OpenAI LLM provider]({{< link-hextra path="/agentgateway/llm/providers/openai/" >}}).
+1. [Set up an agentgateway proxy]({{< link-hextra path="/ai/" >}}). 
+2. [Set up access to the OpenAI LLM provider]({{< link-hextra path="/ai/cloud-providers/#openai" >}}).
diff --git a/assets/docs/snippets/ai-deprecation-note.md b/assets/docs/snippets/ai-deprecation-note.md
@@ -1,3 +1,3 @@
 {{< callout type="warning" >}}
-AI Gateway for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy](../../../agentgateway/) instead.
+AI Gateway for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy](../../../ai/) instead.
 {{< /callout >}}
diff --git a/content/blog/kgateway v2.1 release blog.md b/content/blog/kgateway v2.1 release blog.md
@@ -44,7 +44,7 @@ spec:
 EOF
 ```
 
-You are now ready to try out agentgateway. Check out the [agentgateway guides]({{< link-hextra path="/latest/agentgateway/" >}}) to learn how to route traffic to an LLM provider, MCP tool server, or AI agent. 
+You are now ready to try out agentgateway. Check out the [agentgateway guides]({{< link-hextra path="../../../docs/envoy/2.1.x/ai/" >}}) to learn how to route traffic to an LLM provider, MCP tool server, or AI agent. 
 
 ### K8s GW API 1.3.0 and Inference Extension 1.0.0
 
@@ -146,7 +146,7 @@ kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/downloa
 {{< /tabs >}}
 
 ### AI Backend API changes {#v21-ai-backend-api-changes}
-The AI Backend API is updated to simplify the configuration of various LLM features. For more information, see the [API reference]({{< link-hextra path="/latest/reference/api/#aibackend" >}}) and [AI guides]({{< link-hextra path="/latest/agentgateway/llm/" >}}) docs.
+The AI Backend API is updated to simplify the configuration of various LLM features. For more information, see the [API reference]({{< link-hextra path="/latest/reference/api/#aibackend" >}}) and [AI guides]({{< link-hextra path="../../../docs/envoy/2.1.x/ai/" >}}) docs.
 
 
 ### Route delegation annotation for policy merging {#v21-delegation-policy-merging}
@@ -216,7 +216,7 @@ You can also check out the agentgateway and kgateway integration in action routi
 
 ##  🗑️ Deprecated or removed features
 
-AI Gateway and Inference Extension support for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy]({{< link-hextra path="/latest/agentgateway/" >}}) instead. To learn more about why we think that agentgateway is better suited as a gateway for agentic AI and MCP workloads, check out this [blog](https://www.solo.io/blog/why-do-we-need-a-new-gateway-for-ai-agents). 
+AI Gateway and Inference Extension support for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy]({{< link-hextra path="../../../docs/envoy/2.1.x/ai/" >}}) instead. To learn more about why we think that agentgateway is better suited as a gateway for agentic AI and MCP workloads, check out this [blog](https://www.solo.io/blog/why-do-we-need-a-new-gateway-for-ai-agents). 
 
 ## Release notes
 Check out the full details of the kgateway v1.2 release in our [release notes](https://kgateway.dev/docs/latest/reference/release-notes/).
diff --git a/content/docs/envoy/2.1.x/ai/setup.md b/content/docs/envoy/2.1.x/ai/setup.md
@@ -16,7 +16,7 @@ Configure your Helm chart installation to use AI Gateway. Then, use a custom Gat
 
 Configure your {{< reuse "/docs/snippets/kgateway.md" >}} Helm chart installation to use AI Gateway.
 
-1. [Upgrade]({{< link-hextra path="/envoy/latest/operations/upgrade/" >}}) {{< reuse "/docs/snippets/kgateway.md" >}} with the AI Gateway extension enabled. **Note**: To use AI Gateway with [agentgateway](../../agentgateway/latest/), see the [agentgateway docs]({{< link-hextra path="/agentgateway" >}}).
+1. [Upgrade]({{< link-hextra path="/envoy/latest/operations/upgrade/" >}}) {{< reuse "/docs/snippets/kgateway.md" >}} with the AI Gateway extension enabled. **Note**: To use AI Gateway with agentgateway, see the [agentgateway docs]({{< link-hextra path="/ai" >}}).
 
    {{< callout type="warning" >}}
    If you use a different version or extra Helm settings such as in a `-f values.yaml` file, update the following command accordingly.
diff --git a/content/docs/envoy/2.1.x/integrations/_index.md b/content/docs/envoy/2.1.x/integrations/_index.md
@@ -7,11 +7,11 @@ description: Integrate kgateway with common cloud-native tools.
 Integrate kgateway with common cloud-native tools.
 
 {{< cards >}}
-  {{< card link="../../../agentgateway/latest/" title="Agentgateway" >}}
+  {{< card link="../../../ai/" title="Agentgateway" >}}
   {{< card link="argo" title="Argo Rollouts" >}}
   {{< card link="aws-elb" title="AWS ELBs" >}}
   {{< card link="external-dns-cert-manager" title="ExternalDNS & Cert Manager"  >}}
-  {{< card link="../../../agentgateway/latest/inference/" title="Inference Extension to the Gateway API"  >}}
+  {{< card link="https://agentgateway.dev/docs/kubernetes/latest/inference/" title="Inference Extension to the Gateway API"  >}}
   {{< card link="istio" title="Ingress to service meshes"  >}}
   {{< card link="../reference/helm/" title="Helm"  >}}
   {{< card link="../quickstart/" title="Kubernetes"  >}}
diff --git a/content/docs/envoy/2.1.x/reference/release-notes.md b/content/docs/envoy/2.1.x/reference/release-notes.md
@@ -30,7 +30,7 @@ kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/downloa
 
 #### AI Backend API changes {#v21-ai-backend-api-changes}
 
-The AI Backend API is updated to simplify the configuration of various LLM features. For more information, see the [API reference](../api/#aibackend) and [AI guides](../../agentgateway/llm/) docs.
+The AI Backend API is updated to simplify the configuration of various LLM features. For more information, see the [API reference](../api/#aibackend) and [AI guides](../../ai/) docs.
 
 Update your old configuration to the new API style as follows.
 
@@ -126,7 +126,7 @@ Note that this change does not impact the other delegation annotations:
 
 #### Deprecated support for AI Gateway and Inference Extension with Envoy
 
-AI Gateway and Inference Extension support for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy]({{< link-hextra path="/agentgateway/" >}}) instead.
+AI Gateway and Inference Extension support for Envoy-based gateway proxies is deprecated and is planned to be removed in version 2.2. If you want to use AI capabilities, use an [agentgateway proxy]({{< link-hextra path="/ai/" >}}) instead.
 
 #### Fail open policy for ExtProc providers
 
@@ -181,7 +181,7 @@ Disabling policies can be applied to CORS, extAuth, extProc, and rate limit poli
 
 #### Agentgateway integration {#v21-agentgateway}
 
-Kgateway now supports [agentgateway](https://agentgateway.dev/), an open source, highly available, highly scalable, and enterprise-grade gateway data plane that provides AI connectivity for agents and tools in any environment. For more information, see the [Agentgateway docs](../../agentgateway/).
+Kgateway now supports [agentgateway](https://agentgateway.dev/), an open source, highly available, highly scalable, and enterprise-grade gateway data plane that provides AI connectivity for agents and tools in any environment. For more information, see the [Agentgateway docs](../../ai/).
 
 #### Global policy attachment {#v21-global-policy-attachment}
 
diff --git a/content/docs/envoy/latest/integrations/_index.md b/content/docs/envoy/latest/integrations/_index.md
@@ -7,11 +7,9 @@ description: Integrate kgateway with common cloud-native tools.
 Integrate kgateway with common cloud-native tools.
 
 {{< cards >}}
-  {{< card link="../../../agentgateway/latest/" title="Agentgateway" >}}
   {{< card link="argo" title="Argo Rollouts" >}}
   {{< card link="aws-elb" title="AWS ELBs" >}}
   {{< card link="external-dns-cert-manager" title="ExternalDNS & Cert Manager"  >}}
-  {{< card link="../../../agentgateway/latest/inference/" title="Inference Extension to the Gateway API"  >}}
   {{< card link="istio" title="Ingress to service meshes"  >}}
   {{< card link="../reference/helm/" title="Helm"  >}}
   {{< card link="../quickstart/" title="Kubernetes"  >}}
diff --git a/content/docs/envoy/main/integrations/_index.md b/content/docs/envoy/main/integrations/_index.md
@@ -7,11 +7,9 @@ description: Integrate kgateway with common cloud-native tools.
 Integrate kgateway with common cloud-native tools.
 
 {{< cards >}}
-  {{< card link="../../../agentgateway/latest/" title="Agentgateway" >}}
   {{< card link="argo" title="Argo Rollouts" >}}
   {{< card link="aws-elb" title="AWS ELBs" >}}
   {{< card link="external-dns-cert-manager" title="ExternalDNS & Cert Manager"  >}}
-  {{< card link="../../../agentgateway/latest/inference/" title="Inference Extension to the Gateway API"  >}}
   {{< card link="istio" title="Ingress to service meshes"  >}}
   {{< card link="../reference/helm/" title="Helm"  >}}
   {{< card link="../quickstart/" title="Kubernetes"  >}}

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-1. Create a Gateway that uses the `{{< reuse "docs/snippets/agw-gatewayclass.md" >}}` GatewayClass. The following example sets up a Gateway that uses the [default agentgateway proxy template](https://github.com/kgateway-dev/kgateway/blob/main/pkg/kgateway/helm/agentgateway/templates/deployment.yaml).
	`1`	+1. Create a Gateway that uses the `{{< reuse "docs/snippets/agw-gatewayclass.md" >}}` GatewayClass. The following example sets up a Gateway that uses the [default agentgateway proxy template](https://github.com/agentgateway/agentgateway/blob/main/controller/install/helm/agentgateway/templates/deployment.yaml).
`2`	`2`	```yaml
`3`	`3`	`kubectl apply -f- <<EOF`
`4`	`4`	`apiVersion: gateway.networking.k8s.io/v1`