style edits

micheleRP · micheleRP · commit 706f1bd33dd5 · 2026-02-15T21:53:34.000-07:00
diff --git a/modules/ai-agents/pages/adp-overview.adoc b/modules/ai-agents/pages/adp-overview.adoc
@@ -7,31 +7,37 @@
 :learning-objective-2: Describe how each component addresses enterprise governance and reliability requirements
 :learning-objective-3: Determine whether Redpanda ADP fits your organization's requirements for AI agent deployment
 
-glossterm:AI agent[,AI agents] are moving from demos to production. Enterprises need governance, reliability, and cost control to deploy them safely. Redpanda Agentic Data Plane (ADP) combines a streaming-native immutable log, 300+ proven data connectors, and declarative AI agents into a unified platform with built-in compliance-grade audit trails.
+As glossterm:AI agent[,AI agents] evolve from experimental prototypes to business-critical systems, companies face new challenges. How do you ensure your AI agents are reliable? How do you maintain control over costs and compliance? And how do you scale them across your organization without creating technical debt?
+
+Redpanda Agentic Data Plane (ADP) solves these problems by bringing together key capabilities: a solid data foundation, over 300 proven connectors, and a declarative approach to building AI agents. The result is a unified platform that automatically tracks every agent decision for compliance and audit requirements.
 
 After reading this page, you will be able to:
 
 * [ ] {learning-objective-1}
 * [ ] {learning-objective-2}
 * [ ] {learning-objective-3}
 
-NOTE: The Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
 
-== AI Agents
+== AI agents
 
-Instead of writing Python or JavaScript, you declare the agent behavior you want and Redpanda handles execution and orchestration. You define behaviors in YAML, orchestrate multiple specialized glossterm:subagent[,sub-agents], or bring your own frameworks like LangChain or LlamaIndex.
+With Redpanda AI agents, you declare the agent behavior you want and Redpanda handles execution and orchestration. Instead of writing Python or JavaScript, you define behaviors in YAML, orchestrate multiple specialized glossterm:subagent[,sub-agents], or bring your own frameworks like LangChain or LlamaIndex.
 
 What makes this practical at scale is xref:develop:connect/about.adoc[Redpanda Connect]. More than 300 connectors with built-in filtering, enrichment, and routing give declarative definitions real power. Upcoming templates will provide default behaviors for common domains such as customer success, legal, and finance.
 
 The result is faster time-to-production, lower maintenance (declarative definitions instead of imperative code), and organizational consistency across teams.
 
-== MCP Servers
+For more information, see xref:ai-agents:agents/overview.adoc[].
+
+== MCP servers
 
 glossterm:MCP server[,MCP servers] translate agent intent into connections to databases, queues, HRIS, CRMs, and other business systems. They are the simplest way to give agents context and capabilities without writing glue code.
 
 Under the hood, MCP servers wrap the same proven connectors that power some of the world's largest e-commerce, EV, electricity, and AI companies. Built on xref:develop:connect/about.adoc[Redpanda Connect], they are lightweight, support OIDC-based authentication, and enforce deterministic policies at the tool level. You define tools in YAML, and policy enforcement programmatically prevents prompt injection, SQL injection, and other agent-based attacks.
 
-With over 300 connectors out-of-the-box and real-time debugging capabilities, you reduce integration time while getting enterprise-grade security. You can reuse your existing infrastructure and data sources rather than building new integrations from scratch.
+With 300+ out-of-the-box connectors and real-time debugging capabilities, you reduce integration time while getting enterprise-grade security. You can reuse your existing infrastructure and data sources rather than building new integrations from scratch.
+
+For more information, see xref:ai-agents:mcp/overview.adoc[MCP Servers Overview].
 
 == Transcripts
 
@@ -41,6 +47,8 @@ Transcripts are the keystone of agent governance. They are built on Redpanda's i
 
 Redpanda captures 100% of agent actions through OpenTelemetry standards, with end-to-end lineage across the entire execution chain. You can materialize execution logs to Iceberg tables for long-term retention and analysis, or replay them to evaluate and improve agent performance over time.
 
+For more information, see xref:ai-agents:observability/concepts.adoc[Transcripts Overview].
+
 == AI Gateway
 
 The AI Gateway manages LLM provider access with two priorities: keeping your application up and keeping costs under control.
