[AI Gateway] Restructure sidebar and add new features

Author: Tarush

public/__redirects

@@ -2250,3 +2250,8 @@
 
 # Calls
 /calls/* /realtime/:splat 301
+
+# AI Gateway
+/ai-gateway/providers/* /ai-gateway/usage/providers/:splat 301
+/ai-gateway/guardrails/* /ai-gateway/features/guardrails/:splat 301
+/ai-gateway/websockets-api/* /ai-gateway/usage/websockets-api/:splat 301

src/content/docs/ai-gateway/bring-your-own-keys.mdx renamed to src/content/docs/ai-gateway/configuration/bring-your-own-keys.mdx

@@ -22,20 +22,19 @@ This approach offers several key benefits:
 ## How it works
 
 With BYOK enabled, your workflow changes from:
-{/* TODO UPDATE THE USAGE HERE TO UNIVERSAL */}
 
 1. **Traditional approach**: Include API key in every request header
 
    ```bash
-   curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_slug}/openai/chat/completions \
+   curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai/chat/completions \
      -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "gpt-4", "messages": [...]}'
    ```
 
 2. **BYOK approach**: Configure key once in dashboard, make requests without exposing keys
    ```bash
-   curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_slug}/openai/chat/completions \
+   curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai/chat/completions \
      -H "Content-Type: application/json" \
      -d '{"model": "gpt-4", "messages": [...]}'
    ```

src/content/docs/ai-gateway/configuration/fallbacks.mdx

@@ -7,6 +7,12 @@ sidebar:
 
 import { Render, Aside } from "~/components";
 
+:::note[Deprecated]
+
+While the request handling features described on this page still work, [Dynamic Routing](/ai-gateway/features/dynamic-routing/) is now the preferred way to achieve advanced request handling, including timeouts, retries, and fallbacks. Dynamic Routing provides a more powerful and flexible approach with a visual interface for managing complex routing scenarios.
+
+:::
+
 Your AI gateway supports different strategies for handling requests to providers, which allows you to manage AI interactions effectively and ensure your applications remain responsive and reliable.
 
 ## Request timeouts

src/content/docs/ai-gateway/configuration/request-handling.mdx

@@ -3,6 +3,7 @@ pcx_content_type: how-to
 title: Add Human Feedback using API
 sidebar:
   order: 4
+  hidden: true
 ---
 
 import { APIRequest } from "~/components";

src/content/docs/ai-gateway/evaluations/add-human-feedback-api.mdx

@@ -3,6 +3,7 @@ pcx_content_type: how-to
 title: Add human feedback using Worker Bindings
 sidebar:
   order: 4
+  hidden: true
 ---
 
 This guide explains how to provide human feedback for AI Gateway evaluations using Worker bindings.

src/content/docs/ai-gateway/evaluations/add-human-feedback-bindings.mdx

@@ -3,6 +3,7 @@ pcx_content_type: how-to
 title: Add Human Feedback using Dashboard
 sidebar:
   order: 3
+  hidden: true
 ---
 
 Human feedback is a valuable metric to assess the performance of your AI models. By incorporating human feedback, you can gain deeper insights into how the model's responses are perceived and how well it performs from a user-centric perspective. This feedback can then be used in evaluations to calculate performance metrics, driving optimization and ultimately enhancing the reliability, accuracy, and efficiency of your AI application.

src/content/docs/ai-gateway/evaluations/add-human-feedback.mdx

@@ -3,9 +3,10 @@ title: Evaluations
 pcx_content_type: navigation
 order: 1
 sidebar:
-  order: 7
+  order: 100
   group:
     badge: Beta
+  hidden: true
 ---
 
 Understanding your application's performance is essential for optimization. Developers often have different priorities, and finding the optimal solution involves balancing key factors such as cost, latency, and accuracy. Some prioritize low-latency responses, while others focus on accuracy or cost-efficiency.

src/content/docs/ai-gateway/evaluations/index.mdx

@@ -3,6 +3,7 @@ pcx_content_type: how-to
 title: Set up Evaluations
 sidebar:
   order: 2
+  hidden: true
 ---
 
 This guide walks you through the process of setting up an evaluation in AI Gateway. These steps are done in the [Cloudflare dashboard](https://dash.cloudflare.com/).