diff --git a/modules/connect/pages/a2a-concepts.adoc b/modules/connect/pages/a2a-concepts.adoc index aa62cbc..fce1853 100644 --- a/modules/connect/pages/a2a-concepts.adoc +++ b/modules/connect/pages/a2a-concepts.adoc @@ -1,4 +1,5 @@ = Connect Agents with A2A +:page-aliases: cloud-data-platform:ai-agents:agents/a2a-concepts.adoc, cloud-data-platform:ai-agents:agents/agent-to-agent-integration.adoc :description: The A2A protocol enables agents to discover and call each other across platforms. Learn how agent cards, authentication, and protocol versioning work in ADP. :page-topic-type: concepts :personas: agent_builder diff --git a/modules/connect/pages/agents-overview.adoc b/modules/connect/pages/agents-overview.adoc index 5b4b18c..155e528 100644 --- a/modules/connect/pages/agents-overview.adoc +++ b/modules/connect/pages/agents-overview.adoc @@ -1,5 +1,5 @@ = How Agents Work -:page-aliases: cloud-data-platform:ai-agents:agents/overview.adoc, connect:tutorials/index.adoc, connect:tutorials/customer-support-agent.adoc, connect:tutorials/transaction-dispute-resolution.adoc +:page-aliases: cloud-data-platform:ai-agents:agents/overview.adoc, connect:tutorials/index.adoc, connect:tutorials/customer-support-agent.adoc, connect:tutorials/transaction-dispute-resolution.adoc, cloud-data-platform:ai-agents:agents/tutorials/customer-support-agent.adoc, cloud-data-platform:ai-agents:agents/tutorials/transaction-dispute-resolution.adoc :description: Learn how ADP agents use a declarative approach backed by a broad library of prebuilt tools and integrations to replace custom agent code. :page-topic-type: overview :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/agents.adoc b/modules/connect/pages/agents.adoc index e0af0df..d79a9ce 100644 --- a/modules/connect/pages/agents.adoc +++ b/modules/connect/pages/agents.adoc @@ -1,4 +1,5 @@ = Build Agents +:page-aliases: cloud-data-platform:ai-agents:agents/index.adoc, cloud-data-platform:ai-agents:agents/build-index.adoc :description: Understand how AI agents work in the Agentic Data Plane, then create, register, and design them. :page-layout: index diff --git a/modules/connect/pages/architecture-patterns.adoc b/modules/connect/pages/architecture-patterns.adoc index 06897d3..b72efb4 100644 --- a/modules/connect/pages/architecture-patterns.adoc +++ b/modules/connect/pages/architecture-patterns.adoc @@ -1,4 +1,5 @@ = Choose an Agent Architecture +:page-aliases: cloud-data-platform:ai-agents:agents/architecture-patterns.adoc :description: Design maintainable agent systems with single-agent and multi-agent patterns based on domain complexity. :page-topic-type: best-practices :personas: agent_builder diff --git a/modules/connect/pages/claude-code.adoc b/modules/connect/pages/claude-code.adoc index ad9e1d1..21b542a 100644 --- a/modules/connect/pages/claude-code.adoc +++ b/modules/connect/pages/claude-code.adoc @@ -1,4 +1,5 @@ = Use Claude Code with Redpanda ADP +:page-aliases: cloud-data-platform:ai-agents:ai-gateway/integrations/claude-code-admin.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/claude-code-user.adoc :description: Route Claude Code through an ADP Anthropic provider for centralized credentials, usage tracking, and transcript logging. Optionally attach ADP-hosted MCP servers. :page-topic-type: how-to :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/concepts.adoc b/modules/connect/pages/concepts.adoc index d6d8e32..7299122 100644 --- a/modules/connect/pages/concepts.adoc +++ b/modules/connect/pages/concepts.adoc @@ -1,4 +1,5 @@ = Understand Agent Concepts +:page-aliases: cloud-data-platform:ai-agents:agents/concepts.adoc, cloud-data-platform:ai-agents:agents/fundamentals.adoc :description: Understand how declaratively configured agents execute reasoning loops, manage context, invoke tools, and handle errors. :page-topic-type: concepts :personas: agent_builder diff --git a/modules/connect/pages/create-agent.adoc b/modules/connect/pages/create-agent.adoc index db1d92e..2bc4291 100644 --- a/modules/connect/pages/create-agent.adoc +++ b/modules/connect/pages/create-agent.adoc @@ -1,4 +1,5 @@ = Create an Agent +:page-aliases: cloud-data-platform:ai-agents:agents/create-agent.adoc :description: Configure an ADP agent declaratively through the create form. No Python or JavaScript code required. :page-topic-type: how-to :personas: agent_builder diff --git a/modules/connect/pages/create-server.adoc b/modules/connect/pages/create-server.adoc index 467beff..ac5d74b 100644 --- a/modules/connect/pages/create-server.adoc +++ b/modules/connect/pages/create-server.adoc @@ -1,4 +1,5 @@ = Create an MCP Server +:page-aliases: cloud-data-platform:ai-agents:mcp/quickstart.adoc, cloud-data-platform:ai-agents:mcp/remote/quickstart.adoc :description: Create an MCP server in the Agentic Data Plane by picking a managed type from the marketplace or registering a self-managed server you host yourself, then configure authentication, code mode, and access. :page-topic-type: how-to :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/integration-overview.adoc b/modules/connect/pages/integration-overview.adoc index a85790e..687e860 100644 --- a/modules/connect/pages/integration-overview.adoc +++ b/modules/connect/pages/integration-overview.adoc @@ -1,4 +1,5 @@ = Choose an Integration Pattern +:page-aliases: cloud-data-platform:ai-agents:agents/integration-overview.adoc, cloud-data-platform:ai-agents:agents/integration-index.adoc, cloud-data-platform:ai-agents:agents/external-app-integration.adoc, cloud-data-platform:ai-agents:agents/external-integration.adoc :description: Choose the right integration pattern for connecting agents, pipelines, and external applications. :page-topic-type: best-practices :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/mcp-overview.adoc b/modules/connect/pages/mcp-overview.adoc index 5cf1daf..d09da37 100644 --- a/modules/connect/pages/mcp-overview.adoc +++ b/modules/connect/pages/mcp-overview.adoc @@ -1,4 +1,5 @@ = How MCP Servers Work +:page-aliases: cloud-data-platform:ai-agents:mcp/index.adoc, cloud-data-platform:ai-agents:mcp/overview.adoc, cloud-data-platform:ai-agents:mcp/remote/index.adoc, cloud-data-platform:ai-agents:mcp/remote/overview.adoc, cloud-data-platform:ai-agents:mcp/remote/concepts.adoc :description: Connect AI agents to your databases, APIs, and business systems through managed MCP servers Redpanda hosts for you, or self-managed servers you register with ADP. :page-topic-type: overview :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/mcp-servers.adoc b/modules/connect/pages/mcp-servers.adoc index 900e2d3..1e6e53e 100644 --- a/modules/connect/pages/mcp-servers.adoc +++ b/modules/connect/pages/mcp-servers.adoc @@ -1,4 +1,5 @@ = Connect Tools with MCP Servers +:page-aliases: cloud-data-platform:ai-agents:mcp/configuration.adoc, cloud-data-platform:ai-agents:mcp/remote/manage-servers.adoc, cloud-data-platform:ai-agents:mcp/remote/developer-guide.adoc, cloud-data-platform:ai-agents:mcp/remote/admin-guide.adoc, cloud-data-platform:ai-agents:mcp/remote/best-practices.adoc, cloud-data-platform:ai-agents:mcp/remote/scale-resources.adoc :description: Learn how MCP servers expose tools and data to agents, then plug in a managed type or build, register, and test your own. :page-layout: index diff --git a/modules/connect/pages/pipeline-integration-patterns.adoc b/modules/connect/pages/pipeline-integration-patterns.adoc index 9452a9a..0af0167 100644 --- a/modules/connect/pages/pipeline-integration-patterns.adoc +++ b/modules/connect/pages/pipeline-integration-patterns.adoc @@ -1,4 +1,5 @@ = Integrate with Redpanda Pipelines +:page-aliases: cloud-data-platform:ai-agents:agents/pipeline-integration-patterns.adoc, cloud-data-platform:ai-agents:mcp/remote/pipeline-patterns.adoc :description: Build Redpanda Connect pipelines that invoke agents for event-driven processing and streaming enrichment. :page-topic-type: best-practices :personas: agent_builder, platform_engineer diff --git a/modules/connect/pages/system-prompts.adoc b/modules/connect/pages/system-prompts.adoc index 8d91e5d..58b6b24 100644 --- a/modules/connect/pages/system-prompts.adoc +++ b/modules/connect/pages/system-prompts.adoc @@ -1,4 +1,5 @@ = Write Effective System Prompts +:page-aliases: cloud-data-platform:ai-agents:agents/prompt-best-practices.adoc :description: Write system prompts that produce reliable, predictable agent behavior through clear constraints and tool guidance. :page-topic-type: best-practices :personas: agent_builder diff --git a/modules/connect/pages/test-tools.adoc b/modules/connect/pages/test-tools.adoc index 6a7961f..ac366b0 100644 --- a/modules/connect/pages/test-tools.adoc +++ b/modules/connect/pages/test-tools.adoc @@ -1,4 +1,5 @@ = Test an MCP Server's Tools with the Inspector +:page-aliases: cloud-data-platform:ai-agents:mcp/remote/create-tool.adoc, cloud-data-platform:ai-agents:mcp/remote/tool-patterns.adoc :description: Use the Inspector tab to call tools, inspect resources and prompts, and verify your MCP server works without standing up an agent. :page-topic-type: how-to :personas: agent_builder diff --git a/modules/gateway/pages/code-mode.adoc b/modules/gateway/pages/code-mode.adoc index 3ec9888..15a0d11 100644 --- a/modules/gateway/pages/code-mode.adoc +++ b/modules/gateway/pages/code-mode.adoc @@ -1,5 +1,5 @@ = Code Mode -:page-aliases: aggregation.adoc +:page-aliases: aggregation.adoc, cloud-data-platform:ai-agents:ai-gateway/mcp-aggregation-guide.adoc :description: Turn on code mode for an MCP server to replace a large tool catalog with two tools, search and execute, and cut the token cost of tool-heavy servers. :page-topic-type: how-to :personas: agent_builder, platform_engineer diff --git a/modules/gateway/pages/configure-provider.adoc b/modules/gateway/pages/configure-provider.adoc index bde5979..ffc9408 100644 --- a/modules/gateway/pages/configure-provider.adoc +++ b/modules/gateway/pages/configure-provider.adoc @@ -1,4 +1,5 @@ = Configure an LLM Provider +:page-aliases: cloud-data-platform:ai-agents:ai-gateway/configure-provider.adoc, cloud-data-platform:ai-agents:ai-gateway/admin/secret-management.adoc :description: Create an LLM provider to proxy requests to OpenAI, Anthropic, Google AI, AWS Bedrock, or any OpenAI-compatible endpoint through Redpanda ADP. :page-topic-type: how-to :personas: platform_engineer, agent_builder diff --git a/modules/gateway/pages/connect-agent.adoc b/modules/gateway/pages/connect-agent.adoc index c7ff19e..0573591 100644 --- a/modules/gateway/pages/connect-agent.adoc +++ b/modules/gateway/pages/connect-agent.adoc @@ -2,7 +2,7 @@ :description: Point your application or AI agent at an AI Gateway provider's proxy URL. Covers the URL shape, the local development workflow with rpk ai, the OIDC client-credentials flow for CI and application code, and SDK examples for OpenAI, Anthropic, Google AI, AWS Bedrock, and OpenAI-compatible endpoints. :page-topic-type: how-to :personas: agent_builder -:page-aliases: cloud-data-platform:ai-agents:ai-gateway/builders/connect-your-agent.adoc +:page-aliases: cloud-data-platform:ai-agents:ai-gateway/builders/connect-your-agent.adoc, cloud-data-platform:ai-agents:ai-gateway/connect-agent.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/index.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/cline-admin.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/cline-user.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/continue-admin.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/continue-user.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/cursor-admin.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/cursor-user.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/github-copilot-admin.adoc, cloud-data-platform:ai-agents:ai-gateway/integrations/github-copilot-user.adoc :learning-objective-1: Construct the proxy URL for an LLM provider you have configured :learning-objective-2: pass:q[Authenticate to AI Gateway with `rpk` for local development or with OIDC client credentials for CI and programmatic clients] :learning-objective-3: Send requests through the proxy URL with the SDK of your choice diff --git a/modules/gateway/pages/overview.adoc b/modules/gateway/pages/overview.adoc index 522c4a3..6492c19 100644 --- a/modules/gateway/pages/overview.adoc +++ b/modules/gateway/pages/overview.adoc @@ -2,8 +2,7 @@ :description: AI Gateway is ADP's managed proxy for LLM APIs. Create a provider for OpenAI, Anthropic, Google AI, AWS Bedrock, or an OpenAI-compatible endpoint, and point your applications at a Redpanda-hosted URL with managed secrets, authentication, and observability. :page-topic-type: overview :personas: agent_builder, platform_engineer, security_compliance_lead -// TODO: Add 'cloud-data-platform:ai-agents:ai-gateway/what-is-ai-gateway.adoc' to page-aliases after ai-agents is removed from cloud-docs -:page-aliases: cloud-data-platform:ai-agents:ai-gateway/gateway-architecture.adoc, cloud-data-platform:ai-agents:ai-gateway/mcp-aggregation-guide.adoc, cloud-data-platform:ai-agents:ai-gateway/builders/discover-gateways.adoc, cloud-data-platform:ai-agents:ai-gateway/gateway-quickstart.adoc +:page-aliases: cloud-data-platform:ai-agents:ai-gateway/gateway-architecture.adoc, cloud-data-platform:ai-agents:ai-gateway/builders/discover-gateways.adoc, cloud-data-platform:ai-agents:ai-gateway/gateway-quickstart.adoc, cloud-data-platform:ai-agents:ai-gateway/what-is-ai-gateway.adoc, cloud-data-platform:ai-agents:ai-gateway/index.adoc, cloud-data-platform:ai-agents:ai-gateway/overview.adoc, cloud-data-platform:ai-agents:ai-gateway/ai-gateway.adoc, cloud-data-platform:ai-agents:ai-gateway/ai-gateway-overview.adoc, cloud-data-platform:ai-agents:ai-gateway/gateway-modes.adoc, cloud-data-platform:ai-agents:ai-gateway/migration-guide.adoc, cloud-data-platform:ai-agents:ai-gateway/cel-routing-cookbook.adoc, cloud-data-platform:ai-agents:ai-gateway/observability-logs.adoc, cloud-data-platform:ai-agents:ai-gateway/observability-metrics.adoc, cloud-data-platform:ai-agents:ai-gateway/quickstart-enhanced.adoc, cloud-data-platform:ai-agents:ai-gateway/admin/configure-ai-hub.adoc, cloud-data-platform:ai-agents:ai-gateway/admin/eject-to-custom-mode.adoc, cloud-data-platform:ai-agents:ai-gateway/admin/setup-guide.adoc, cloud-data-platform:ai-agents:ai-gateway/builders/use-ai-hub-gateway.adoc, cloud-data-platform:ai-agents:ai-gateway.adoc :learning-objective-1: Describe what AI Gateway is and how a managed proxy differs from direct upstream calls :learning-objective-2: Explain how LLM providers, secrets, and OIDC authentication fit together in AI Gateway :learning-objective-3: Identify use cases where AI Gateway fits, and use cases where it does not diff --git a/modules/get-started/pages/adp-overview.adoc b/modules/get-started/pages/adp-overview.adoc index f72489e..94a5c5e 100644 --- a/modules/get-started/pages/adp-overview.adoc +++ b/modules/get-started/pages/adp-overview.adoc @@ -7,8 +7,7 @@ :learning-objective-1: Identify the key components of Redpanda ADP and their purposes :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 -// TODO: Add 'cloud-data-platform:ai-agents:index.adoc' to page-aliases after ai-agents is removed from cloud-docs -:page-aliases: develop:agents/about.adoc, develop:ai-agents/about.adoc +:page-aliases: develop:agents/about.adoc, develop:ai-agents/about.adoc, cloud-data-platform:ai-agents:index.adoc, cloud-data-platform:ai-agents:overview.adoc, cloud-data-platform:ai-agents:adp-overview.adoc Enterprises spent decades building governance for their human workforce: identity, access control, audit trails, and accountability. They never built the same controls for glossterm:AI agent[,AI agents]. Most agents run with broad credentials, no identity of their own, and no record of what they did, which is why enterprise AI so often stalls before it reaches production. diff --git a/modules/get-started/pages/index.adoc b/modules/get-started/pages/index.adoc index a31275e..8e7a461 100644 --- a/modules/get-started/pages/index.adoc +++ b/modules/get-started/pages/index.adoc @@ -1,4 +1,5 @@ = Get Started +:page-aliases: cloud-data-platform:ai-agents:agents/get-started-index.adoc :description: Stand up Redpanda ADP and ship your first agent. :page-layout: index diff --git a/modules/monitor/pages/concepts.adoc b/modules/monitor/pages/concepts.adoc index f9a80fb..7e187f8 100644 --- a/modules/monitor/pages/concepts.adoc +++ b/modules/monitor/pages/concepts.adoc @@ -1,4 +1,5 @@ = How Observability Works +:page-aliases: cloud-data-platform:ai-agents:observability/concepts.adoc :description: Understand how Redpanda captures end-to-end execution transcripts on an immutable distributed log for agent governance and observability. :page-topic-type: concepts :personas: domain_evaluator, security_compliance_lead, platform_engineer, agent_builder diff --git a/modules/monitor/pages/index.adoc b/modules/monitor/pages/index.adoc index a358261..0ae773e 100644 --- a/modules/monitor/pages/index.adoc +++ b/modules/monitor/pages/index.adoc @@ -1,4 +1,5 @@ = Monitor & Debug +:page-aliases: cloud-data-platform:ai-agents:observability/index.adoc, cloud-data-platform:ai-agents:observability/monitor-mcp-servers.adoc, cloud-data-platform:ai-agents:observability/ingest-custom-traces.adoc, cloud-data-platform:ai-agents:mcp/remote/monitor-activity.adoc, cloud-data-platform:ai-agents:mcp/remote/monitor-mcp-servers.adoc :description: See what your agents did, investigate runs, and check speed, cost, and errors. :page-layout: index diff --git a/modules/monitor/pages/monitor-agents.adoc b/modules/monitor/pages/monitor-agents.adoc index c7fd49e..fc96fe6 100644 --- a/modules/monitor/pages/monitor-agents.adoc +++ b/modules/monitor/pages/monitor-agents.adoc @@ -1,4 +1,5 @@ = Monitor Agent Activity +:page-aliases: cloud-data-platform:ai-agents:observability/monitor-agents.adoc, cloud-data-platform:ai-agents:agents/monitor-agents.adoc :description: Monitor agent execution, analyze conversation history, track token usage, and debug issues using Inspector, Transcripts, and agent data topics. :page-topic-type: how-to :personas: agent_builder, platform_engineer, domain_evaluator diff --git a/modules/monitor/pages/transcripts.adoc b/modules/monitor/pages/transcripts.adoc index 72fb0f6..28c89e6 100644 --- a/modules/monitor/pages/transcripts.adoc +++ b/modules/monitor/pages/transcripts.adoc @@ -1,4 +1,5 @@ = See What Your Agent Did +:page-aliases: cloud-data-platform:ai-agents:observability/transcripts.adoc, cloud-data-platform:ai-agents:observability/view-transcripts.adoc :description: Open a transcript in ADP, read the conversation turn by turn, and investigate errors, costs, and performance. :page-topic-type: how-to :personas: agent_builder, domain_evaluator, platform_engineer, security_compliance_lead diff --git a/modules/monitor/pages/troubleshoot-ai-agents.adoc b/modules/monitor/pages/troubleshoot-ai-agents.adoc index 6c494fd..a21e22b 100644 --- a/modules/monitor/pages/troubleshoot-ai-agents.adoc +++ b/modules/monitor/pages/troubleshoot-ai-agents.adoc @@ -1,4 +1,5 @@ = Troubleshoot Agents +:page-aliases: cloud-data-platform:ai-agents:agents/troubleshooting.adoc, cloud-data-platform:ai-agents:mcp/remote/troubleshooting.adoc :description: Diagnose and fix common issues with AI agents including deployment failures, runtime behavior problems, and tool execution errors. :page-topic-type: troubleshooting :personas: agent_builder, platform_engineer