@@ -49,6 +57,8 @@ For high availability, the gateway provides provider-agnostic routing with intel
 
 The gateway also supports tenancy modeling for teams, individuals, applications, and service accounts, giving you chargeback transparency for internal cost allocation. You can proxy both models and MCP gateways, centralizing compliance for all LLM interactions without locking into any single provider.
 
+For more information, see xref:ai-agents:ai-gateway/what-is-ai-gateway.adoc[AI Gateway Overview].
+
 == Enterprise governance
 
 Redpanda ADP addresses critical enterprise requirements across all components.
@@ -71,4 +81,7 @@ Organizations use Redpanda ADP to:
 
 == Next steps
 
-* xref:ai-agents:mcp/overview.adoc[]
+* xref:ai-agents:agents/overview.adoc[AI Agents Overview]
+* xref:ai-agents:mcp/overview.adoc[MCP Server Overview]
+* xref:ai-agents:observability/concepts.adoc[Transcripts Overview]
+* xref:ai-agents:ai-gateway/what-is-ai-gateway.adoc[AI Gateway Overview]
diff --git a/modules/ai-agents/pages/agents/index.adoc b/modules/ai-agents/pages/agents/index.adoc
@@ -2,4 +2,4 @@
 :page-layout: index
 :description: Declare agent behavior using built-in connectors in Redpanda Cloud. No custom agent code required.
 
-Declare agent behavior by selecting an LLM and connecting tools from 300+ built-in Redpanda Connect connectors with filtering and data enrichment built in. No Python or JavaScript agent code required.
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
diff --git a/modules/ai-agents/pages/observability/concepts.adoc b/modules/ai-agents/pages/observability/concepts.adoc
@@ -14,6 +14,8 @@ After reading this page, you will be able to:
 * [ ] {learning-objective-2}
 * [ ] {learning-objective-3}
 
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
+
 == What are transcripts
 
 A transcript records the complete execution of an agentic behavior from start to finish. It captures every step — across multiple agents, tools, models, and services — in a single, traceable record. The AI Gateway and every glossterm:AI agent[,agent] and glossterm:MCP server[] in your Agentic Data Plane (ADP) automatically emit OpenTelemetry traces to a glossterm:topic[] called `redpanda.otel_traces`. Redpanda's immutable distributed log stores these traces.
diff --git a/modules/ai-agents/pages/observability/index.adoc b/modules/ai-agents/pages/observability/index.adoc
@@ -2,4 +2,6 @@
 :page-layout: index
 :description: Govern agentic AI with complete execution transcripts built on Redpanda's immutable distributed log.
 
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
+
 {description}
diff --git a/modules/ai-agents/pages/observability/ingest-custom-traces.adoc b/modules/ai-agents/pages/observability/ingest-custom-traces.adoc
@@ -13,6 +13,8 @@ After reading this page, you will be able to:
 * [ ] {learning-objective-2}
 * [ ] {learning-objective-3}
 
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
+
 == Prerequisites
 
 * A BYOC cluster
diff --git a/modules/ai-agents/pages/observability/transcripts.adoc b/modules/ai-agents/pages/observability/transcripts.adoc
@@ -16,6 +16,8 @@ After reading this page, you will be able to:
 * [ ] {learning-objective-2}
 * [ ] {learning-objective-3}
 
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
+
 == Prerequisites
 
 * xref:ai-agents:agents/create-agent.adoc[Running agent] or xref:ai-agents:mcp/remote/quickstart.adoc[MCP server] with at least one execution
diff --git a/modules/ai-agents/pages/observability/view-transcripts.adoc b/modules/ai-agents/pages/observability/view-transcripts.adoc
@@ -22,6 +22,8 @@ For basic orientation on monitoring each Redpanda Agentic Data Plane component,
 
 For conceptual background on what transcripts capture and how glossterm:span[spans] are organized hierarchically, see xref:ai-agents:observability/concepts.adoc[].
 
+include::ai-agents:partial$ai-gateway-byoc-note.adoc[]
+
 == Prerequisites
 
 * xref:ai-agents:agents/create-agent.adoc[Running agent] or xref:ai-agents:mcp/remote/quickstart.adoc[MCP server] with at least one execution
