Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/connect/pages/a2a-concepts.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion modules/connect/pages/agents-overview.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/agents.adoc
Original file line number Diff line number Diff line change
@@ -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

Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/architecture-patterns.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/claude-code.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/concepts.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/create-agent.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/create-server.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/integration-overview.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/mcp-overview.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/mcp-servers.adoc
Original file line number Diff line number Diff line change
@@ -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

Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/pipeline-integration-patterns.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/system-prompts.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/connect/pages/test-tools.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion modules/gateway/pages/code-mode.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/gateway/pages/configure-provider.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion modules/gateway/pages/connect-agent.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 1 addition & 2 deletions modules/gateway/pages/overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 1 addition & 2 deletions modules/get-started/pages/adp-overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
1 change: 1 addition & 0 deletions modules/get-started/pages/index.adoc
Original file line number Diff line number Diff line change
@@ -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

Expand Down
1 change: 1 addition & 0 deletions modules/monitor/pages/concepts.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/monitor/pages/index.adoc
Original file line number Diff line number Diff line change
@@ -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

Expand Down
1 change: 1 addition & 0 deletions modules/monitor/pages/monitor-agents.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/monitor/pages/transcripts.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions modules/monitor/pages/troubleshoot-ai-agents.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down