diff --git a/.github/test-docs.yml b/.github/test-docs.yml index cf008c0..5a0b7f0 100644 --- a/.github/test-docs.yml +++ b/.github/test-docs.yml @@ -80,7 +80,7 @@ jobs: create_issue_on_fail: true token: ${{ env.ACTIONS_BOT_TOKEN }} - - name: Test Redpanda Self-Managed quickstart + - name: Test Redpanda Streaming quickstart if: ${{ needs.setup.outputs.quickstart == 'true' || needs.setup.outputs.console == 'true' }} uses: doc-detective/github-action@v1 with: diff --git a/antora.yml b/antora.yml index a4bf55d..3d65c12 100644 --- a/antora.yml +++ b/antora.yml @@ -12,7 +12,7 @@ asciidoc: # Header configuration page-header-data: order: 1 - color: '#F77923' + color: '#ea580c' text-color: '#ffffff' # UI name for single-sourced content ui: Redpanda Cloud diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index cd793ec..46ab9b2 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -26,7 +26,7 @@ After reading this page, you will be able to: 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. You can orchestrate multiple specialized glossterm:subagent[,sub-agents], or bring your own frameworks like LangChain or LlamaIndex. -What makes this practical at scale is xref:redpanda-cloud: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. +What makes this practical at scale is xref:cloud-data-platform: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. diff --git a/modules/ROOT/partials/service-account-authorization.adoc b/modules/ROOT/partials/service-account-authorization.adoc index 5cf307a..ec3a2e5 100644 --- a/modules/ROOT/partials/service-account-authorization.adoc +++ b/modules/ROOT/partials/service-account-authorization.adoc @@ -53,4 +53,4 @@ The default Writer role provides broad access suitable for most use cases. If yo . Find the service account for your resource. . Edit the role bindings to use a more restrictive role or scope. -For more information about roles and permissions, see xref:redpanda-cloud:security:authorization/rbac/rbac.adoc[Role-based access control] or xref:redpanda-cloud:security:authorization/gbac/gbac.adoc[Group-based access control]. +For more information about roles and permissions, see xref:cloud-data-platform:security:authorization/rbac/rbac.adoc[Role-based access control] or xref:cloud-data-platform:security:authorization/gbac/gbac.adoc[Group-based access control]. diff --git a/modules/agents/pages/a2a-concepts.adoc b/modules/agents/pages/a2a-concepts.adoc index 5c96f76..4e00fa8 100644 --- a/modules/agents/pages/a2a-concepts.adoc +++ b/modules/agents/pages/a2a-concepts.adoc @@ -58,7 +58,7 @@ For integration pattern guidance, see xref:integration-overview.adoc[]. === Internal pipeline-to-agent integration -Redpanda Connect pipelines use the xref:redpanda-cloud:develop:connect/components/processors/a2a_message.adoc[`a2a_message`] processor to invoke agents for each event in a stream. This enables real-time interaction between streaming data and AI agents, enabling use cases like: +Redpanda Connect pipelines use the xref:cloud-data-platform:develop:connect/components/processors/a2a_message.adoc[`a2a_message`] processor to invoke agents for each event in a stream. This enables real-time interaction between streaming data and AI agents, enabling use cases like: * Real-time fraud detection on every transaction. * Streaming data enrichment with AI-generated fields. @@ -104,7 +104,7 @@ This flow ensures: External applications must authenticate using the service account credentials. Each agent has its own service account. -For step-by-step authentication instructions, see xref:redpanda-cloud:security:cloud-authentication.adoc[]. +For step-by-step authentication instructions, see xref:cloud-data-platform:security:cloud-authentication.adoc[]. === Internal integration diff --git a/modules/agents/pages/byoa-register.adoc b/modules/agents/pages/byoa-register.adoc index 793bb36..d0ff87c 100644 --- a/modules/agents/pages/byoa-register.adoc +++ b/modules/agents/pages/byoa-register.adoc @@ -1,4 +1,5 @@ = Register Your Own Agent (BYOA) :description: Connect your existing AI agent to Redpanda ADP for observability and governance. +:page-byoc-only: true // TODO: Add content diff --git a/modules/agents/pages/create-agent.adoc b/modules/agents/pages/create-agent.adoc index 674dbca..ea47fa1 100644 --- a/modules/agents/pages/create-agent.adoc +++ b/modules/agents/pages/create-agent.adoc @@ -1,5 +1,6 @@ = Create an Agent :description: Declaratively configure an agent by choosing an LLM, writing a system prompt, connecting tools from built-in connectors, and setting execution parameters. +:page-cloud-only: true :page-topic-type: how-to :personas: agent_developer, app_developer, streaming_developer :learning-objective-1: Configure an agent with model selection and system prompt diff --git a/modules/agents/pages/integration-overview.adoc b/modules/agents/pages/integration-overview.adoc index d522374..ec2de79 100644 --- a/modules/agents/pages/integration-overview.adoc +++ b/modules/agents/pages/integration-overview.adoc @@ -115,7 +115,7 @@ When integrating external applications with ADP agents, protect credentials and === Protect service account credentials -Store the client ID and secret in secure credential stores, not in code. Use environment variables or xref:redpanda-cloud:security:secrets.adoc[secrets management]. Rotate credentials if compromised and restrict access based on the principle of least privilege. +Store the client ID and secret in secure credential stores, not in code. Use environment variables or xref:cloud-data-platform:security:secrets.adoc[secrets management]. Rotate credentials if compromised and restrict access based on the principle of least privilege. === Protect access tokens diff --git a/modules/agents/pages/pipeline-integration-patterns.adoc b/modules/agents/pages/pipeline-integration-patterns.adoc index ed26b57..d5ffd54 100644 --- a/modules/agents/pages/pipeline-integration-patterns.adoc +++ b/modules/agents/pages/pipeline-integration-patterns.adoc @@ -18,7 +18,7 @@ This page focuses on pipelines calling agents (pipeline-initiated integration). == How pipelines invoke agents -Pipelines use the xref:redpanda-cloud:develop:connect/components/processors/a2a_message.adoc[`a2a_message`] processor to invoke agents for each event in a stream. The processor uses the xref:a2a-concepts.adoc[A2A protocol] to discover and communicate with agents. +Pipelines use the xref:cloud-data-platform:develop:connect/components/processors/a2a_message.adoc[`a2a_message`] processor to invoke agents for each event in a stream. The processor uses the xref:a2a-concepts.adoc[A2A protocol] to discover and communicate with agents. When the `a2a_message` processor receives an event, it sends the event data to the specified agent along with any prompt you provide. The agent processes the event using its reasoning capabilities and returns a response. The processor then adds the agent's response to the event for further processing or output. @@ -140,4 +140,4 @@ This pipeline: * xref:mcp:overview.adoc[] * xref:integration-overview.adoc[] * xref:a2a-concepts.adoc[] -* xref:redpanda-cloud:develop:connect/components/processors/about.adoc[] +* xref:cloud-data-platform:develop:connect/components/processors/about.adoc[] diff --git a/modules/agents/pages/tutorials/customer-support-agent.adoc b/modules/agents/pages/tutorials/customer-support-agent.adoc index 3d4a043..47e7776 100644 --- a/modules/agents/pages/tutorials/customer-support-agent.adoc +++ b/modules/agents/pages/tutorials/customer-support-agent.adoc @@ -36,7 +36,7 @@ The challenge: users phrase requests differently ("Where's my package?", "Track == Prerequisites -* A xref:redpanda-cloud:get-started:cluster-types/byoc/index.adoc[BYOC cluster]. +* A xref:cloud-data-platform:get-started:cluster-types/byoc/index.adoc[BYOC cluster]. * xref:ai-gateway:gateway-quickstart.adoc[AI Gateway configured] with at least one LLM provider enabled (this tutorial uses OpenAI). == Design the MCP tools diff --git a/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc b/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc index 630a947..c8daa7d 100644 --- a/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc +++ b/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc @@ -32,9 +32,9 @@ When a customer calls saying "I see a $247.83 charge from 'ACME CORP' but I neve == Prerequisites -* A xref:redpanda-cloud:get-started:cluster-types/byoc/index.adoc[BYOC cluster]. +* A xref:cloud-data-platform:get-started:cluster-types/byoc/index.adoc[BYOC cluster]. * xref:ai-gateway:gateway-quickstart.adoc[AI Gateway configured] with at least one LLM provider enabled (this tutorial uses OpenAI GPT-5.2 or Claude Sonnet 4.5 for reasoning). -* The xref:redpanda-cloud:manage:rpk/rpk-install.adoc[Redpanda CLI (`rpk`)] installed (for testing the pipeline with sample data). +* The xref:cloud-data-platform:manage:rpk/rpk-install.adoc[Redpanda CLI (`rpk`)] installed (for testing the pipeline with sample data). * Completed xref:tutorials/customer-support-agent.adoc[] (foundational multi-tool concepts). == Create MCP tools for each domain diff --git a/modules/ai-gateway/pages/connect-agent.adoc b/modules/ai-gateway/pages/connect-agent.adoc index cd4b35f..b64a94f 100644 --- a/modules/ai-gateway/pages/connect-agent.adoc +++ b/modules/ai-gateway/pages/connect-agent.adoc @@ -19,7 +19,7 @@ After completing this guide, you will be able to: * A configured LLM provider. If you haven't created one yet, see xref:ai-gateway:configure-provider.adoc[Configure an LLM provider]. * For local development, nothing else. You'll install `rpk ai` in the next section. -* For CI or programmatic clients: a Redpanda Cloud service account with OIDC client credentials. See xref:redpanda-cloud:security:cloud-authentication.adoc[Authenticate to Redpanda Cloud]. +* For CI or programmatic clients: a Redpanda Cloud service account with OIDC client credentials. See xref:cloud-data-platform:security:cloud-authentication.adoc[Authenticate to Redpanda Cloud]. + // TODO: confirm whether ADP hosts its own service-account IAM post-standalone, or continues to share Redpanda Cloud Organization IAM. * A development environment with your chosen programming language. diff --git a/modules/observability/pages/ingest-custom-traces.adoc b/modules/observability/pages/ingest-custom-traces.adoc index 32b03b9..87ac61a 100644 --- a/modules/observability/pages/ingest-custom-traces.adoc +++ b/modules/observability/pages/ingest-custom-traces.adoc @@ -19,7 +19,7 @@ After reading this page, you will be able to: * A Redpanda Connect pipeline host (today: a Redpanda BYOC cluster with Connect enabled). Ability to manage secrets on that host. // TODO: Replace with the standalone-ADP ingestion target once defined (may no longer require a Redpanda Cloud cluster). -* The latest version of xref:redpanda-cloud:manage:rpk/rpk-install.adoc[`rpk`] installed +* The latest version of xref:cloud-data-platform:manage:rpk/rpk-install.adoc[`rpk`] installed * Custom agent or application instrumented with OpenTelemetry SDK * Basic understanding of the https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-agent-spans/[OpenTelemetry span format^] and https://opentelemetry.io/docs/specs/otlp/[OpenTelemetry Protocol (OTLP)^] @@ -64,7 +64,7 @@ When these agents send traces to `redpanda.otel_traces`, you gain unified observ === Trace format requirements -Custom agents must emit traces in OTLP format. The xref:redpanda-connect:components:inputs/otlp_http.adoc[`otlp_http`] input accepts both OTLP Protobuf (`application/x-protobuf`) and JSON (`application/json`) payloads. For <>, use the xref:redpanda-connect:components:inputs/otlp_grpc.adoc[`otlp_grpc`] input. +Custom agents must emit traces in OTLP format. The xref:connect:components:inputs/otlp_http.adoc[`otlp_http`] input accepts both OTLP Protobuf (`application/x-protobuf`) and JSON (`application/json`) payloads. For <>, use the xref:connect:components:inputs/otlp_grpc.adoc[`otlp_grpc`] input. Each trace must follow the OTLP specification with these required fields: @@ -197,7 +197,7 @@ Configure your custom agent to send OpenTelemetry traces to the pipeline endpoin === Authenticate to the pipeline -The OTLP pipeline authenticates with a service account access token (today, while ingestion runs on a Redpanda BYOC cluster). Obtain an access token using your service account credentials as described in xref:redpanda-cloud:security:cloud-authentication.adoc#authenticate-to-the-cloud-api[Authenticate to the Cloud API]. +The OTLP pipeline authenticates with a service account access token (today, while ingestion runs on a Redpanda BYOC cluster). Obtain an access token using your service account credentials as described in xref:cloud-data-platform:security:cloud-authentication.adoc#authenticate-to-the-cloud-api[Authenticate to the Cloud API]. // TODO (standalone-ADP): Update the auth model when the standalone ADP ingestion path is defined. Include the token in your requests: @@ -621,5 +621,5 @@ If requests succeed but traces do not appear in `redpanda.otel_traces`: * xref:observability:transcripts.adoc[] * xref:agents:monitor.adoc[Observability for declarative agents] -* xref:redpanda-connect:components:inputs/otlp_http.adoc[OTLP HTTP input reference] -* xref:redpanda-connect:components:inputs/otlp_grpc.adoc[OTLP gRPC input reference] +* xref:connect:components:inputs/otlp_http.adoc[OTLP HTTP input reference] +* xref:connect:components:inputs/otlp_grpc.adoc[OTLP gRPC input reference] diff --git a/tests/docker-compose/transform/README.adoc b/tests/docker-compose/transform/README.adoc index 4485435..0b2dc63 100644 --- a/tests/docker-compose/transform/README.adoc +++ b/tests/docker-compose/transform/README.adoc @@ -1,6 +1,6 @@ = Modify the Wasm Transform in the Quickstart -This directory contains the Go source code (`transform.go`) for the data transform that is used in the Redpanda Self-Managed quickstart. +This directory contains the Go source code (`transform.go`) for the data transform that is used in the Redpanda Streaming quickstart. If you're following the quickstart, you *do not* need to modify or rebuild this code. The Docker Compose configuration automatically deploys a pre-built transform called `regex.wasm`. However, if you want to customize the data transform logic, continue reading.