CFSA-403 Introduce beta docs for cloudflare agent (#28899)

* introduce beta docs for cloudflare agent

* clarify audience cf agent is available to

* add required content for docs compatibility

* +1 codeowner from agent experience

* Update .github/CODEOWNERS

* tweaks

---------

Co-authored-by: Kody Jackson <kody@cloudflare.com>

Author: kale-stew

.github/CODEOWNERS

@@ -20,6 +20,7 @@ package.json @cloudflare/content-engineering
 
 # AI
 
+/src/content/docs/cloudflare-agent/ @dmmulroy @Brayden @cloudflare/pcx-technical-writing
 /src/content/docs/agents/ @irvinebroque @rita3ko @elithrar @thomasgauvin @threepointone @whoiskatrin @cloudflare/pcx-technical-writing @cloudflare/ai-agents @cloudflare/dev-plat-leads
 /src/content/partials/agents/ @elithrar @rita3ko @irvinebroque @vy-ton @cloudflare/pcx-technical-writing
 /src/content/docs/ai-gateway/ @abhishekkankani @palashgo @thebongy @roerohan @kathayl @mchenco @zeke @superhighfives @bfirsh @mattrothenberg @ethulia @cloudflare/pcx-technical-writing

.github/labeler.yml

@@ -10,6 +10,10 @@ product:agents:
   - changed-files:
       - any-glob-to-any-file:
           - src/content/docs/agents/**
+product:cloudflare-agent:
+  - changed-files:
+      - any-glob-to-any-file:
+          - src/content/docs/cloudflare-agent/**
 product:ai-crawl-control:
   - changed-files:
       - any-glob-to-any-file:

src/content/directory/cloudflare-agent.yaml

@@ -0,0 +1,13 @@
+
+name: Cloudflare Agent
+entry:
+  title: Cloudflare Agent
+  url: /cloudflare-agent/
+  group: Developer platform
+  additional_groups: [AI]
+  tags: [AI]
+
+meta:
+  title: Cloudflare Agent docs
+  description: An AI-powered assistant that helps you navigate, configure, and take actions on Cloudflare services directly from the dashboard
+  author: "@cloudflare"

src/content/docs/cloudflare-agent/index.mdx

@@ -0,0 +1,63 @@
+---
+title: Cloudflare Agent
+pcx_content_type: overview
+tags:
+  - AI
+sidebar:
+  order: 1
+head:
+  - tag: title
+    content: Overview
+---
+
+import { Description } from "~/components";
+
+<Description>
+An AI-powered assistant that helps you navigate, configure, and take actions on Cloudflare services directly from the dashboard.
+</Description>
+
+:::note[Beta]
+Cloudflare Agent is currently in beta and only available to accounts on a Free plan. Features and behaviors may change.
+:::
+
+With Cloudflare Agent, you can:
+
+- Get answers to questions about Cloudflare products and your account configurations
+- Execute Cloudflare API operations with approval flows for write actions
+- Run network diagnostics like DNS lookups, certificate checks, and connectivity tests
+- Search Cloudflare documentation for relevant information
+
+Cloudflare Agent is built with the [Agents SDK](/agents/), the same framework you can use to build your own AI agents on Cloudflare.
+
+---
+
+## Capabilities
+
+### Documentation search
+
+Search Cloudflare documentation to find answers about products, features, and best practices.
+
+### Cloudflare API operations
+
+Execute operations against the Cloudflare API using natural language. You can ask the agent to perform tasks like creating DNS records, managing firewall rules, or checking your account settings.
+
+Write operations require your approval before execution.
+
+### Network diagnostics
+
+Run network diagnostic commands to troubleshoot connectivity and configuration issues:
+
+- **DNS lookups** - Query DNS records for any domain
+- **HTTP requests** - Test endpoints and inspect responses
+- **Domain information** - Look up WHOIS and RDAP registration data
+- **Certificate checks** - Inspect TLS/SSL certificates
+- **Connectivity tests** - Verify network reachability
+
+---
+
+## Limitations
+
+During the beta period:
+
+- Features and behaviors may change without notice
+- Write operations will always require explicit approval before execution