diff --git a/modules/ai-agents/partials/ai-gateway-byoc-note.adoc b/modules/ai-agents/partials/ai-gateway-byoc-note.adoc
@@ -1 +1 @@
-NOTE: The Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.
+NOTE: Redpanda Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.
diff --git a/modules/get-started/pages/cloud-overview.adoc b/modules/get-started/pages/cloud-overview.adoc
@@ -2,22 +2,22 @@
 :description: Learn about the Redpanda Agentic Data Plane (ADP) and deployment options including BYOC, Dedicated, and Serverless clusters.
 :page-aliases: cloud:dedicated-byoc.adoc, deploy:deployment-option/cloud/dedicated-byoc.adoc, deploy:deployment-option/cloud/cloud-overview.adoc
 
-Redpanda Cloud is a complete data streaming and agentic data plane platform delivered as a fully-managed service. It provides automated upgrades and patching, data balancing, and support while continuously monitoring your clusters and underlying infrastructure to meet strict performance, availability, reliability, and security requirements. All Redpanda Cloud clusters are deployed with an integrated glossterm:Redpanda Console[], and all clusters have access to unlimited retention and 300+ data connectors with xref:develop:connect/about.adoc[Redpanda Connect].
+Redpanda Cloud is a complete data streaming and agentic data plane platform delivered as a fully-managed service. It provides automated upgrades and patching, data balancing, and support while continuously monitoring your data to meet strict performance, availability, reliability, and security requirements. All Redpanda Cloud clusters are deployed with an integrated glossterm:Redpanda Console[], and all clusters have access to unlimited retention and 300+ data connectors with glossterm:Redpanda Connect[].
 
 == Redpanda Agentic Data Plane (ADP)
 
-Redpanda Agentic Data Plane (ADP) is enterprise-grade infrastructure for building, deploying, and governing glossterm:AI agent[,AI agents] at scale. It combines Redpanda's streaming-native immutable log, 300+ proven data connectors, and declarative agent definitions into a unified platform with built-in governance, cost controls, and compliance-grade audit trails.
+Redpanda Agentic Data Plane (ADP) is enterprise-grade infrastructure for building, deploying, and governing glossterm:AI agent[,AI agents] at scale. It combines Redpanda's streaming-native immutable log, 300+ data connectors, and declarative agent definitions into a unified platform with built-in governance, cost controls, and compliance-grade audit trails.
 
 Redpanda ADP includes the following key components:
 
-* *AI Agents*: Declare the behavior you want instead of writing code. Redpanda powers declarative definitions with 300+ connectors.
-* *MCP Servers*: Translate agent intent into connections to your business systems using proven connectors, no glue code required.
+* *AI agents*: Declare the behavior you want instead of writing code. Redpanda powers declarative definitions with 300+ connectors.
+* *MCP servers*: Translate agent intent into connections to your business systems using proven connectors, no glue code required.
 * *Transcripts*: End-to-end execution records built on an immutable log with formal correctness guarantees. Transcripts are the keystone of agent governance.
 * *AI Gateway*: High-availability model routing with fiscal controls and per-tenant cost attribution across LLM providers.
 
-NOTE: The Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.
+NOTE: Redpanda Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.
 
-To learn what makes Redpanda's approach unique, see xref:ai-agents:adp-overview.adoc[].
+For more information, see xref:ai-agents:adp-overview.adoc[Redpanda Agentic Data Plane Overview].
 
 == Redpanda Cloud deployment options
 
@@ -91,11 +91,6 @@ Redpanda Cloud applications are supported by three fully-managed deployment opti
 | ✓
 | ✓
 
-| *Kafka Connect*
-| ✗
-| ✓ (disabled by default)
-| ✓ (disabled by default)
-
 | *RBAC & audit logs*
 | ✗
 | ✓
@@ -116,6 +111,11 @@ Redpanda Cloud applications are supported by three fully-managed deployment opti
 | ✓ (AWS/GCP)
 | ✓ (AWS/GCP)
 
+| *Kafka Connect*
+| ✗
+| ✓ (disabled by default)
+| ✓ (disabled by default)
+
 | *Redpanda Support*
 | Enterprise support with annual contracts 
 | Enterprise support 
@@ -326,10 +326,6 @@ xref:develop:connect/about.adoc[Redpanda Connect] lets you compose pipelines fro
 
 xref:develop:managed-connectors/index.adoc[Kafka Connect] is disabled by default on all new clusters. To unlock this feature for your BYOC or Dedicated cluster, contact https://support.redpanda.com/hc/en-us/requests/new[Redpanda Support^]. When enabled, a Kafka Connect node runs even if no connectors are configured.
 
