WIP /agents structure

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

@@ -0,0 +1,20 @@
+---
+type: concept
+title: Control Web Browsers
+pcx_content_type: concept
+sidebar:
+  order: 1
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Control web browsers

src/content/docs/agents/capabilities/human-in-the-loop.mdx

@@ -0,0 +1,22 @@
+---
+type: concept
+title: Human in the loop
+pcx_content_type: concept
+sidebar:
+  order: 7
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Human in the loop
+
+Show persisting state and waiting for human input before moving forward

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

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

src/content/docs/agents/capabilities/multiplayer.mdx

@@ -0,0 +1,24 @@
+---
+type: concept
+title: Multiplayer
+pcx_content_type: concept
+sidebar:
+  order: 9
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Show multiplayer chat
+
+https://x.com/threepointone/status/1883863974367866988
+
+Little connecting dots to agents (multiple people can chat with same agent, shared chat with agent)

src/content/docs/agents/capabilities/persistent-memory.mdx

@@ -0,0 +1,20 @@
+---
+type: concept
+title: Persistent memory
+pcx_content_type: concept
+sidebar:
+  order: 6
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Remember what you said last time, remember previous actions, etc.

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

@@ -0,0 +1,26 @@
+---
+type: concept
+title: Receive Email
+pcx_content_type: concept
+sidebar:
+  order: 2
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Receive email
+
+https://developers.cloudflare.com/email-routing/email-workers/
+
+and then reply
+
+https://developers.cloudflare.com/email-routing/email-workers/reply-email-workers/

src/content/docs/agents/capabilities/receive-webhooks.mdx

@@ -0,0 +1,20 @@
+---
+type: concept
+title: Receive Webhooks
+pcx_content_type: concept
+sidebar:
+  order: 5
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Receive Webhooks

src/content/docs/agents/capabilities/retreival-augmented-generation-rag.mdx

@@ -0,0 +1,20 @@
+---
+type: concept
+title: Retreival Augmented Generation (RAG)
+pcx_content_type: concept
+sidebar:
+  order: 5
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Link to https://developers.cloudflare.com/workers-ai/tutorials/build-a-retrieval-augmented-generation-ai/

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

@@ -0,0 +1,22 @@
+---
+type: concept
+title: Send Email
+pcx_content_type: concept
+sidebar:
+  order: 3
+---
+
+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/wake-up.mdx

@@ -0,0 +1,20 @@
+---
+type: concept
+title: Alarms
+pcx_content_type: concept
+sidebar:
+  order: 8
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Explain DO Alarms in context of agents

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

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

src/content/docs/agents/get-started.mdx

@@ -0,0 +1,19 @@
+---
+title: Get started
+pcx_content_type: get-started
+sidebar:
+  order: 2
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Show step-by-step of getting to hello world

src/content/docs/agents/index.mdx

@@ -0,0 +1,93 @@
+---
+title: Build agents on Cloudflare
+type: overview
+pcx_content_type: overview
+sidebar:
+  order: 1
+head:
+  - tag: title
+    content: Agents
+---
+
+import {
+	CardGrid,
+	Description,
+	Feature,
+	LinkButton,
+	LinkTitleCard,
+	Plan,
+	RelatedProduct,
+	Render,
+} from "~/components";
+
+<Plan type="all" />
+
+Build AI-powered agents that can autonomously perform tasks, remember state, control web browsers, and communicate over email.
+
+Agents are deployed to Cloudflare's [Workers](/workers/) platform using [Durable Objects](/durable-objects/), [Browser Rendering](/browser-rendering/), [Email Routing](/email-routing/) and [more](/products/?product-group=Developer+platform).
+
+<LinkButton variant="primary" href="/agents/get-started/">
+	Get started
+</LinkButton>
+
+## Why build agents on Cloudflare? 
+- 
+
+## Products
+
+<RelatedProduct header="AI Gateway" href="/ai-gateway/" product="ai-gateway">
+
+Observe and control your AI applications with caching, rate limiting, request retries, model fallback, and more.
+
+</RelatedProduct>
+
+<RelatedProduct header="Vectorize" href="/vectorize/" product="vectorize">
+
+Build full-stack AI applications with Vectorize, Cloudflare’s vector database. Adding Vectorize enables you to perform tasks such as semantic search, recommendations, anomaly detection or can be used to provide context and memory to an LLM.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="Workers" href="/workers/" product="workers">
+
+Build serverless applications and deploy instantly across the globe for exceptional performance, reliability, and scale.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="Pages" href="/pages/" product="pages">
+
+Create full-stack applications that are instantly deployed to the Cloudflare global network.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="R2" href="/r2/" product="r2">
+
+Store large amounts of unstructured data without the costly egress bandwidth fees associated with typical cloud storage services.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="D1" href="/d1/" product="d1">
+
+Create new serverless SQL databases to query from your Workers and Pages projects.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="Durable Objects" href="/durable-objects/" product="durable-objects">
+
+A globally distributed coordination API with strongly consistent storage.
+
+
+</RelatedProduct>
+
+<RelatedProduct header="KV" href="/kv/" product="kv">
+
+Create a global, low-latency, key-value data storage.
+
+
+</RelatedProduct>
+
+***

src/content/docs/agents/models.mdx

@@ -0,0 +1,21 @@
+---
+title: AI Models
+pcx_content_type: get-started
+sidebar:
+  order: 5
+---
+
+import {
+	Render,
+	PackageManagers,
+	Steps,
+	FileTree,
+	Details,
+	Tabs,
+	TabItem,
+	WranglerConfig,
+} from "~/components";
+
+Use any model from anywhere — whether its on Workers AI or a model outside of Cloudflare.
+
+Link to Workers AI model catalog