add reference architectures and why cf

src/content/docs/agents/capabilities/control-web-browsers.mdx

@@ -1,20 +1,10 @@
 ---
-type: concept
-title: Control Web Browsers
-pcx_content_type: concept
+pcx_content_type: navigation
+title: Control Web Browsers (Browser Rendering API)
+external_link: /browser-rendering/
 sidebar:
   order: 1
----
-
-import {
-	Render,
-	PackageManagers,
-	Steps,
-	FileTree,
-	Details,
-	Tabs,
-	TabItem,
-	WranglerConfig,
-} from "~/components";
+head: []
+description: The Workers Browser Rendering API allows developers to programmatically control and interact with a headless browser instance and create automation flows for their applications and products.
 
-Control web browsers
+---

src/content/docs/agents/capabilities/run-models.mdx

@@ -0,0 +1,9 @@
+---
+pcx_content_type: navigation
+title: Run models (Workers AI)
+external_link: /workers-ai/
+sidebar:
+  order: 2
+head: []
+description: Run popular open-source AI models on Cloudflare's network. 
+---

src/content/docs/agents/capabilities/send-email.mdx

@@ -1,22 +1,11 @@
 ---
-type: concept
+pcx_content_type: navigation
 title: Send Email
-pcx_content_type: concept
+external_link: /email-routing/email-workers/send-email-workers/
 sidebar:
-  order: 3
+  order: 2
+head: []
+description: Send emails from your Worker for async updates to a user. 
 ---
 
-import {
-	Render,
-	PackageManagers,
-	Steps,
-	FileTree,
-	Details,
-	Tabs,
-	TabItem,
-	WranglerConfig,
-} from "~/components";
 
-Send email
-
-https://developers.cloudflare.com/email-routing/email-workers/send-email-workers/

src/content/docs/agents/capabilities/webrtc-realtime.mdx

@@ -0,0 +1,9 @@
+---
+pcx_content_type: navigation
+title: Realtime voice (WebRTC)
+external_link: /calls/
+sidebar:
+  order: 4
+head: []
+description: Build real-time serverless video, audio and data applications.
+---

src/content/docs/agents/examples/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: reference
 title: Example Agents
 sidebar:
-  order: 3
+  order: 4
   group:
     hideIndex: true
 ---

src/content/docs/agents/index.mdx

@@ -31,9 +31,11 @@ Agents are deployed to Cloudflare's [Workers](/workers/) platform using [Durable
 </LinkButton>
 
 ## Why build agents on Cloudflare? 
-- 
+- *Designed for durable execution:* [Durable Objects](/durable-objects/) and [Workflows](/workflows) are built for a programming model that enables guaranteed execution for async tasks like long-running deep thinking LLM calls, human-in-the-loop, or unreliable API calls. 
+- *Non I/O bound pricing:* don't pay for long-running processes when your code is not executing. Cloudflare Workers is designed to scale down and [only charge you for CPU time](https://blog.cloudflare.com/workers-pricing-scale-to-zero/), as opposed to wall-clock time. 
+- *Scalable, and reliable, without compromising on performance:* by running on Cloudflare's network, agents can execute tasks close to the user without introducing latency for real-time experiences. 
 
-## Products
+## All the products you need in one platform
 
 <RelatedProduct header="AI Gateway" href="/ai-gateway/" product="ai-gateway">
 

src/content/docs/agents/reference-architectures/index.mdx

@@ -0,0 +1,14 @@
+---
+pcx_content_type: reference
+title: Reference Architectures
+sidebar:
+  order: 3
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+Example Reference Architectures
+
+<DirectoryListing />

src/content/docs/agents/reference-architectures/rag.mdx

@@ -0,0 +1,9 @@
+---
+pcx_content_type: navigation
+title: Retrieval Augmented Generation
+external_link: /reference-architecture/diagrams/ai/ai-rag/
+sidebar:
+  order: 1
+head: []
+description: Build RAG architectures on Cloudflare
+---