-=== Redpanda Connect vs data transforms
-
-xref:develop:data-transforms/how-transforms-work.adoc[Data transforms] (Wasm) provide lightweight, per-record changes between Redpanda topics with minimal latency. Transforms run inside the broker, map one input topic to one or more output topics, and are intentionally sandboxed (no external network or disk access). They're ideal for validation, redaction, format/schema conversion, and simple routing.
-
 [cols="1,2,2",options="header",stripes=none]
 |===
 |  | Data transforms | Redpanda Connect
@@ -365,6 +361,10 @@ xref:develop:data-transforms/how-transforms-work.adoc[Data transforms] (Wasm) pr
 * Use Redpanda Connect if your pipeline must talk to external systems (HTTP services, databases, cloud storage), or when you need advanced flow control, such as batching and windowed processing. 
 ====
 
+=== Redpanda Connect vs data transforms
+
+xref:develop:data-transforms/how-transforms-work.adoc[Data transforms] (Wasm) provide lightweight, per-record changes between Redpanda topics with minimal latency. Transforms run inside the broker, map one input topic to one or more output topics, and are intentionally sandboxed (no external network or disk access). They're ideal for validation, redaction, format/schema conversion, and simple routing.
+
 == Redpanda Cloud vs Self-Managed feature compatibility
 
 Because Redpanda Cloud is a fully-managed service that provides maintenance, data and partition balancing, upgrades, and recovery, much of the cluster maintenance required for Self-Managed users is not necessary for Redpanda Cloud users. Also, Redpanda Cloud is opinionated about Kafka configurations. For example, automatic topic creation is disabled. Some systems expect the Kafka service to automatically create topics when a message is produced to a topic that doesn't exist. (You can enable this for BYOC and Dedicated clusters with the `auto_create_topics_enabled` cluster property.)
@@ -400,12 +400,14 @@ Redpanda Cloud deployments do not support the following functionality available
 +
 NOTE: The `rpk cloud` commands are not supported in Self-Managed deployments.
 
+
 == Features in limited availability
 
 Features in limited availability are production-ready and are covered by Redpanda Support for early adopters.
 
 The following features are currently in limited availability in Redpanda Cloud:
 
+* xref:ai-agents:adp-overview.adoc[Redpanda ADP] including AI agents, AI Gateway, and transcripts
 * Dedicated for Azure
 
 == Features in beta
@@ -416,23 +418,15 @@ The following features are currently in beta in Redpanda Cloud:
 
 * BYOVPC for AWS
 * BYOVNet for Azure
-* Secrets Management for BYOVPC on GCP and AWS
-* xref:ai-agents:index.adoc[Redpanda ADP] including AI agents, MCP servers, AI Gateway, and Transcripts
+* Secrets management for BYOVPC on GCP and AWS
 * Several Redpanda Connect components 
 
+include::shared:partial$suggested-video.adoc[]
+
+* https://www.youtube.com/watch?v=gVlzsJAYT64&ab_channel=RedpandaData[YouTube - What is Redpanda BYOC? (3 mins)^]
+
 == Next steps
 * xref:ai-agents:index.adoc[Build AI agents with Redpanda ADP]
 * xref:manage:maintenance.adoc[Learn about upgrades and maintenance]
 * xref:get-started:cluster-types/serverless.adoc[Create a Serverless cluster]
 * xref:get-started:cluster-types/byoc/index.adoc[Create a BYOC cluster]
-* xref:get-started:cluster-types/dedicated/create-dedicated-cloud-cluster-aws.adoc[Create a Dedicated cluster]
-
-include::shared:partial$suggested-reading.adoc[]
-
-* https://redpanda.com/blog/deploy-redpanda-clusters-cloud-aws-gcp[Bring Your Own Cloud (BYOC): best of both worlds^]
-
-* https://redpanda.com/blog/data-sovereignty-fully-managed-cloud-byoc[A middle path for data sovereignty: Bring Your Own Cloud^]
-
-include::shared:partial$suggested-video.adoc[]
-
-* https://www.youtube.com/watch?v=gVlzsJAYT64&ab_channel=RedpandaData[YouTube - What is Redpanda BYOC? (3 mins)^]

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-NOTE: The Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.`
	`1`	`+NOTE: Redpanda Agentic Data Plane is supported on BYOC clusters running with AWS and Redpanda version 25.3 and later.`