From 8b3dde3791f59dd836e7b011da28ffe181af059f Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 26 May 2026 16:28:39 -0600 Subject: [PATCH 1/3] Replace ad-hoc persona slugs with product-design-approved ADP vocabulary Replace the prior 7-slug list (app_developer, agent_developer, ai_agent_developer, platform_admin, evaluator, streaming_developer, data_engineer) across every .adoc page with 5 role-based slugs sourced from the ADP product persona set: * security_compliance_lead * platform_engineer * agent_builder * domain_evaluator * pilot_lead Add docs-data/personas.yaml as the canonical registry, matching the schema used in cloud-docs, rp-connect-docs, and redpanda-labs. Slugs are descriptive role names; no character names appear in the registry or in page metadata. Each page's :personas: line was chosen by reading the page (intro, topic type, learning objectives) and picking the 1-3 personas that genuinely match its audience. :personas: is also added to 45 pages that previously lacked it (index pages, reference pages, stubs). Pure include fragments (no document title or description) are intentionally left untagged; they inherit personas from the including page. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs-data/personas.yaml | 171 ++++++++++++++++++ modules/ROOT/pages/index.adoc | 2 +- .../partials/ai-hub/configure-ai-hub.adoc | 2 +- .../partials/ai-hub/eject-to-custom-mode.adoc | 2 +- .../ROOT/partials/ai-hub/gateway-modes.adoc | 2 +- .../partials/ai-hub/use-ai-hub-gateway.adoc | 2 +- .../integrations/claude-code-admin.adoc | 2 +- .../integrations/claude-code-user.adoc | 2 +- .../partials/integrations/cline-admin.adoc | 2 +- .../partials/integrations/cline-user.adoc | 2 +- .../partials/integrations/continue-admin.adoc | 2 +- .../partials/integrations/continue-user.adoc | 2 +- .../partials/integrations/cursor-admin.adoc | 2 +- .../partials/integrations/cursor-user.adoc | 2 +- .../integrations/github-copilot-admin.adoc | 2 +- .../integrations/github-copilot-user.adoc | 2 +- modules/ROOT/partials/integrations/index.adoc | 1 + modules/ROOT/partials/migration-guide.adoc | 2 +- modules/ROOT/partials/observability-logs.adoc | 2 +- .../ROOT/partials/observability-metrics.adoc | 2 +- modules/agents/pages/a2a-concepts.adoc | 2 +- .../agents/pages/architecture-patterns.adoc | 2 +- modules/agents/pages/build-index.adoc | 1 + modules/agents/pages/byoa-register.adoc | 2 +- modules/agents/pages/concepts.adoc | 2 +- modules/agents/pages/create-agent.adoc | 2 +- modules/agents/pages/get-started-index.adoc | 1 + modules/agents/pages/index.adoc | 1 + modules/agents/pages/integration-index.adoc | 1 + .../agents/pages/integration-overview.adoc | 2 +- modules/agents/pages/monitor.adoc | 2 +- modules/agents/pages/overview.adoc | 2 +- .../pages/pipeline-integration-patterns.adoc | 2 +- modules/agents/pages/quickstart.adoc | 2 +- modules/agents/pages/system-prompts.adoc | 2 +- modules/agents/pages/troubleshoot/index.adoc | 1 + .../troubleshoot/troubleshoot-ai-agents.adoc | 2 +- .../tutorials/customer-support-agent.adoc | 2 +- modules/agents/pages/tutorials/index.adoc | 1 + .../transaction-dispute-resolution.adoc | 2 +- modules/ai-gateway/pages/admin/index.adoc | 1 + .../ai-gateway/pages/admin/setup-guide.adoc | 2 +- modules/ai-gateway/pages/aggregation.adoc | 2 +- modules/ai-gateway/pages/bedrock-setup.adoc | 2 +- .../pages/builders/discover-gateways.adoc | 2 +- modules/ai-gateway/pages/builders/index.adoc | 1 + .../ai-gateway/pages/configure-provider.adoc | 2 +- modules/ai-gateway/pages/connect-agent.adoc | 2 +- .../pages/gateway-architecture.adoc | 2 +- .../ai-gateway/pages/gateway-quickstart.adoc | 2 +- modules/ai-gateway/pages/index.adoc | 1 + modules/ai-gateway/pages/overview.adoc | 2 +- .../partials/ai-hub/configure-ai-hub.adoc | 2 +- .../partials/ai-hub/eject-to-custom-mode.adoc | 2 +- .../partials/ai-hub/gateway-modes.adoc | 2 +- .../partials/ai-hub/use-ai-hub-gateway.adoc | 2 +- modules/get-started/pages/byoc-prereqs.adoc | 2 +- .../get-started/pages/byoc-quickstart.adoc | 2 +- modules/get-started/pages/first-agent.adoc | 1 + modules/get-started/pages/index.adoc | 1 + modules/get-started/pages/rpk-install.adoc | 1 + modules/governance/pages/budgets.adoc | 3 +- modules/governance/pages/dashboard/index.adoc | 1 + .../governance/pages/dashboard/overview.adoc | 2 +- .../pages/guardrails/cost-tracking.adoc | 3 +- .../pages/guardrails/create-guardrail.adoc | 3 +- .../governance/pages/guardrails/index.adoc | 1 + .../governance/pages/guardrails/overview.adoc | 3 +- .../pages/guardrails/types-reference.adoc | 3 +- .../pages/guardrails/violations.adoc | 3 +- modules/governance/pages/index.adoc | 1 + modules/governance/pages/kill-switch.adoc | 1 + .../pages/permissions-overview.adoc | 2 +- .../pages/permissions-reference.adoc | 2 +- modules/integrations/pages/claude-code.adoc | 2 +- modules/integrations/pages/cline.adoc | 1 + modules/integrations/pages/continue.adoc | 1 + modules/integrations/pages/copilot.adoc | 1 + modules/integrations/pages/cursor.adoc | 1 + modules/integrations/pages/index.adoc | 1 + .../pages/remote-mcp-clients.adoc | 2 +- .../integrations/claude-code-admin.adoc | 2 +- .../integrations/claude-code-user.adoc | 2 +- .../partials/integrations/cline-admin.adoc | 2 +- .../partials/integrations/cline-user.adoc | 2 +- .../partials/integrations/continue-admin.adoc | 2 +- .../partials/integrations/continue-user.adoc | 2 +- .../partials/integrations/cursor-admin.adoc | 2 +- .../partials/integrations/cursor-user.adoc | 2 +- .../integrations/github-copilot-admin.adoc | 2 +- .../integrations/github-copilot-user.adoc | 2 +- .../partials/integrations/index.adoc | 1 + modules/mcp/pages/create-server.adoc | 2 +- modules/mcp/pages/github-oauth-tutorial.adoc | 2 +- modules/mcp/pages/index.adoc | 1 + modules/mcp/pages/managed/bamboohr.adoc | 2 +- modules/mcp/pages/managed/index.adoc | 1 + modules/mcp/pages/managed/ironclad.adoc | 2 +- modules/mcp/pages/managed/jira.adoc | 2 +- modules/mcp/pages/managed/kafka.adoc | 2 +- .../mcp/pages/managed/managed-catalog.adoc | 2 +- modules/mcp/pages/managed/metabase.adoc | 2 +- modules/mcp/pages/managed/netsuite.adoc | 2 +- modules/mcp/pages/managed/openapi.adoc | 2 +- modules/mcp/pages/managed/ramp.adoc | 2 +- modules/mcp/pages/managed/slack.adoc | 2 +- modules/mcp/pages/managed/sql.adoc | 2 +- modules/mcp/pages/managed/workday.adoc | 2 +- modules/mcp/pages/managed/zendesk.adoc | 2 +- modules/mcp/pages/oauth-providers.adoc | 2 +- modules/mcp/pages/overview.adoc | 2 +- modules/mcp/pages/register-remote.adoc | 2 +- modules/mcp/pages/test-tools.adoc | 2 +- modules/mcp/pages/user-delegated-oauth.adoc | 2 +- .../observability/pages/byoa-telemetry.adoc | 2 +- modules/observability/pages/concepts.adoc | 2 +- modules/observability/pages/index.adoc | 1 + .../pages/ingest-custom-traces.adoc | 1 + modules/observability/pages/logs.adoc | 1 + modules/observability/pages/metrics.adoc | 1 + modules/observability/pages/transcripts.adoc | 2 +- .../partials/observability-logs.adoc | 2 +- .../partials/observability-metrics.adoc | 2 +- modules/reference/pages/api.adoc | 1 + modules/reference/pages/glossary.adoc | 1 + modules/reference/pages/index.adoc | 1 + .../reference/pages/pipeline-examples.adoc | 1 + modules/reference/pages/rpk/index.adoc | 1 + .../pages/rpk/rpk-ai/rpk-ai-install.adoc | 1 + .../pages/rpk/rpk-ai/rpk-ai-uninstall.adoc | 1 + .../pages/rpk/rpk-ai/rpk-ai-upgrade.adoc | 1 + .../reference/pages/rpk/rpk-ai/rpk-ai.adoc | 1 + .../rpk-cloud/rpk-cloud-cluster-select.adoc | 1 + .../rpk/rpk-cloud/rpk-cloud-cluster.adoc | 1 + .../pages/rpk/rpk-cloud/rpk-cloud-login.adoc | 1 + .../pages/rpk/rpk-cloud/rpk-cloud-logout.adoc | 1 + .../pages/rpk/rpk-cloud/rpk-cloud.adoc | 1 + .../pages/rpk/rpk-profile/rpk-profile.adoc | 1 + .../reference/pages/rpk/rpk-x-options.adoc | 1 + 139 files changed, 309 insertions(+), 99 deletions(-) create mode 100644 docs-data/personas.yaml diff --git a/docs-data/personas.yaml b/docs-data/personas.yaml new file mode 100644 index 0000000..19b3209 --- /dev/null +++ b/docs-data/personas.yaml @@ -0,0 +1,171 @@ +# Redpanda ADP (Agentic Data Plane) Documentation Personas +# +# These personas represent the target audience for adp-docs. +# Use these IDs when assigning :personas: attributes to documentation pages. +# +# Vocabulary is product-design-approved for the ADP product. Each persona +# describes a role and a set of constraints, not a specific person — slugs +# are role-based and do not reference characters used elsewhere in product +# research artifacts. +# +# Choose the minimum set of personas that genuinely fits the page. A page +# tagged with all five is usually a sign the persona line is not adding signal. + +schema_version: "1.0" +repository: adp-docs + +personas: + # ============================================================================ + # GOVERNANCE + # The personas who decide whether ADP gets into the building. + # ============================================================================ + + - id: security_compliance_lead + name: Security and Compliance Lead + description: Security and compliance owner who must sign off on AI workloads before they ship. Needs evidence — prompt and output logs, data-flow diagrams, attestations — not vendor assurances. + experience_level: advanced + goals: + - Establish defensible audit trails for every AI request and response + - Produce regulator-ready compliance evidence without manual report-building + - Map data flows across every AI provider before procurement opens a ticket + - Maintain an AI inventory the board and risk committee can trust + - Approve workloads that meet SOC 2, BAA, and sector-specific obligations + pain_points: + - Past incidents where third-party AI tools captured sensitive data without disclosure + - Vendor claims about ephemeral or non-retained data with no attestation behind them + - Compliance reviews assembled by hand instead of generated by the platform + - No central inventory of which agents touch which data + - Logging that's labeled "audit-ready" but doesn't include prompts and outputs + content_preferences: + - Documented data-flow diagrams and storage locations + - Audit log examples with prompt and output fields + - Compliance attestation references (SOC 2, HIPAA-adjacent, BAA) + - Step-by-step procedures for incident response and access revocation + - Reference tables of what is and is not retained, and for how long + typical_content_types: + - reference + - how-to + - concepts + - best-practices + + - id: platform_engineer + name: Platform Engineer + description: Owns the paved path for AI adoption across application teams. Cares about APIs, automation, observability, blast radius, and cost attribution. Allergic to UI-only configuration and to tools that generate platform-team support load. + experience_level: advanced + goals: + - Provide a self-serve, governed path for application teams to use AI Gateway and MCP + - Wire ADP into existing CI/CD, IaC, and secrets-management systems + - Make cost attributable per team so showback is possible from day one + - Set up observability that surfaces real failure modes, not just happy-path metrics + - Run the platform without expanding the platform team's on-call load + pain_points: + - Tools that look easy for users but generate platform-team tickets + - Configuration that lives only in UIs with no API or CLI behind it + - Cost models that can't attribute spend to the team that incurred it + - Onboarding gated behind sales calls when the docs should suffice + - Hidden runtime dependencies that surface as memory leaks or outages in production + content_preferences: + - API and CLI references with copy-pasteable examples + - Terraform, Helm, and CI templates + - Rate-limit, retry, and idempotency documentation + - Observability integration guides (Datadog, OpenTelemetry, Prometheus) + - Failure-mode catalogs, blast-radius analysis, and clear escalation paths + typical_content_types: + - reference + - how-to + - troubleshooting + - best-practices + + # ============================================================================ + # BUILDERS + # The personas who actually use ADP to build and validate AI workloads. + # ============================================================================ + + - id: agent_builder + name: Agent Builder + description: Builds and ships AI agents and workflows that solve a specific business problem. Reads docs to get unblocked on a concrete task, not to study. Spans low-code automators and software engineers writing against the SDK — what they share is a goal-driven, demo-driven mindset and impatience with anything that doesn't deliver value in the first session. + experience_level: intermediate + goals: + - Build a working agent or workflow in the first session + - Wire an existing agent or application into AI Gateway, MCP Gateway, or a managed MCP server + - Ship something demoable to leadership within the first sprint + - Iterate on agent behavior without breaking production + - Validate that the agent behaves as expected before turning on traffic + pain_points: + - Quickstarts that don't actually start in the time the page promises + - Examples written in languages or SDKs the builder doesn't use + - Silent failures in deployed flows with no notification path + - Free trials gated behind sales calls + - Tooling that requires IT approval before the builder can even try it + content_preferences: + - Quickstarts that produce a visible result in under an hour + - SDK examples in multiple languages (Python, TypeScript, Go) + - Step-by-step screenshots and short procedures + - Integration recipes for Cursor, Cline, Copilot, Continue, and similar coding assistants + - Tutorials that build toward a story a builder can tell their manager + typical_content_types: + - quickstart + - tutorial + - how-to + - cookbook + + - id: domain_evaluator + name: Domain Evaluator + description: Subject-matter expert who is the final line of defense between an agent's output and the work product it feeds. Verifies sources, tests edge cases, and refuses to champion a tool until verification time is meaningfully lower than the time it saves. + experience_level: intermediate + goals: + - Verify that agent outputs are accurate, sourced, and defensible + - Test agents against real documents and real edge cases before they touch production work + - Reduce time spent re-checking agent output without losing accuracy + - Establish trust criteria the rest of the team can adopt + - Catch and report regressions in agent behavior + pain_points: + - Tools that can't show their sources or surface citation provenance + - Outputs that vary across identical inputs + - Past incidents where an AI-generated artifact contained fabricated facts + - No clear answer on how confidential or privileged data is handled + - Demos that don't reflect real-world edge cases + content_preferences: + - Pages that explain how outputs are grounded — sources, retrieval, citations + - Eval traces, replay logs, and reproducibility documentation + - Edge-case test patterns and accuracy benchmarks + - Confidential-data handling and isolation guarantees + - Comparison tables across model behaviors on the same input + typical_content_types: + - concepts + - how-to + - reference + - best-practices + + # ============================================================================ + # BRIDGE + # The persona who owns making the rollout stick. + # ============================================================================ + + - id: pilot_lead + name: Pilot Lead + description: Operations or team lead running an ADP pilot or first rollout. Sits between governance and builders — neither group naturally asks about adoption metrics, day-2 support, or the onboarding experience for the next teammate. Owns the success or failure of the pilot publicly. + experience_level: intermediate + goals: + - Roll out ADP to a single team with metrics they can defend in a VP one-on-one + - Onboard new team members onto agents in under an hour + - Surface errors and usage in dashboards the team can act on + - Make adoption repeatable so it can scale to the next team + - Avoid championing a tool whose day-2 experience falls apart + pain_points: + - Tools that work in pilot but break at scale + - Errors that aren't visible to the team owning them + - Onboarding paths that assume engineering background a non-technical team doesn't have + - Metrics that look good in demos but don't map to a business outcome + - Day-2 support tickets landing on a platform team that didn't sign up for them + content_preferences: + - Adoption playbooks and rollout checklists + - Dashboards that show usage, errors, and outcomes per team + - Onboarding guides written for the new joiner, not the original champion + - Escalation and incident-response paths + - Reference architectures from comparable rollouts + typical_content_types: + - overview + - how-to + - best-practices + - tutorial diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index 2f0d254..52ab2fe 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -3,7 +3,7 @@ :page-layout: index :page-topic-type: overview :page-categories: Agentic Data Plane -:personas: evaluator, ai_agent_developer, platform_admin +:personas: agent_builder, platform_engineer, security_compliance_lead, pilot_lead, domain_evaluator :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 diff --git a/modules/ROOT/partials/ai-hub/configure-ai-hub.adoc b/modules/ROOT/partials/ai-hub/configure-ai-hub.adoc index 2d4daf6..400235d 100644 --- a/modules/ROOT/partials/ai-hub/configure-ai-hub.adoc +++ b/modules/ROOT/partials/ai-hub/configure-ai-hub.adoc @@ -1,7 +1,7 @@ = Configure AI Hub Gateway :description: Create and configure zero-config AI Hub gateways with pre-configured routing and backend pools. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Create an AI Hub gateway with one-click configuration :learning-objective-2: Configure user preference toggles to customize routing behavior :learning-objective-3: Manage provider credentials for OpenAI, Anthropic, and Google Gemini diff --git a/modules/ROOT/partials/ai-hub/eject-to-custom-mode.adoc b/modules/ROOT/partials/ai-hub/eject-to-custom-mode.adoc index 4fd200c..1442614 100644 --- a/modules/ROOT/partials/ai-hub/eject-to-custom-mode.adoc +++ b/modules/ROOT/partials/ai-hub/eject-to-custom-mode.adoc @@ -1,7 +1,7 @@ = Eject to Custom Mode :description: Transition an AI Hub gateway to Custom mode for full configuration control. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Evaluate the implications of ejecting from AI Hub to Custom mode :learning-objective-2: Prepare for ejection by documenting current configuration :learning-objective-3: Execute the ejection process and configure the gateway post-ejection diff --git a/modules/ROOT/partials/ai-hub/gateway-modes.adoc b/modules/ROOT/partials/ai-hub/gateway-modes.adoc index bdb490e..19deda3 100644 --- a/modules/ROOT/partials/ai-hub/gateway-modes.adoc +++ b/modules/ROOT/partials/ai-hub/gateway-modes.adoc @@ -1,7 +1,7 @@ = AI Gateway Modes :description: Understand AI Hub mode and Custom mode, and choose the right approach for your organization. :page-topic-type: concept -:personas: evaluator, platform_admin, app_developer +:personas: platform_engineer, agent_builder :learning-objective-1: Differentiate between AI Hub and Custom gateway modes :learning-objective-2: Determine which mode suits your use case based on configuration needs :learning-objective-3: Identify which mode a gateway is running in using Console or API diff --git a/modules/ROOT/partials/ai-hub/use-ai-hub-gateway.adoc b/modules/ROOT/partials/ai-hub/use-ai-hub-gateway.adoc index 5a899a2..a751560 100644 --- a/modules/ROOT/partials/ai-hub/use-ai-hub-gateway.adoc +++ b/modules/ROOT/partials/ai-hub/use-ai-hub-gateway.adoc @@ -1,7 +1,7 @@ = Use AI Hub Gateway :description: Connect to and use AI Hub mode gateways with pre-configured intelligent routing. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder :learning-objective-1: Identify whether a gateway is running in AI Hub mode :learning-objective-2: Connect your application to an AI Hub gateway using the OpenAI SDK :learning-objective-3: Describe how intelligent routing directs requests to providers diff --git a/modules/ROOT/partials/integrations/claude-code-admin.adoc b/modules/ROOT/partials/integrations/claude-code-admin.adoc index d017153..2cbde5d 100644 --- a/modules/ROOT/partials/integrations/claude-code-admin.adoc +++ b/modules/ROOT/partials/integrations/claude-code-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Claude Code :description: Configure Redpanda AI Gateway to support Claude Code clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Claude Code connectivity :learning-objective-2: Set up authentication and access control for Claude Code clients :learning-objective-3: Deploy MCP tool aggregation for Claude Code tool discovery diff --git a/modules/ROOT/partials/integrations/claude-code-user.adoc b/modules/ROOT/partials/integrations/claude-code-user.adoc index e2f83c6..a529ce7 100644 --- a/modules/ROOT/partials/integrations/claude-code-user.adoc +++ b/modules/ROOT/partials/integrations/claude-code-user.adoc @@ -1,7 +1,7 @@ = Configure Claude Code with AI Gateway :description: Configure Claude Code to use Redpanda AI Gateway for unified LLM access and MCP tool aggregation. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Claude Code to connect to AI Gateway endpoints :learning-objective-2: Set up MCP server integration through AI Gateway :learning-objective-3: Verify Claude Code is routing requests through the gateway diff --git a/modules/ROOT/partials/integrations/cline-admin.adoc b/modules/ROOT/partials/integrations/cline-admin.adoc index b537498..0b01234 100644 --- a/modules/ROOT/partials/integrations/cline-admin.adoc +++ b/modules/ROOT/partials/integrations/cline-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Cline :description: Configure Redpanda AI Gateway to support Cline clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Cline connectivity :learning-objective-2: Set up authentication and access control for Cline clients :learning-objective-3: Deploy MCP tool aggregation for Cline tool discovery diff --git a/modules/ROOT/partials/integrations/cline-user.adoc b/modules/ROOT/partials/integrations/cline-user.adoc index 7103fc6..114786b 100644 --- a/modules/ROOT/partials/integrations/cline-user.adoc +++ b/modules/ROOT/partials/integrations/cline-user.adoc @@ -1,7 +1,7 @@ = Configure Cline with AI Gateway :description: Configure Cline to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and autonomous coding workflows. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Cline to connect to AI Gateway for LLM requests and MCP tools :learning-objective-2: Set up autonomous mode with custom instructions and browser integration :learning-objective-3: Verify Cline routes requests through the gateway and optimize for cost diff --git a/modules/ROOT/partials/integrations/continue-admin.adoc b/modules/ROOT/partials/integrations/continue-admin.adoc index 5b49a82..b802390 100644 --- a/modules/ROOT/partials/integrations/continue-admin.adoc +++ b/modules/ROOT/partials/integrations/continue-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Continue.dev :description: Configure Redpanda AI Gateway to support Continue.dev clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Continue.dev connectivity :learning-objective-2: Set up multi-provider backends with native format routing :learning-objective-3: Deploy MCP tool aggregation for Continue.dev tool discovery diff --git a/modules/ROOT/partials/integrations/continue-user.adoc b/modules/ROOT/partials/integrations/continue-user.adoc index aa7dc58..07fa900 100644 --- a/modules/ROOT/partials/integrations/continue-user.adoc +++ b/modules/ROOT/partials/integrations/continue-user.adoc @@ -1,7 +1,7 @@ = Configure Continue.dev with AI Gateway :description: Configure Continue.dev to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and AI-assisted coding. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Continue.dev to connect to AI Gateway for chat and autocomplete :learning-objective-2: Set up MCP server integration through AI Gateway :learning-objective-3: Optimize Continue.dev settings for cost and performance diff --git a/modules/ROOT/partials/integrations/cursor-admin.adoc b/modules/ROOT/partials/integrations/cursor-admin.adoc index 1dd2e28..7df52c0 100644 --- a/modules/ROOT/partials/integrations/cursor-admin.adoc +++ b/modules/ROOT/partials/integrations/cursor-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Cursor IDE :description: Configure Redpanda AI Gateway to support Cursor IDE clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Cursor IDE connectivity :learning-objective-2: Set up OpenAI-compatible transforms for multi-provider routing :learning-objective-3: Deploy multi-tenant authentication strategies for Cursor clients diff --git a/modules/ROOT/partials/integrations/cursor-user.adoc b/modules/ROOT/partials/integrations/cursor-user.adoc index f60fe4c..4d5f0af 100644 --- a/modules/ROOT/partials/integrations/cursor-user.adoc +++ b/modules/ROOT/partials/integrations/cursor-user.adoc @@ -1,7 +1,7 @@ = Configure Cursor IDE with AI Gateway :description: Configure Cursor IDE to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and AI-assisted coding. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Cursor IDE to route LLM requests through AI Gateway :learning-objective-2: Set up MCP server integration for tool access through the gateway :learning-objective-3: Optimize Cursor settings for multi-tenancy and cost control diff --git a/modules/ROOT/partials/integrations/github-copilot-admin.adoc b/modules/ROOT/partials/integrations/github-copilot-admin.adoc index 7247880..c4eb526 100644 --- a/modules/ROOT/partials/integrations/github-copilot-admin.adoc +++ b/modules/ROOT/partials/integrations/github-copilot-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for GitHub Copilot :description: Configure Redpanda AI Gateway to support GitHub Copilot clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for GitHub Copilot connectivity :learning-objective-2: Deploy multi-tenant authentication strategies for Copilot clients :learning-objective-3: Set up model aliasing and BYOK routing for GitHub Copilot diff --git a/modules/ROOT/partials/integrations/github-copilot-user.adoc b/modules/ROOT/partials/integrations/github-copilot-user.adoc index 46add1f..b5621f6 100644 --- a/modules/ROOT/partials/integrations/github-copilot-user.adoc +++ b/modules/ROOT/partials/integrations/github-copilot-user.adoc @@ -1,7 +1,7 @@ = Configure GitHub Copilot with AI Gateway :description: Configure GitHub Copilot to use Redpanda AI Gateway for unified LLM access and custom provider management. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure GitHub Copilot in VS Code and JetBrains IDEs to route requests through AI Gateway :learning-objective-2: Set up multi-tenancy with gateway routing for cost tracking :learning-objective-3: Configure enterprise BYOK deployments for team-wide Copilot access diff --git a/modules/ROOT/partials/integrations/index.adoc b/modules/ROOT/partials/integrations/index.adoc index 8150fff..98d378c 100644 --- a/modules/ROOT/partials/integrations/index.adoc +++ b/modules/ROOT/partials/integrations/index.adoc @@ -1,4 +1,5 @@ = AI Gateway Integrations :description: Configure AI development tools and IDEs to connect to Redpanda AI Gateway for centralized LLM routing and MCP tool aggregation. :page-layout: index +:personas: agent_builder, platform_engineer diff --git a/modules/ROOT/partials/migration-guide.adoc b/modules/ROOT/partials/migration-guide.adoc index 6418fa0..d94b330 100644 --- a/modules/ROOT/partials/migration-guide.adoc +++ b/modules/ROOT/partials/migration-guide.adoc @@ -1,7 +1,7 @@ = Migrate to AI Gateway :description: Step-by-step migration guide to transition existing applications from direct LLM provider integrations to Redpanda AI Gateway with minimal disruption. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Migrate LLM integrations to AI Gateway with zero downtime using feature flags :learning-objective-2: Verify gateway connectivity and compare performance metrics :learning-objective-3: Roll back to direct integration if issues arise during migration diff --git a/modules/ROOT/partials/observability-logs.adoc b/modules/ROOT/partials/observability-logs.adoc index 62aad40..73e5daa 100644 --- a/modules/ROOT/partials/observability-logs.adoc +++ b/modules/ROOT/partials/observability-logs.adoc @@ -1,7 +1,7 @@ = Observability: Logs :description: Guide to AI Gateway request logs, including where to find logs, log fields, filtering, searching, inspecting requests, common analysis tasks, log retention, export options, privacy/security, and troubleshooting. :page-topic-type: reference -:personas: platform_admin, app_developer +:personas: platform_engineer, security_compliance_lead, agent_builder :learning-objective-1: Locate and filter request logs to debug failures or reconstruct conversations :learning-objective-2: Interpret log fields to diagnose performance and cost issues :learning-objective-3: Export logs for compliance auditing or long-term analysis diff --git a/modules/ROOT/partials/observability-metrics.adoc b/modules/ROOT/partials/observability-metrics.adoc index a196ca5..248c4fd 100644 --- a/modules/ROOT/partials/observability-metrics.adoc +++ b/modules/ROOT/partials/observability-metrics.adoc @@ -1,7 +1,7 @@ = Observability: Metrics and Analytics :description: Guide to AI Gateway metrics and analytics, including where to find metrics, key metrics explained, dashboard views, filtering/grouping, alerting, exporting, common analysis tasks, retention, API access, best practices, and troubleshooting. :page-topic-type: reference -:personas: platform_admin, app_developer +:personas: platform_engineer, pilot_lead :learning-objective-1: Monitor aggregate metrics to track usage patterns and budget adherence :learning-objective-2: Compare model and provider performance using latency and cost metrics :learning-objective-3: Configure alerts for budget thresholds and performance degradation diff --git a/modules/agents/pages/a2a-concepts.adoc b/modules/agents/pages/a2a-concepts.adoc index cc5b428..aebacf5 100644 --- a/modules/agents/pages/a2a-concepts.adoc +++ b/modules/agents/pages/a2a-concepts.adoc @@ -1,7 +1,7 @@ = A2A Protocol :description: Learn how the A2A protocol enables agent discovery and communication. :page-topic-type: concepts -:personas: agent_developer, app_developer, streaming_developer +:personas: agent_builder :learning-objective-1: Describe the A2A protocol and its role in agent communication :learning-objective-2: Explain how agent cards enable discovery :learning-objective-3: Identify how authentication secures agent communication diff --git a/modules/agents/pages/architecture-patterns.adoc b/modules/agents/pages/architecture-patterns.adoc index 6f5ee53..896b638 100644 --- a/modules/agents/pages/architecture-patterns.adoc +++ b/modules/agents/pages/architecture-patterns.adoc @@ -2,7 +2,7 @@ :description: Design maintainable agent systems with single-agent and multi-agent patterns based on domain complexity. :page-byoc: true :page-topic-type: best-practices -:personas: agent_developer, streaming_developer +:personas: agent_builder :learning-objective-1: Evaluate single-agent versus multi-agent architectures for your use case :learning-objective-2: Choose appropriate LLM models based on task requirements :learning-objective-3: Apply agent boundary design principles for maintainability diff --git a/modules/agents/pages/build-index.adoc b/modules/agents/pages/build-index.adoc index f367980..2916228 100644 --- a/modules/agents/pages/build-index.adoc +++ b/modules/agents/pages/build-index.adoc @@ -1,5 +1,6 @@ = Build Agents :page-layout: index :description: Create production AI agents with effective prompts and scalable architecture. +:personas: agent_builder Create agents, write effective prompts, and design scalable agent systems. diff --git a/modules/agents/pages/byoa-register.adoc b/modules/agents/pages/byoa-register.adoc index 4e57e29..e9b2216 100644 --- a/modules/agents/pages/byoa-register.adoc +++ b/modules/agents/pages/byoa-register.adoc @@ -1,7 +1,7 @@ = Register Your Own Agent (BYOA) :description: Register an agent you operate yourself with the Agentic Data Plane so it appears in the governance dashboard, emits transcripts, and can be called over A2A. Covers the registration model, A2A endpoint contract, service-account auth, and how BYOA differs from a managed agent. :page-topic-type: how-to -:personas: agent_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Distinguish a BYOA (Bring Your Own Agent) from a Redpanda-managed agent and decide when each fits :learning-objective-2: pass:q[Identify the A2A endpoint contract a BYOA agent must expose (well-known agent card and the `/.well-known/agent-card.json` discovery URL)] :learning-objective-3: Identify the service-account auth model BYOA agents use to authenticate inbound calls and emit telemetry diff --git a/modules/agents/pages/concepts.adoc b/modules/agents/pages/concepts.adoc index 756b1e8..6177648 100644 --- a/modules/agents/pages/concepts.adoc +++ b/modules/agents/pages/concepts.adoc @@ -1,7 +1,7 @@ = Agent Concepts :description: Understand how declaratively configured agents execute reasoning loops, manage context, invoke tools, and handle errors. :page-topic-type: concepts -:personas: agent_developer, streaming_developer, data_engineer +:personas: agent_builder :learning-objective-1: Explain how agents execute reasoning loops and make tool invocation decisions :learning-objective-2: Describe how agents manage context and state across interactions :learning-objective-3: Identify error handling strategies for agent failures diff --git a/modules/agents/pages/create-agent.adoc b/modules/agents/pages/create-agent.adoc index cb77e37..fdd946e 100644 --- a/modules/agents/pages/create-agent.adoc +++ b/modules/agents/pages/create-agent.adoc @@ -1,7 +1,7 @@ = Create an Agent :description: Configure an ADP agent declaratively through the create form. No Python or JavaScript code required. :page-topic-type: how-to -:personas: agent_developer, app_developer, streaming_developer +:personas: agent_builder :learning-objective-1: Create an ADP agent through the create form :learning-objective-2: Configure an LLM provider, model, and execution settings :learning-objective-3: Connect MCP servers, add subagents, and set discovery metadata diff --git a/modules/agents/pages/get-started-index.adoc b/modules/agents/pages/get-started-index.adoc index aa08dab..c6da24d 100644 --- a/modules/agents/pages/get-started-index.adoc +++ b/modules/agents/pages/get-started-index.adoc @@ -1,5 +1,6 @@ = Get Started with AI Agents :page-layout: index :description: Get started with declarative AI agents in ADP. Connect tools, configure behavior, and deploy without writing agent code. +:personas: agent_builder Start here to create your first declarative AI agent. Select an LLM, define behavior, and connect tools from built-in connectors. diff --git a/modules/agents/pages/index.adoc b/modules/agents/pages/index.adoc index 6bb731e..36295da 100644 --- a/modules/agents/pages/index.adoc +++ b/modules/agents/pages/index.adoc @@ -1,4 +1,5 @@ = AI Agents :page-layout: index :description: Declare agent behavior using built-in connectors. No custom agent code required. +:personas: agent_builder, platform_engineer diff --git a/modules/agents/pages/integration-index.adoc b/modules/agents/pages/integration-index.adoc index 7a4b567..4b42f32 100644 --- a/modules/agents/pages/integration-index.adoc +++ b/modules/agents/pages/integration-index.adoc @@ -1,6 +1,7 @@ = Agent Integration :page-layout: index :description: Connect agents to external applications, pipelines, and other systems. +:personas: agent_builder, platform_engineer Choose integration patterns and connect agents to your systems. diff --git a/modules/agents/pages/integration-overview.adoc b/modules/agents/pages/integration-overview.adoc index 5e78b66..2a2b612 100644 --- a/modules/agents/pages/integration-overview.adoc +++ b/modules/agents/pages/integration-overview.adoc @@ -1,7 +1,7 @@ = Integration Patterns Overview :description: Choose the right integration pattern for connecting agents, pipelines, and external applications. :page-topic-type: best-practices -:personas: agent_developer, streaming_developer, app_developer, data_engineer +:personas: agent_builder, platform_engineer :learning-objective-1: Choose the integration pattern that fits your use case :learning-objective-2: Apply appropriate authentication for internal versus external integration :learning-objective-3: Select the right communication protocol for your integration scenario diff --git a/modules/agents/pages/monitor.adoc b/modules/agents/pages/monitor.adoc index 5ebd001..c8d70c2 100644 --- a/modules/agents/pages/monitor.adoc +++ b/modules/agents/pages/monitor.adoc @@ -1,7 +1,7 @@ = Monitor Agent Activity :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_developer, platform_admin +:personas: agent_builder, platform_engineer, domain_evaluator :learning-objective-1: pass:q[Verify agent behavior using the *Inspector* tab] :learning-objective-2: Track token usage and performance metrics :learning-objective-3: pass:q[Debug agent execution using *Transcripts*] diff --git a/modules/agents/pages/overview.adoc b/modules/agents/pages/overview.adoc index 72d861b..89bbe41 100644 --- a/modules/agents/pages/overview.adoc +++ b/modules/agents/pages/overview.adoc @@ -2,7 +2,7 @@ :page-aliases: redpanda-cloud:ai-agents:agents/overview.adoc :description: Learn how ADP agents use a declarative approach backed by 300+ built-in connectors to replace custom agent code. :page-topic-type: overview -:personas: evaluator, agent_developer, app_developer, streaming_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Describe what AI agents are and their essential components :learning-objective-2: Explain how ADP streaming infrastructure benefits agent architectures :learning-objective-3: Identify use cases where ADP agents provide value diff --git a/modules/agents/pages/pipeline-integration-patterns.adoc b/modules/agents/pages/pipeline-integration-patterns.adoc index 4b0bbb6..fadb126 100644 --- a/modules/agents/pages/pipeline-integration-patterns.adoc +++ b/modules/agents/pages/pipeline-integration-patterns.adoc @@ -1,7 +1,7 @@ = Pipeline Integration Patterns :description: Build Redpanda Connect pipelines that invoke agents for event-driven processing and streaming enrichment. :page-topic-type: best-practices -:personas: streaming_developer, agent_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Identify when pipelines should call agents for stream processing :learning-objective-2: pass:q[Design event-driven agent invocation using the `a2a_message` processor] :learning-objective-3: Implement streaming enrichment with AI-generated fields diff --git a/modules/agents/pages/quickstart.adoc b/modules/agents/pages/quickstart.adoc index dc362d1..d118af3 100644 --- a/modules/agents/pages/quickstart.adoc +++ b/modules/agents/pages/quickstart.adoc @@ -2,7 +2,7 @@ :page-aliases: redpanda-cloud:ai-agents:agents/quickstart.adoc :description: Create your first AI agent in ADP that generates and publishes event data through natural language commands. :page-topic-type: tutorial -:personas: agent_developer, evaluator +:personas: agent_builder :learning-objective-1: Create an AI agent in ADP that uses MCP tools :learning-objective-2: Configure the agent with a system prompt and model selection :learning-objective-3: Test the agent by generating and publishing events through natural language diff --git a/modules/agents/pages/system-prompts.adoc b/modules/agents/pages/system-prompts.adoc index 0656f8d..96a91da 100644 --- a/modules/agents/pages/system-prompts.adoc +++ b/modules/agents/pages/system-prompts.adoc @@ -1,7 +1,7 @@ = System Prompt Best Practices :description: Write system prompts that produce reliable, predictable agent behavior through clear constraints and tool guidance. :page-topic-type: best-practices -:personas: agent_developer, app_developer, streaming_developer +:personas: agent_builder :learning-objective-1: Identify effective system prompt patterns for agent reliability :learning-objective-2: Apply constraint patterns to prevent unintended agent behavior :learning-objective-3: Evaluate system prompts for clarity and completeness diff --git a/modules/agents/pages/troubleshoot/index.adoc b/modules/agents/pages/troubleshoot/index.adoc index d83e3e0..205ac67 100644 --- a/modules/agents/pages/troubleshoot/index.adoc +++ b/modules/agents/pages/troubleshoot/index.adoc @@ -1,4 +1,5 @@ = Troubleshoot :page-layout: index :description: Diagnose and fix common issues with AI agents, including deployment failures, runtime behavior, tool execution, and pipeline integration. +:personas: agent_builder, platform_engineer diff --git a/modules/agents/pages/troubleshoot/troubleshoot-ai-agents.adoc b/modules/agents/pages/troubleshoot/troubleshoot-ai-agents.adoc index 06d7c3a..9c00ff4 100644 --- a/modules/agents/pages/troubleshoot/troubleshoot-ai-agents.adoc +++ b/modules/agents/pages/troubleshoot/troubleshoot-ai-agents.adoc @@ -2,7 +2,7 @@ :description: Diagnose and fix common issues with AI agents including deployment failures, runtime behavior problems, and tool execution errors. :page-byoc: true :page-topic-type: troubleshooting -:personas: agent_developer, app_developer, streaming_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Diagnose deployment failures and resource allocation errors :learning-objective-2: Resolve runtime behavior issues including tool selection and iteration limits :learning-objective-3: Fix tool execution problems and authentication failures diff --git a/modules/agents/pages/tutorials/customer-support-agent.adoc b/modules/agents/pages/tutorials/customer-support-agent.adoc index af0299a..26c2900 100644 --- a/modules/agents/pages/tutorials/customer-support-agent.adoc +++ b/modules/agents/pages/tutorials/customer-support-agent.adoc @@ -1,7 +1,7 @@ = Learn Multi-Tool Agent Orchestration :description: Learn how agents coordinate multiple tools, make decisions based on conversation context, and handle errors through building a customer support agent. :page-topic-type: tutorial -:personas: agent_developer, streaming_developer +:personas: agent_builder :learning-objective-1: Explain how agents use conversation context to decide which tools to invoke :learning-objective-2: Apply tool orchestration patterns to handle multi-step workflows :learning-objective-3: Evaluate how system prompt design affects agent tool selection diff --git a/modules/agents/pages/tutorials/index.adoc b/modules/agents/pages/tutorials/index.adoc index 8ec8a2b..01609e6 100644 --- a/modules/agents/pages/tutorials/index.adoc +++ b/modules/agents/pages/tutorials/index.adoc @@ -1,3 +1,4 @@ = Tutorials :description: End-to-end agent tutorials that walk through customer support, transaction dispute resolution, and other multi-agent workflows. :page-layout: index +:personas: agent_builder diff --git a/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc b/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc index 00930e9..a7bbe42 100644 --- a/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc +++ b/modules/agents/pages/tutorials/transaction-dispute-resolution.adoc @@ -1,7 +1,7 @@ = Build Multi-Agent Systems for Transaction Dispute Resolution :description: Learn how to build multi-agent systems with domain separation, handle sensitive financial data, and monitor multi-agent execution through transaction investigation. :page-topic-type: tutorial -:personas: agent_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Design multi-agent systems with domain-specific sub-agents :learning-objective-2: pass:q[Monitor multi-agent execution using *Transcripts*] :learning-objective-3: Integrate agents with streaming pipelines for event-driven processing diff --git a/modules/ai-gateway/pages/admin/index.adoc b/modules/ai-gateway/pages/admin/index.adoc index b820f01..7eba589 100644 --- a/modules/ai-gateway/pages/admin/index.adoc +++ b/modules/ai-gateway/pages/admin/index.adoc @@ -1,3 +1,4 @@ = For Admins :description: Set up and operate AI Gateway across providers, secrets, authentication, and observability for your team. :page-layout: index +:personas: platform_engineer, security_compliance_lead diff --git a/modules/ai-gateway/pages/admin/setup-guide.adoc b/modules/ai-gateway/pages/admin/setup-guide.adoc index e0fc51c..3ed237f 100644 --- a/modules/ai-gateway/pages/admin/setup-guide.adoc +++ b/modules/ai-gateway/pages/admin/setup-guide.adoc @@ -1,7 +1,7 @@ = AI Gateway Setup Guide :description: Set up AI Gateway for your organization. Enable providers, configure failover for high availability, set budget controls, and create gateways with team-level isolation. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer, security_compliance_lead :learning-objective-1: Enable LLM providers and models in the catalog :learning-objective-2: Create and configure gateways with routing policies, rate limits, and spend limits :learning-objective-3: Set up MCP tool aggregation for AI agents diff --git a/modules/ai-gateway/pages/aggregation.adoc b/modules/ai-gateway/pages/aggregation.adoc index c6f6b5c..d87afaf 100644 --- a/modules/ai-gateway/pages/aggregation.adoc +++ b/modules/ai-gateway/pages/aggregation.adoc @@ -2,7 +2,7 @@ :description: Learn how to use the MCP Gateway to aggregate MCP servers, configure deferred tool loading, create orchestrator workflows, and manage security. :page-byoc: true :page-topic-type: guide -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure MCP aggregation with deferred tool loading to reduce token costs :learning-objective-2: Write orchestrator workflows to reduce multi-step interactions :learning-objective-3: Manage approved MCP servers with security controls and audit trails diff --git a/modules/ai-gateway/pages/bedrock-setup.adoc b/modules/ai-gateway/pages/bedrock-setup.adoc index 12598c1..9fd6ef9 100644 --- a/modules/ai-gateway/pages/bedrock-setup.adoc +++ b/modules/ai-gateway/pages/bedrock-setup.adoc @@ -1,7 +1,7 @@ = Set Up AWS Bedrock as an LLM Provider :description: Create the IAM user, policy, and access keys required for AI Gateway to invoke Amazon Bedrock models, then register the provider in ADP. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Create an IAM policy that grants AI Gateway permission to invoke Bedrock foundation models and cross-region inference profiles :learning-objective-2: Create a dedicated IAM user, attach the policy, and generate access keys for AI Gateway :learning-objective-3: Register Bedrock as an LLM provider in ADP and select the models you want to expose diff --git a/modules/ai-gateway/pages/builders/discover-gateways.adoc b/modules/ai-gateway/pages/builders/discover-gateways.adoc index 7095ee3..993ccce 100644 --- a/modules/ai-gateway/pages/builders/discover-gateways.adoc +++ b/modules/ai-gateway/pages/builders/discover-gateways.adoc @@ -1,7 +1,7 @@ = Discover Available Gateways :description: Find which AI Gateways you can access and their configurations. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder :learning-objective-1: List all AI Gateways you have access to and retrieve their endpoints and IDs :learning-objective-2: View which models and MCP tools are available through each gateway :learning-objective-3: Test gateway connectivity before integration diff --git a/modules/ai-gateway/pages/builders/index.adoc b/modules/ai-gateway/pages/builders/index.adoc index f66b716..8e20981 100644 --- a/modules/ai-gateway/pages/builders/index.adoc +++ b/modules/ai-gateway/pages/builders/index.adoc @@ -1,3 +1,4 @@ = For Builders :description: Discover available gateways and connect your applications and agents to AI Gateway. :page-layout: index +:personas: agent_builder diff --git a/modules/ai-gateway/pages/configure-provider.adoc b/modules/ai-gateway/pages/configure-provider.adoc index e59bd23..76c257e 100644 --- a/modules/ai-gateway/pages/configure-provider.adoc +++ b/modules/ai-gateway/pages/configure-provider.adoc @@ -1,7 +1,7 @@ = Configure an LLM Provider :description: Create an LLM provider in AI Gateway to proxy requests to OpenAI, Anthropic, Google AI, AWS Bedrock, or any OpenAI-compatible endpoint through a managed Redpanda URL. :page-topic-type: how-to -:personas: platform_admin, app_developer +:personas: platform_engineer, agent_builder // Page aliases for the consolidated quickstart and setup-guide redirects will land in a follow-up cleanup PR that also deletes the legacy pages (gateway-quickstart.adoc, gateway-architecture.adoc, aggregation.adoc, admin/setup-guide.adoc, builders/discover-gateways.adoc) and retargets the ~80 cross-module xrefs (agents, integrations, observability) that still point at them. :learning-objective-1: Create an LLM provider for OpenAI, Anthropic, Google AI, AWS Bedrock, or an OpenAI-compatible endpoint :learning-objective-2: Select the models you want to expose through the provider diff --git a/modules/ai-gateway/pages/connect-agent.adoc b/modules/ai-gateway/pages/connect-agent.adoc index cb80aac..ccf6db7 100644 --- a/modules/ai-gateway/pages/connect-agent.adoc +++ b/modules/ai-gateway/pages/connect-agent.adoc @@ -1,7 +1,7 @@ = Connect Your Agent :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: app_developer +:personas: agent_builder :page-aliases: redpanda-cloud:ai-agents:ai-gateway/builders/connect-your-agent.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] diff --git a/modules/ai-gateway/pages/gateway-architecture.adoc b/modules/ai-gateway/pages/gateway-architecture.adoc index a492d5b..a884241 100644 --- a/modules/ai-gateway/pages/gateway-architecture.adoc +++ b/modules/ai-gateway/pages/gateway-architecture.adoc @@ -1,7 +1,7 @@ = AI Gateway Architecture :description: Technical architecture of Redpanda AI Gateway, including how the control plane, data plane, and observability plane deliver high availability, cost governance, and multi-tenant isolation. :page-topic-type: concept -:personas: app_developer, platform_admin +:personas: platform_engineer, agent_builder, security_compliance_lead :learning-objective-1: Describe the three architectural planes of AI Gateway :learning-objective-2: Explain the request lifecycle through policy evaluation stages :learning-objective-3: Identify supported providers, features, and current limitations diff --git a/modules/ai-gateway/pages/gateway-quickstart.adoc b/modules/ai-gateway/pages/gateway-quickstart.adoc index 93dd914..3204ba6 100644 --- a/modules/ai-gateway/pages/gateway-quickstart.adoc +++ b/modules/ai-gateway/pages/gateway-quickstart.adoc @@ -2,7 +2,7 @@ :page-aliases: redpanda-cloud:ai-agents:ai-gateway/gateway-quickstart.adoc :description: Get started with AI Gateway. Configure providers, create your first gateway with failover and budget controls, and route your first request. :page-topic-type: quickstart -:personas: evaluator, app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Enable an LLM provider and create your first gateway :learning-objective-2: Route your first request through AI Gateway and verify it works :learning-objective-3: Verify request routing and token usage in the gateway overview diff --git a/modules/ai-gateway/pages/index.adoc b/modules/ai-gateway/pages/index.adoc index c23d63d..85bc4b3 100644 --- a/modules/ai-gateway/pages/index.adoc +++ b/modules/ai-gateway/pages/index.adoc @@ -1,4 +1,5 @@ = AI Gateway :page-layout: index :description: Redpanda's managed proxy for LLM APIs. Create an LLM provider, and point your applications at a Redpanda-hosted URL with managed secrets, authentication, and observability. +:personas: agent_builder, platform_engineer diff --git a/modules/ai-gateway/pages/overview.adoc b/modules/ai-gateway/pages/overview.adoc index 2b4c6fe..bb0846e 100644 --- a/modules/ai-gateway/pages/overview.adoc +++ b/modules/ai-gateway/pages/overview.adoc @@ -1,7 +1,7 @@ = AI Gateway Overview :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: platform_admin, app_developer, evaluator +:personas: agent_builder, platform_engineer, security_compliance_lead // TODO: Add 'redpanda-cloud:ai-agents:ai-gateway/what-is-ai-gateway.adoc' to page-aliases after ai-agents is removed from cloud-docs :page-aliases: redpanda-cloud:ai-agents:ai-gateway/gateway-architecture.adoc, redpanda-cloud:ai-agents:ai-gateway/cel-routing-cookbook.adoc, redpanda-cloud:ai-agents:ai-gateway/mcp-aggregation-guide.adoc, redpanda-cloud:ai-agents:ai-gateway/builders/discover-gateways.adoc :learning-objective-1: Describe what AI Gateway is and how a managed proxy differs from direct upstream calls diff --git a/modules/ai-gateway/partials/ai-hub/configure-ai-hub.adoc b/modules/ai-gateway/partials/ai-hub/configure-ai-hub.adoc index 2d4daf6..400235d 100644 --- a/modules/ai-gateway/partials/ai-hub/configure-ai-hub.adoc +++ b/modules/ai-gateway/partials/ai-hub/configure-ai-hub.adoc @@ -1,7 +1,7 @@ = Configure AI Hub Gateway :description: Create and configure zero-config AI Hub gateways with pre-configured routing and backend pools. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Create an AI Hub gateway with one-click configuration :learning-objective-2: Configure user preference toggles to customize routing behavior :learning-objective-3: Manage provider credentials for OpenAI, Anthropic, and Google Gemini diff --git a/modules/ai-gateway/partials/ai-hub/eject-to-custom-mode.adoc b/modules/ai-gateway/partials/ai-hub/eject-to-custom-mode.adoc index 4fd200c..1442614 100644 --- a/modules/ai-gateway/partials/ai-hub/eject-to-custom-mode.adoc +++ b/modules/ai-gateway/partials/ai-hub/eject-to-custom-mode.adoc @@ -1,7 +1,7 @@ = Eject to Custom Mode :description: Transition an AI Hub gateway to Custom mode for full configuration control. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Evaluate the implications of ejecting from AI Hub to Custom mode :learning-objective-2: Prepare for ejection by documenting current configuration :learning-objective-3: Execute the ejection process and configure the gateway post-ejection diff --git a/modules/ai-gateway/partials/ai-hub/gateway-modes.adoc b/modules/ai-gateway/partials/ai-hub/gateway-modes.adoc index bdb490e..19deda3 100644 --- a/modules/ai-gateway/partials/ai-hub/gateway-modes.adoc +++ b/modules/ai-gateway/partials/ai-hub/gateway-modes.adoc @@ -1,7 +1,7 @@ = AI Gateway Modes :description: Understand AI Hub mode and Custom mode, and choose the right approach for your organization. :page-topic-type: concept -:personas: evaluator, platform_admin, app_developer +:personas: platform_engineer, agent_builder :learning-objective-1: Differentiate between AI Hub and Custom gateway modes :learning-objective-2: Determine which mode suits your use case based on configuration needs :learning-objective-3: Identify which mode a gateway is running in using Console or API diff --git a/modules/ai-gateway/partials/ai-hub/use-ai-hub-gateway.adoc b/modules/ai-gateway/partials/ai-hub/use-ai-hub-gateway.adoc index 5a899a2..a751560 100644 --- a/modules/ai-gateway/partials/ai-hub/use-ai-hub-gateway.adoc +++ b/modules/ai-gateway/partials/ai-hub/use-ai-hub-gateway.adoc @@ -1,7 +1,7 @@ = Use AI Hub Gateway :description: Connect to and use AI Hub mode gateways with pre-configured intelligent routing. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder :learning-objective-1: Identify whether a gateway is running in AI Hub mode :learning-objective-2: Connect your application to an AI Hub gateway using the OpenAI SDK :learning-objective-3: Describe how intelligent routing directs requests to providers diff --git a/modules/get-started/pages/byoc-prereqs.adoc b/modules/get-started/pages/byoc-prereqs.adoc index 6c7aa0f..ff9328b 100644 --- a/modules/get-started/pages/byoc-prereqs.adoc +++ b/modules/get-started/pages/byoc-prereqs.adoc @@ -1,7 +1,7 @@ = ADP BYOC Prerequisites :description: Requirements for running Redpanda ADP on Redpanda Cloud BYOC environments on AWS. :page-topic-type: reference -:personas: platform_admin +:personas: platform_engineer :page-byoc: true :learning-objective-1: Identify the AWS BYOC requirements for ADP :learning-objective-2: Identify the ADP enablement and IAM resource patterns required by Crossplane diff --git a/modules/get-started/pages/byoc-quickstart.adoc b/modules/get-started/pages/byoc-quickstart.adoc index 30432a5..5638625 100644 --- a/modules/get-started/pages/byoc-quickstart.adoc +++ b/modules/get-started/pages/byoc-quickstart.adoc @@ -1,7 +1,7 @@ = ADP BYOC Quickstart :description: Start with ADP on a Redpanda Cloud BYOC environment on AWS. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :page-byoc: true :learning-objective-1: Check that a BYOC environment meets the ADP prerequisites :learning-objective-2: Continue from BYOC environment setup into ADP provider, MCP, and agent setup diff --git a/modules/get-started/pages/first-agent.adoc b/modules/get-started/pages/first-agent.adoc index 64ae9c8..d64baf3 100644 --- a/modules/get-started/pages/first-agent.adoc +++ b/modules/get-started/pages/first-agent.adoc @@ -1,4 +1,5 @@ = Build Your First Agent :description: Create and deploy your first AI agent with Redpanda ADP. +:personas: agent_builder // TODO: Add content diff --git a/modules/get-started/pages/index.adoc b/modules/get-started/pages/index.adoc index e6d612f..8ccb58a 100644 --- a/modules/get-started/pages/index.adoc +++ b/modules/get-started/pages/index.adoc @@ -1,3 +1,4 @@ = Get Started :description: Set up your ADP environment, build your first agent, and invite your team. :page-layout: index +:personas: agent_builder, platform_engineer, pilot_lead diff --git a/modules/get-started/pages/rpk-install.adoc b/modules/get-started/pages/rpk-install.adoc index ce70bd1..5f8f2d6 100644 --- a/modules/get-started/pages/rpk-install.adoc +++ b/modules/get-started/pages/rpk-install.adoc @@ -1,5 +1,6 @@ = Install or Update rpk :description: Install or update rpk to interact with Redpanda from the command line. +:personas: platform_engineer, agent_builder :env-cloud: include::ROOT:get-started:rpk-install.adoc[tag=single-source] diff --git a/modules/governance/pages/budgets.adoc b/modules/governance/pages/budgets.adoc index 297b50a..32f4bd8 100644 --- a/modules/governance/pages/budgets.adoc +++ b/modules/governance/pages/budgets.adoc @@ -1,8 +1,7 @@ = Token Budgets and Limits :description: See what AI spending the Agentic Data Plane records automatically and where to view it. :page-topic-type: overview -:personas: platform_admin, evaluator -// TODO: confirm persona vocabulary. The Governance V0 PRD names HoT (Head of Trust), CIO/CFO, CISO, and FDE; this page uses canonical docs-team-standards personas. Confirm with docs-team-standards owner whether to add `executive` and `security_admin` (or equivalents) so the metadata matches the PRD audience. +:personas: platform_engineer, pilot_lead :learning-objective-1: Identify what spending data the Agentic Data Plane records automatically :learning-objective-2: Locate where to view spend in the dashboard, in transcripts, and through breakdown queries diff --git a/modules/governance/pages/dashboard/index.adoc b/modules/governance/pages/dashboard/index.adoc index 22bcf9e..141ee70 100644 --- a/modules/governance/pages/dashboard/index.adoc +++ b/modules/governance/pages/dashboard/index.adoc @@ -1,4 +1,5 @@ = Governance Dashboard :page-layout: index :description: See your AI deployment's spending, fleet, and activity in one place, with drill-down into the transcript behind any number, agent, or event. +:personas: pilot_lead, platform_engineer, security_compliance_lead diff --git a/modules/governance/pages/dashboard/overview.adoc b/modules/governance/pages/dashboard/overview.adoc index 656e9c0..4a33d15 100644 --- a/modules/governance/pages/dashboard/overview.adoc +++ b/modules/governance/pages/dashboard/overview.adoc @@ -1,7 +1,7 @@ = Read the Governance Overview :description: Read ADP spend, request, token, agent, and top-user activity from the Governance dashboard. :page-topic-type: how-to -:personas: evaluator, platform_admin, app_developer +:personas: pilot_lead, platform_engineer, security_compliance_lead :learning-objective-1: Read the Total Spend, Requests, and Tokens KPI tabs :learning-objective-2: Filter governance charts by provider, model, cost type, token type, and user :learning-objective-3: Use the Agents table and Top users panel to investigate fleet and user-level spend diff --git a/modules/governance/pages/guardrails/cost-tracking.adoc b/modules/governance/pages/guardrails/cost-tracking.adoc index 9c7bb18..679c90b 100644 --- a/modules/governance/pages/guardrails/cost-tracking.adoc +++ b/modules/governance/pages/guardrails/cost-tracking.adoc @@ -1,8 +1,7 @@ = Guardrail Cost Tracking :description: See what each evaluator costs, where the cost surfaces in transcripts and dashboards, and how guardrail spend interacts with token budgets. :page-topic-type: reference -:personas: platform_admin -// TODO: confirm persona vocabulary against docs-team-standards. If a Guardrails-specific persona exists (for example, security_admin), apply it here. Open Q D4 in the companion plan. +:personas: platform_engineer, security_compliance_lead // TODO: this page lands at GA. The Guardrails plan (https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1881702438) lists this page as a should-ship deliverable; the cost-pool integration with Budgets fills in once eng confirms whether evaluator cost flows into the user-facing budget pool, a separate guardrail-evaluator pool, or both. Open Qs C2, C3 in the companion plan. diff --git a/modules/governance/pages/guardrails/create-guardrail.adoc b/modules/governance/pages/guardrails/create-guardrail.adoc index 3136991..078c67a 100644 --- a/modules/governance/pages/guardrails/create-guardrail.adoc +++ b/modules/governance/pages/guardrails/create-guardrail.adoc @@ -1,8 +1,7 @@ = Create a Guardrail :description: Configure a guardrail, pick an evaluator type and phase, attach it to one or more LLM providers, and verify that it fires. :page-topic-type: how-to -:personas: platform_admin -// TODO: confirm persona vocabulary against docs-team-standards. If a Guardrails-specific persona exists (for example, security_admin), apply it here. Open Q D4 in the companion plan. +:personas: security_compliance_lead, platform_engineer :learning-objective-1: Create and configure a guardrail of a chosen evaluator type :learning-objective-2: Attach the guardrail to one or more LLM providers and enable it :learning-objective-3: Verify the guardrail fires and trace the violation through the transcript diff --git a/modules/governance/pages/guardrails/index.adoc b/modules/governance/pages/guardrails/index.adoc index 1792a2e..a8b9e05 100644 --- a/modules/governance/pages/guardrails/index.adoc +++ b/modules/governance/pages/guardrails/index.adoc @@ -1,3 +1,4 @@ = Guardrails :description: Configurable safety and policy filters that run on the request or response side of every LLM call routed through AI Gateway. :page-layout: index +:personas: security_compliance_lead, platform_engineer diff --git a/modules/governance/pages/guardrails/overview.adoc b/modules/governance/pages/guardrails/overview.adoc index 575de7c..cfe3666 100644 --- a/modules/governance/pages/guardrails/overview.adoc +++ b/modules/governance/pages/guardrails/overview.adoc @@ -1,8 +1,7 @@ = Guardrails Overview :description: Learn what guardrails are, the evaluator types you can choose from, the INPUT and OUTPUT phase model, and where violations show up. :page-topic-type: overview -:personas: platform_admin, evaluator, app_developer -// TODO: confirm persona vocabulary against docs-team-standards. The Guardrails plan uses canonical personas; if a Guardrails-specific persona exists (for example, security_admin), apply it here. Open Q D4 in the companion plan. +:personas: security_compliance_lead, platform_engineer, agent_builder :learning-objective-1: Describe what a guardrail does and why you would attach one to an LLM provider :learning-objective-2: Distinguish between the three evaluator types (PII, Toxicity, and Custom webhook) and the situations each fits :learning-objective-3: Recognize where a guardrail violation surfaces and which page to read next diff --git a/modules/governance/pages/guardrails/types-reference.adoc b/modules/governance/pages/guardrails/types-reference.adoc index 33c425e..b18154b 100644 --- a/modules/governance/pages/guardrails/types-reference.adoc +++ b/modules/governance/pages/guardrails/types-reference.adoc @@ -1,8 +1,7 @@ = Evaluator Types Reference :description: Definitive reference for every evaluator type's config schema, supported phases, behavior on match, and gotchas. :page-topic-type: reference -:personas: platform_admin -// TODO: confirm persona vocabulary against docs-team-standards. If a Guardrails-specific persona exists (for example, security_admin), apply it here. Open Q D4 in the companion plan. +:personas: security_compliance_lead, platform_engineer // TODO: this page lands at GA. The Guardrails plan (https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1881702438) lists this page as a must-ship deliverable; the per-type config schemas are filled in once eng confirms the post-pivot Guardrail resource shape and the evaluator type set at GA. Open Qs A1, A2, A5, B3, B4 in the companion plan. diff --git a/modules/governance/pages/guardrails/violations.adoc b/modules/governance/pages/guardrails/violations.adoc index 81d55e5..e328de9 100644 --- a/modules/governance/pages/guardrails/violations.adoc +++ b/modules/governance/pages/guardrails/violations.adoc @@ -1,8 +1,7 @@ = Read Violations :description: Investigate why a guardrail fired, distinguish a violation from an evaluator failure, and tune the configuration. :page-topic-type: how-to -:personas: app_developer, platform_admin -// TODO: confirm persona vocabulary against docs-team-standards. If a Guardrails-specific persona exists (for example, security_admin), apply it here. Open Q D4 in the companion plan. +:personas: security_compliance_lead, platform_engineer, agent_builder :learning-objective-1: Locate a violation entry in a transcript and identify which guardrail fired :learning-objective-2: Distinguish a guardrail violation from an evaluator failure and apply the right response :learning-objective-3: Recognize common false-positive patterns per evaluator type and tune the configuration diff --git a/modules/governance/pages/index.adoc b/modules/governance/pages/index.adoc index 88395c0..95f563c 100644 --- a/modules/governance/pages/index.adoc +++ b/modules/governance/pages/index.adoc @@ -1,3 +1,4 @@ = Governance :description: Govern agent behavior with guardrails, token budgets, the kill switch, and the governance dashboard. :page-layout: index +:personas: security_compliance_lead, platform_engineer, pilot_lead diff --git a/modules/governance/pages/kill-switch.adoc b/modules/governance/pages/kill-switch.adoc index d461b99..4e5bae3 100644 --- a/modules/governance/pages/kill-switch.adoc +++ b/modules/governance/pages/kill-switch.adoc @@ -1,4 +1,5 @@ = Kill Switch :description: Emergency controls to stop AI agent operations. +:personas: security_compliance_lead, pilot_lead, platform_engineer // TODO: Add content diff --git a/modules/governance/pages/permissions-overview.adoc b/modules/governance/pages/permissions-overview.adoc index da90daa..592e128 100644 --- a/modules/governance/pages/permissions-overview.adoc +++ b/modules/governance/pages/permissions-overview.adoc @@ -1,7 +1,7 @@ = About ADP Permissions :description: Understand how ADP permissions, built-in roles, and role bindings fit together to control access to AI Gateway, MCP, agents, pipelines, and governance APIs. :page-topic-type: concept -:personas: platform_admin, evaluator, app_developer +:personas: security_compliance_lead, platform_engineer :learning-objective-1: Explain how ADP permissions, roles, and role bindings fit together :learning-objective-2: Differentiate between the Admin, Writer, Reader, and Invoker built-in roles :learning-objective-3: Identify which built-in role grants the permissions a user or service account needs diff --git a/modules/governance/pages/permissions-reference.adoc b/modules/governance/pages/permissions-reference.adoc index 192cf28..888dd2e 100644 --- a/modules/governance/pages/permissions-reference.adoc +++ b/modules/governance/pages/permissions-reference.adoc @@ -1,7 +1,7 @@ = ADP Permissions Reference :description: Look up the permissions ADP enforces across LLM providers, MCP servers, agents, pipelines, knowledge bases, and governance APIs, and the built-in roles that grant them. :page-topic-type: reference -:personas: platform_admin +:personas: security_compliance_lead, platform_engineer :learning-objective-1: Look up an ADP permission by namespace :learning-objective-2: Find which built-in role grants a specific permission :learning-objective-3: Identify the operation each permission gates diff --git a/modules/integrations/pages/claude-code.adoc b/modules/integrations/pages/claude-code.adoc index f2d8855..eba9c22 100644 --- a/modules/integrations/pages/claude-code.adoc +++ b/modules/integrations/pages/claude-code.adoc @@ -1,7 +1,7 @@ = Use Claude Code with ADP :description: Point Claude Code at an ADP-managed Anthropic provider so your team's LLM calls flow through AI Gateway with centralized credentials, usage tracking, and per-provider transcript logging. Optionally attach MCP servers hosted in ADP. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure Claude Code to call an Anthropic provider hosted in AI Gateway instead of the public Anthropic API :learning-objective-2: Attach ADP-hosted MCP servers to Claude Code so its tools resolve against your managed tool catalog :learning-objective-3: Verify the connection and read usage in the *Cost & Usage* tab diff --git a/modules/integrations/pages/cline.adoc b/modules/integrations/pages/cline.adoc index cdf6a63..c158032 100644 --- a/modules/integrations/pages/cline.adoc +++ b/modules/integrations/pages/cline.adoc @@ -1,4 +1,5 @@ = Cline Integration :description: Integrate Redpanda ADP with Cline. +:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/continue.adoc b/modules/integrations/pages/continue.adoc index 71e4664..18ddcb1 100644 --- a/modules/integrations/pages/continue.adoc +++ b/modules/integrations/pages/continue.adoc @@ -1,4 +1,5 @@ = Continue Integration :description: Integrate Redpanda ADP with Continue. +:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/copilot.adoc b/modules/integrations/pages/copilot.adoc index bca5892..b1f9c65 100644 --- a/modules/integrations/pages/copilot.adoc +++ b/modules/integrations/pages/copilot.adoc @@ -1,4 +1,5 @@ = GitHub Copilot Integration :description: Integrate Redpanda ADP with GitHub Copilot. +:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/cursor.adoc b/modules/integrations/pages/cursor.adoc index 9100f87..3f23c87 100644 --- a/modules/integrations/pages/cursor.adoc +++ b/modules/integrations/pages/cursor.adoc @@ -1,4 +1,5 @@ = Cursor Integration :description: Integrate Redpanda ADP with Cursor IDE. +:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/index.adoc b/modules/integrations/pages/index.adoc index b0aff42..9d44682 100644 --- a/modules/integrations/pages/index.adoc +++ b/modules/integrations/pages/index.adoc @@ -1,3 +1,4 @@ = Integrations :description: Connect ADP-managed LLM providers and MCP servers to AI development environments such as Claude Code, Cursor, Continue, Cline, and GitHub Copilot. :page-layout: index +:personas: agent_builder, platform_engineer diff --git a/modules/integrations/pages/remote-mcp-clients.adoc b/modules/integrations/pages/remote-mcp-clients.adoc index 1ef1a2e..a350893 100644 --- a/modules/integrations/pages/remote-mcp-clients.adoc +++ b/modules/integrations/pages/remote-mcp-clients.adoc @@ -1,7 +1,7 @@ = Connect Remote MCP Clients to AI Gateway :description: Connect external MCP clients (Claude Desktop, ChatGPT desktop, Gemini Apps) to MCP servers hosted in AI Gateway. Covers the three-piece architecture (MCP server, OAuth Provider, OAuth Client) and the two-step OAuth flow that runs end-to-end. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer, security_compliance_lead :learning-objective-1: Register an OAuth Client in AI Gateway so an external chat app can authenticate users :learning-objective-2: Wire a custom connector in Claude Desktop (or another chat client) to your MCP server :learning-objective-3: Walk a user through the two-step OAuth flow that runs end-to-end diff --git a/modules/integrations/partials/integrations/claude-code-admin.adoc b/modules/integrations/partials/integrations/claude-code-admin.adoc index d017153..2cbde5d 100644 --- a/modules/integrations/partials/integrations/claude-code-admin.adoc +++ b/modules/integrations/partials/integrations/claude-code-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Claude Code :description: Configure Redpanda AI Gateway to support Claude Code clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Claude Code connectivity :learning-objective-2: Set up authentication and access control for Claude Code clients :learning-objective-3: Deploy MCP tool aggregation for Claude Code tool discovery diff --git a/modules/integrations/partials/integrations/claude-code-user.adoc b/modules/integrations/partials/integrations/claude-code-user.adoc index e2f83c6..a529ce7 100644 --- a/modules/integrations/partials/integrations/claude-code-user.adoc +++ b/modules/integrations/partials/integrations/claude-code-user.adoc @@ -1,7 +1,7 @@ = Configure Claude Code with AI Gateway :description: Configure Claude Code to use Redpanda AI Gateway for unified LLM access and MCP tool aggregation. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Claude Code to connect to AI Gateway endpoints :learning-objective-2: Set up MCP server integration through AI Gateway :learning-objective-3: Verify Claude Code is routing requests through the gateway diff --git a/modules/integrations/partials/integrations/cline-admin.adoc b/modules/integrations/partials/integrations/cline-admin.adoc index b537498..0b01234 100644 --- a/modules/integrations/partials/integrations/cline-admin.adoc +++ b/modules/integrations/partials/integrations/cline-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Cline :description: Configure Redpanda AI Gateway to support Cline clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Cline connectivity :learning-objective-2: Set up authentication and access control for Cline clients :learning-objective-3: Deploy MCP tool aggregation for Cline tool discovery diff --git a/modules/integrations/partials/integrations/cline-user.adoc b/modules/integrations/partials/integrations/cline-user.adoc index 7103fc6..114786b 100644 --- a/modules/integrations/partials/integrations/cline-user.adoc +++ b/modules/integrations/partials/integrations/cline-user.adoc @@ -1,7 +1,7 @@ = Configure Cline with AI Gateway :description: Configure Cline to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and autonomous coding workflows. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Cline to connect to AI Gateway for LLM requests and MCP tools :learning-objective-2: Set up autonomous mode with custom instructions and browser integration :learning-objective-3: Verify Cline routes requests through the gateway and optimize for cost diff --git a/modules/integrations/partials/integrations/continue-admin.adoc b/modules/integrations/partials/integrations/continue-admin.adoc index 5b49a82..b802390 100644 --- a/modules/integrations/partials/integrations/continue-admin.adoc +++ b/modules/integrations/partials/integrations/continue-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Continue.dev :description: Configure Redpanda AI Gateway to support Continue.dev clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Continue.dev connectivity :learning-objective-2: Set up multi-provider backends with native format routing :learning-objective-3: Deploy MCP tool aggregation for Continue.dev tool discovery diff --git a/modules/integrations/partials/integrations/continue-user.adoc b/modules/integrations/partials/integrations/continue-user.adoc index aa7dc58..07fa900 100644 --- a/modules/integrations/partials/integrations/continue-user.adoc +++ b/modules/integrations/partials/integrations/continue-user.adoc @@ -1,7 +1,7 @@ = Configure Continue.dev with AI Gateway :description: Configure Continue.dev to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and AI-assisted coding. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Continue.dev to connect to AI Gateway for chat and autocomplete :learning-objective-2: Set up MCP server integration through AI Gateway :learning-objective-3: Optimize Continue.dev settings for cost and performance diff --git a/modules/integrations/partials/integrations/cursor-admin.adoc b/modules/integrations/partials/integrations/cursor-admin.adoc index 1dd2e28..7df52c0 100644 --- a/modules/integrations/partials/integrations/cursor-admin.adoc +++ b/modules/integrations/partials/integrations/cursor-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for Cursor IDE :description: Configure Redpanda AI Gateway to support Cursor IDE clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for Cursor IDE connectivity :learning-objective-2: Set up OpenAI-compatible transforms for multi-provider routing :learning-objective-3: Deploy multi-tenant authentication strategies for Cursor clients diff --git a/modules/integrations/partials/integrations/cursor-user.adoc b/modules/integrations/partials/integrations/cursor-user.adoc index f60fe4c..4d5f0af 100644 --- a/modules/integrations/partials/integrations/cursor-user.adoc +++ b/modules/integrations/partials/integrations/cursor-user.adoc @@ -1,7 +1,7 @@ = Configure Cursor IDE with AI Gateway :description: Configure Cursor IDE to use Redpanda AI Gateway for unified LLM access, MCP tool integration, and AI-assisted coding. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure Cursor IDE to route LLM requests through AI Gateway :learning-objective-2: Set up MCP server integration for tool access through the gateway :learning-objective-3: Optimize Cursor settings for multi-tenancy and cost control diff --git a/modules/integrations/partials/integrations/github-copilot-admin.adoc b/modules/integrations/partials/integrations/github-copilot-admin.adoc index 7247880..c4eb526 100644 --- a/modules/integrations/partials/integrations/github-copilot-admin.adoc +++ b/modules/integrations/partials/integrations/github-copilot-admin.adoc @@ -1,7 +1,7 @@ = Configure AI Gateway for GitHub Copilot :description: Configure Redpanda AI Gateway to support GitHub Copilot clients. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer :learning-objective-1: Configure AI Gateway endpoints for GitHub Copilot connectivity :learning-objective-2: Deploy multi-tenant authentication strategies for Copilot clients :learning-objective-3: Set up model aliasing and BYOK routing for GitHub Copilot diff --git a/modules/integrations/partials/integrations/github-copilot-user.adoc b/modules/integrations/partials/integrations/github-copilot-user.adoc index 46add1f..b5621f6 100644 --- a/modules/integrations/partials/integrations/github-copilot-user.adoc +++ b/modules/integrations/partials/integrations/github-copilot-user.adoc @@ -1,7 +1,7 @@ = Configure GitHub Copilot with AI Gateway :description: Configure GitHub Copilot to use Redpanda AI Gateway for unified LLM access and custom provider management. :page-topic-type: how-to -:personas: ai_agent_developer, app_developer +:personas: agent_builder :learning-objective-1: Configure GitHub Copilot in VS Code and JetBrains IDEs to route requests through AI Gateway :learning-objective-2: Set up multi-tenancy with gateway routing for cost tracking :learning-objective-3: Configure enterprise BYOK deployments for team-wide Copilot access diff --git a/modules/integrations/partials/integrations/index.adoc b/modules/integrations/partials/integrations/index.adoc index 8150fff..98d378c 100644 --- a/modules/integrations/partials/integrations/index.adoc +++ b/modules/integrations/partials/integrations/index.adoc @@ -1,4 +1,5 @@ = AI Gateway Integrations :description: Configure AI development tools and IDEs to connect to Redpanda AI Gateway for centralized LLM routing and MCP tool aggregation. :page-layout: index +:personas: agent_builder, platform_engineer diff --git a/modules/mcp/pages/create-server.adoc b/modules/mcp/pages/create-server.adoc index b2bdedc..b375f17 100644 --- a/modules/mcp/pages/create-server.adoc +++ b/modules/mcp/pages/create-server.adoc @@ -1,7 +1,7 @@ = Create an MCP Server :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: platform_admin, app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Create a managed or self-managed MCP server in the ADP UI :learning-objective-2: Configure each authentication mode and pick the right one for your use case :learning-objective-3: Save the server, verify the API URL, and confirm tools were discovered diff --git a/modules/mcp/pages/github-oauth-tutorial.adoc b/modules/mcp/pages/github-oauth-tutorial.adoc index 10c8112..65c5f86 100644 --- a/modules/mcp/pages/github-oauth-tutorial.adoc +++ b/modules/mcp/pages/github-oauth-tutorial.adoc @@ -1,7 +1,7 @@ = Set Up GitHub OAuth Provider and MCP Server :description: Complete walkthrough for configuring GitHub as an OAuth provider and creating a user-delegated GitHub MCP server. :page-topic-type: tutorial -:personas: platform_admin, app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Create a GitHub OAuth app and register it as an OAuth provider in ADP :learning-objective-2: Test the OAuth connection proactively using My Connections :learning-objective-3: Create and configure a GitHub managed MCP server with user-delegated OAuth diff --git a/modules/mcp/pages/index.adoc b/modules/mcp/pages/index.adoc index ed0a8f1..78596e6 100644 --- a/modules/mcp/pages/index.adoc +++ b/modules/mcp/pages/index.adoc @@ -1,3 +1,4 @@ = MCP Servers :description: Connect AI agents to your databases, queues, CRMs, and other business systems through MCP servers managed by the Agentic Data Plane. :page-layout: index +:personas: agent_builder, platform_engineer diff --git a/modules/mcp/pages/managed/bamboohr.adoc b/modules/mcp/pages/managed/bamboohr.adoc index 4408052..947b1f0 100644 --- a/modules/mcp/pages/managed/bamboohr.adoc +++ b/modules/mcp/pages/managed/bamboohr.adoc @@ -1,7 +1,7 @@ = BambooHR Managed MCP Server :description: Let agents read BambooHR employee, time-off, and performance data with each caller's BambooHR OAuth identity. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the BambooHR managed MCP server with a BambooHR subdomain and user-delegated OAuth :learning-objective-2: Identify the BambooHR tools available to agents :learning-objective-3: Test BambooHR tool calls with an authorized user's connection diff --git a/modules/mcp/pages/managed/index.adoc b/modules/mcp/pages/managed/index.adoc index 0d28037..137d337 100644 --- a/modules/mcp/pages/managed/index.adoc +++ b/modules/mcp/pages/managed/index.adoc @@ -1,4 +1,5 @@ = Managed Catalog :page-layout: index :description: Managed MCP servers Redpanda hosts in-process, with deep-dive guides for the most common types. +:personas: agent_builder, platform_engineer diff --git a/modules/mcp/pages/managed/ironclad.adoc b/modules/mcp/pages/managed/ironclad.adoc index e024aa4..6881a55 100644 --- a/modules/mcp/pages/managed/ironclad.adoc +++ b/modules/mcp/pages/managed/ironclad.adoc @@ -1,7 +1,7 @@ = Ironclad Managed MCP Server :description: Read and manage contracts in Ironclad CLM. Per-user OAuth so each agent action runs as the calling end-user with their own Ironclad permissions. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Ironclad managed MCP server with per-user OAuth :learning-objective-2: Pick the right region and scopes for your tenant :learning-objective-3: List, fetch, and launch contract workflows from an agent diff --git a/modules/mcp/pages/managed/jira.adoc b/modules/mcp/pages/managed/jira.adoc index 3942684..f8c0f51 100644 --- a/modules/mcp/pages/managed/jira.adoc +++ b/modules/mcp/pages/managed/jira.adoc @@ -1,7 +1,7 @@ = Jira Managed MCP Server :description: Let agents read and manage Jira issues, projects, and workflows using each end-user's own Atlassian identity through user-delegated OAuth. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Jira managed MCP server with Atlassian's OAuth flow :learning-objective-2: Pick the right scopes for read-only vs. read-write workflows :learning-objective-3: Walk a user through the consent flow and verify the connection diff --git a/modules/mcp/pages/managed/kafka.adoc b/modules/mcp/pages/managed/kafka.adoc index 3789af1..85c139f 100644 --- a/modules/mcp/pages/managed/kafka.adoc +++ b/modules/mcp/pages/managed/kafka.adoc @@ -1,7 +1,7 @@ = Kafka Managed MCP Server :description: Produce, consume, and inspect topics on Kafka or Redpanda brokers through a managed MCP server hosted in the Agentic Data Plane. :page-topic-type: how-to -:personas: platform_admin, app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Kafka managed MCP server against a Kafka or Redpanda cluster :learning-objective-2: Produce a test message through the Inspector and consume it back :learning-objective-3: Pick the right authentication mode for your broker (PLAIN / SCRAM / mTLS / OAuth) diff --git a/modules/mcp/pages/managed/managed-catalog.adoc b/modules/mcp/pages/managed/managed-catalog.adoc index 75b3f75..0e363b7 100644 --- a/modules/mcp/pages/managed/managed-catalog.adoc +++ b/modules/mcp/pages/managed/managed-catalog.adoc @@ -1,7 +1,7 @@ = Managed MCP Server Catalog :description: Reference of every managed MCP server type Redpanda hosts in-process, grouped by category, with display name, description, and a link to a deep-dive where one exists. :page-topic-type: reference -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer Managed MCP servers are in-process implementations Redpanda hosts for you. Each type has a fixed set of glossterm:tool[,tools] and a type-specific configuration schema. To create one, open *MCP Servers > Create Server* in the ADP UI and pick the type from the marketplace picker. See xref:mcp:create-server.adoc[Create an MCP Server] for the full create flow. diff --git a/modules/mcp/pages/managed/metabase.adoc b/modules/mcp/pages/managed/metabase.adoc index a046bc0..ad5e50d 100644 --- a/modules/mcp/pages/managed/metabase.adoc +++ b/modules/mcp/pages/managed/metabase.adoc @@ -1,7 +1,7 @@ = Metabase Managed MCP Server :description: Give an LLM agent read-and-query access to a Metabase analytics instance through the semantic layer (search, get_table, query metrics) and SQL escape hatches (run_native_query, run_card). :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Metabase managed MCP server with a v0.49+ API key bound to the right Metabase group :learning-objective-2: pass:q[Identify when to use semantic-layer tools (`search`, `get_metric`, `query`) versus the native-SQL escape hatches (`run_native_query`, `run_card`)] :learning-objective-3: Run a metric-first analysis against your Metabase instance from the Inspector or an agent diff --git a/modules/mcp/pages/managed/netsuite.adoc b/modules/mcp/pages/managed/netsuite.adoc index 817773c..3c1745c 100644 --- a/modules/mcp/pages/managed/netsuite.adoc +++ b/modules/mcp/pages/managed/netsuite.adoc @@ -1,7 +1,7 @@ = NetSuite Managed MCP Server :description: Let agents read NetSuite records and run SuiteQL with each caller's NetSuite OAuth identity. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the NetSuite managed MCP server with account ID and user-delegated OAuth :learning-objective-2: Identify the NetSuite read-only tools available to agents :learning-objective-3: Test NetSuite tool calls with an authorized user's connection diff --git a/modules/mcp/pages/managed/openapi.adoc b/modules/mcp/pages/managed/openapi.adoc index 09688d7..2c710bf 100644 --- a/modules/mcp/pages/managed/openapi.adoc +++ b/modules/mcp/pages/managed/openapi.adoc @@ -1,7 +1,7 @@ = OpenAPI Managed MCP Server :description: Expose any OpenAPI- or Swagger-described HTTP API as MCP tools. Point Redpanda at a spec URL and get a fully-typed tool surface for agents, with no custom code. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the OpenAPI managed MCP server against an OpenAPI 3 spec :learning-objective-2: Pick the right authentication mode for the upstream API :learning-objective-3: Verify generated tools through the Inspector diff --git a/modules/mcp/pages/managed/ramp.adoc b/modules/mcp/pages/managed/ramp.adoc index 4d44041..c66563b 100644 --- a/modules/mcp/pages/managed/ramp.adoc +++ b/modules/mcp/pages/managed/ramp.adoc @@ -1,7 +1,7 @@ = Ramp Managed MCP Server :description: Manage Ramp corporate cards, transactions, spend limits, and reimbursements from an LLM agent. Per-user OAuth so each agent action runs as the calling end-user. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Ramp managed MCP server with per-user OAuth :learning-objective-2: Pick the right scopes and environment for production vs sandbox :learning-objective-3: List transactions, manage cards, and adjust spend limits from an agent diff --git a/modules/mcp/pages/managed/slack.adoc b/modules/mcp/pages/managed/slack.adoc index 7688b55..dd85b76 100644 --- a/modules/mcp/pages/managed/slack.adoc +++ b/modules/mcp/pages/managed/slack.adoc @@ -1,7 +1,7 @@ = Slack Managed MCP Server :description: Let agents post messages and read channels in your Slack workspace using each end-user's own Slack identity through user-delegated OAuth. :page-topic-type: how-to -:personas: app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Slack managed MCP server with user-delegated OAuth :learning-objective-2: Walk through the consent flow and verify the connection in My Connections :learning-objective-3: Send a test message through the Inspector diff --git a/modules/mcp/pages/managed/sql.adoc b/modules/mcp/pages/managed/sql.adoc index d2b1d38..f5fd10d 100644 --- a/modules/mcp/pages/managed/sql.adoc +++ b/modules/mcp/pages/managed/sql.adoc @@ -1,7 +1,7 @@ = SQL Managed MCP Server :description: Query SQL databases (Postgres, MySQL, ClickHouse, MSSQL, SQLite) through a managed MCP server hosted by Redpanda. :page-topic-type: how-to -:personas: platform_admin, app_developer +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the SQL managed MCP server for your database :learning-objective-2: Run a canonical SELECT query through the Inspector :learning-objective-3: Pick the right authentication and connection-string pattern for your database diff --git a/modules/mcp/pages/managed/workday.adoc b/modules/mcp/pages/managed/workday.adoc index 4185fcd..1977eeb 100644 --- a/modules/mcp/pages/managed/workday.adoc +++ b/modules/mcp/pages/managed/workday.adoc @@ -1,7 +1,7 @@ = Workday Managed MCP Server :description: Drive Workday Human Resources business processes from an LLM agent. The Workday managed MCP wraps Workday's Human_Resources SOAP web services and authenticates with a service-account refresh-token grant. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Workday managed MCP server with an Integration System User (ISU) refresh token :learning-objective-2: Choose the right WSDL version and tenant settings :learning-objective-3: Run a Change_Personal_Information business process from the Inspector or an agent diff --git a/modules/mcp/pages/managed/zendesk.adoc b/modules/mcp/pages/managed/zendesk.adoc index b97f449..3a28922 100644 --- a/modules/mcp/pages/managed/zendesk.adoc +++ b/modules/mcp/pages/managed/zendesk.adoc @@ -1,7 +1,7 @@ = Zendesk Managed MCP Server :description: Search and manage Zendesk Support tickets, users, and Help Center articles. Two auth modes (service-account API token or per-user OAuth) plus token-efficient response shaping for LLM agents. :page-topic-type: how-to -:personas: app_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Configure the Zendesk managed MCP server in API-token or User-OAuth mode :learning-objective-2: Pick the right scopes and Zendesk role for your workflows :learning-objective-3: Search, read, create, and update tickets from the Inspector or an agent diff --git a/modules/mcp/pages/oauth-providers.adoc b/modules/mcp/pages/oauth-providers.adoc index 383bf94..ef39fe6 100644 --- a/modules/mcp/pages/oauth-providers.adoc +++ b/modules/mcp/pages/oauth-providers.adoc @@ -1,7 +1,7 @@ = Configure an OAuth Provider :description: Register an OAuth provider in ADP so MCP servers can authenticate users (or service accounts) against an upstream system like Slack, Jira, GitHub, or Salesforce. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer, security_compliance_lead :learning-objective-1: Register an OAuth provider for an upstream system you want MCP servers to authenticate against :learning-objective-2: Grant the right permissions so principals can attach the provider to MCP servers :learning-objective-3: Edit, rotate credentials on, or delete an OAuth provider diff --git a/modules/mcp/pages/overview.adoc b/modules/mcp/pages/overview.adoc index f70a007..73b0ba3 100644 --- a/modules/mcp/pages/overview.adoc +++ b/modules/mcp/pages/overview.adoc @@ -1,7 +1,7 @@ = MCP Servers Overview :description: Connect AI agents to your databases, queues, CRMs, and other business systems through MCP servers, including fully managed types Redpanda hosts for you and self-managed servers proxied through the Agentic Data Plane. :page-topic-type: overview -:personas: evaluator, app_developer, platform_admin +:personas: agent_builder, platform_engineer The Model Context Protocol (MCP) is how AI agents talk to tools. In the Agentic Data Plane, you create *MCP Servers* that agents can connect to. Each MCP server exposes a set of glossterm:tool[,tools], glossterm:resource[,resources], and glossterm:prompt[,prompts] that an agent can discover at runtime through `tools/list` and invoke through structured JSON-RPC calls. Redpanda handles upstream credentials, authentication flows, observability, and aggregation, so you can focus on what your agents do, not on the plumbing. diff --git a/modules/mcp/pages/register-remote.adoc b/modules/mcp/pages/register-remote.adoc index f240ded..a3a2c4d 100644 --- a/modules/mcp/pages/register-remote.adoc +++ b/modules/mcp/pages/register-remote.adoc @@ -1,7 +1,7 @@ = Register a Self-Managed MCP Server :description: Front your own MCP server with a managed Redpanda URL. Pick a transport, configure authentication, and let agents discover the server's tools through Redpanda. :page-topic-type: how-to -:personas: platform_admin +:personas: platform_engineer, agent_builder :learning-objective-1: Register a self-managed MCP server in the ADP UI :learning-objective-2: Pick the right transport (SSE vs. Streamable HTTP) and authentication mode :learning-objective-3: Confirm tool discovery completed and the server is reachable through its proxy URL diff --git a/modules/mcp/pages/test-tools.adoc b/modules/mcp/pages/test-tools.adoc index 793257f..c6c217f 100644 --- a/modules/mcp/pages/test-tools.adoc +++ b/modules/mcp/pages/test-tools.adoc @@ -1,7 +1,7 @@ = Test an MCP Server's Tools with the Inspector :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: app_developer +:personas: agent_builder :learning-objective-1: Run an MCP tool from the Inspector and read its response :learning-objective-2: Inspect resources, prompts, and call history :learning-objective-3: Diagnose common errors (auth missing, scope upgrade required, transport mismatch) before pointing an agent at the server diff --git a/modules/mcp/pages/user-delegated-oauth.adoc b/modules/mcp/pages/user-delegated-oauth.adoc index 77129e2..2740090 100644 --- a/modules/mcp/pages/user-delegated-oauth.adoc +++ b/modules/mcp/pages/user-delegated-oauth.adoc @@ -1,7 +1,7 @@ = Configure User-Delegated OAuth for an MCP Server :description: Have each end-user authenticate against the MCP server's upstream system with their own credentials. Redpanda stores their token in the vault and injects it at call time. :page-topic-type: how-to -:personas: platform_admin, app_developer +:personas: platform_engineer, agent_builder, security_compliance_lead :learning-objective-1: Configure an MCP server to use user-delegated OAuth with a registered OAuth provider :learning-objective-2: Walk an end-user through the consent flow and verify the connection :learning-objective-3: Troubleshoot scope upgrades, token expiry, and refresh failures diff --git a/modules/observability/pages/byoa-telemetry.adoc b/modules/observability/pages/byoa-telemetry.adoc index 2956d56..e1fe9de 100644 --- a/modules/observability/pages/byoa-telemetry.adoc +++ b/modules/observability/pages/byoa-telemetry.adoc @@ -1,7 +1,7 @@ = BYOA Telemetry (OpenTelemetry) :description: Emit OpenTelemetry traces from your BYOA (Bring Your Own Agent) so the Agentic Data Plane can attribute calls, costs, and tool invocations to your agent. Covers the minimum required span contract, common optional attributes, and how it differs from a Redpanda-managed agent. :page-topic-type: how-to -:personas: agent_developer, platform_admin +:personas: agent_builder, platform_engineer :learning-objective-1: Identify the resource attributes and span attributes a BYOA agent must emit so transcripts and the governance dashboard can attribute calls correctly :learning-objective-2: Choose between optional enrichment attributes that improve dashboard fidelity (model, tool, agent name, conversation, cache tokens) :learning-objective-3: Validate a BYOA agent's telemetry by reading the resulting transcript and confirming non-zero metric values diff --git a/modules/observability/pages/concepts.adoc b/modules/observability/pages/concepts.adoc index 2aabe9e..ffd230b 100644 --- a/modules/observability/pages/concepts.adoc +++ b/modules/observability/pages/concepts.adoc @@ -1,7 +1,7 @@ = Observability :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: evaluator, agent_developer, platform_admin, data_engineer +:personas: domain_evaluator, security_compliance_lead, platform_engineer, agent_builder :learning-objective-1: Explain how transcripts and spans capture execution flow :learning-objective-2: Interpret transcript structure for debugging and monitoring :learning-objective-3: Distinguish between transcripts and audit logs diff --git a/modules/observability/pages/index.adoc b/modules/observability/pages/index.adoc index 7c27515..17dafb3 100644 --- a/modules/observability/pages/index.adoc +++ b/modules/observability/pages/index.adoc @@ -1,3 +1,4 @@ = Observability :description: Inspect, debug, and govern agentic AI with execution transcripts, metrics, and logs from Redpanda's Agentic Data Plane. :page-layout: index +:personas: platform_engineer, domain_evaluator, security_compliance_lead, agent_builder diff --git a/modules/observability/pages/ingest-custom-traces.adoc b/modules/observability/pages/ingest-custom-traces.adoc index d474009..f9b4533 100644 --- a/modules/observability/pages/ingest-custom-traces.adoc +++ b/modules/observability/pages/ingest-custom-traces.adoc @@ -1,6 +1,7 @@ = Ingest OpenTelemetry Traces from Custom Agents :description: Configure a Redpanda Connect pipeline to ingest OpenTelemetry traces from custom agents into Redpanda's immutable log for unified governance and observability. :page-topic-type: how-to +:personas: platform_engineer, agent_builder :learning-objective-1: pass:q[Configure and deploy a Redpanda Connect pipeline to receive OpenTelemetry traces from custom agents through HTTP and publish them to `redpanda.otel_traces`] :learning-objective-2: Validate trace data format and compatibility with existing MCP server traces :learning-objective-3: Secure the ingestion endpoint using authentication mechanisms diff --git a/modules/observability/pages/logs.adoc b/modules/observability/pages/logs.adoc index 00f992c..8049f6d 100644 --- a/modules/observability/pages/logs.adoc +++ b/modules/observability/pages/logs.adoc @@ -1,4 +1,5 @@ = Logs :description: Access and analyze AI agent logs. +:personas: platform_engineer, security_compliance_lead // TODO: Add content diff --git a/modules/observability/pages/metrics.adoc b/modules/observability/pages/metrics.adoc index 5c5ab5e..0f09fa9 100644 --- a/modules/observability/pages/metrics.adoc +++ b/modules/observability/pages/metrics.adoc @@ -1,4 +1,5 @@ = Metrics :description: Monitor AI agent metrics in Redpanda ADP. +:personas: platform_engineer, pilot_lead // TODO: Add content diff --git a/modules/observability/pages/transcripts.adoc b/modules/observability/pages/transcripts.adoc index cd7ebfa..2c54425 100644 --- a/modules/observability/pages/transcripts.adoc +++ b/modules/observability/pages/transcripts.adoc @@ -1,7 +1,7 @@ = Read a Transcript :description: Open a transcript in the ADP UI, read the conversation turn by turn, and investigate errors, costs, and performance. :page-topic-type: how-to -:personas: agent_developer, platform_admin +:personas: agent_builder, domain_evaluator, platform_engineer, security_compliance_lead :learning-objective-1: Filter and open a transcript for a specific agent or MCP server execution :learning-objective-2: Read a transcript as a turn-by-turn conversation, including tool calls and token usage :learning-objective-3: Investigate errors, slow turns, and cost anomalies from the transcript detail view diff --git a/modules/observability/partials/observability-logs.adoc b/modules/observability/partials/observability-logs.adoc index 62aad40..73e5daa 100644 --- a/modules/observability/partials/observability-logs.adoc +++ b/modules/observability/partials/observability-logs.adoc @@ -1,7 +1,7 @@ = Observability: Logs :description: Guide to AI Gateway request logs, including where to find logs, log fields, filtering, searching, inspecting requests, common analysis tasks, log retention, export options, privacy/security, and troubleshooting. :page-topic-type: reference -:personas: platform_admin, app_developer +:personas: platform_engineer, security_compliance_lead, agent_builder :learning-objective-1: Locate and filter request logs to debug failures or reconstruct conversations :learning-objective-2: Interpret log fields to diagnose performance and cost issues :learning-objective-3: Export logs for compliance auditing or long-term analysis diff --git a/modules/observability/partials/observability-metrics.adoc b/modules/observability/partials/observability-metrics.adoc index a196ca5..248c4fd 100644 --- a/modules/observability/partials/observability-metrics.adoc +++ b/modules/observability/partials/observability-metrics.adoc @@ -1,7 +1,7 @@ = Observability: Metrics and Analytics :description: Guide to AI Gateway metrics and analytics, including where to find metrics, key metrics explained, dashboard views, filtering/grouping, alerting, exporting, common analysis tasks, retention, API access, best practices, and troubleshooting. :page-topic-type: reference -:personas: platform_admin, app_developer +:personas: platform_engineer, pilot_lead :learning-objective-1: Monitor aggregate metrics to track usage patterns and budget adherence :learning-objective-2: Compare model and provider performance using latency and cost metrics :learning-objective-3: Configure alerts for budget thresholds and performance degradation diff --git a/modules/reference/pages/api.adoc b/modules/reference/pages/api.adoc index 846e9a5..b88a63a 100644 --- a/modules/reference/pages/api.adoc +++ b/modules/reference/pages/api.adoc @@ -1,4 +1,5 @@ = API Reference :description: Redpanda ADP API reference documentation. +:personas: platform_engineer, agent_builder // TODO: Add content diff --git a/modules/reference/pages/glossary.adoc b/modules/reference/pages/glossary.adoc index b72a4ef..0073bb0 100644 --- a/modules/reference/pages/glossary.adoc +++ b/modules/reference/pages/glossary.adoc @@ -1,5 +1,6 @@ = Glossary :description: Definitions of key terms used in Redpanda Agentic Data Plane documentation. +:personas: agent_builder, platform_engineer, security_compliance_lead, domain_evaluator, pilot_lead == Agentic Data Plane terms diff --git a/modules/reference/pages/index.adoc b/modules/reference/pages/index.adoc index 3662ce7..1366991 100644 --- a/modules/reference/pages/index.adoc +++ b/modules/reference/pages/index.adoc @@ -1,3 +1,4 @@ = Reference :description: API reference, glossary, and pipeline examples for the Redpanda Agentic Data Plane. :page-layout: index +:personas: platform_engineer, agent_builder diff --git a/modules/reference/pages/pipeline-examples.adoc b/modules/reference/pages/pipeline-examples.adoc index 471e49d..de238c3 100644 --- a/modules/reference/pages/pipeline-examples.adoc +++ b/modules/reference/pages/pipeline-examples.adoc @@ -1,4 +1,5 @@ = Pipeline Examples :description: Example pipelines for common AI agent use cases. +:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/reference/pages/rpk/index.adoc b/modules/reference/pages/rpk/index.adoc index 566fd50..51850ef 100644 --- a/modules/reference/pages/rpk/index.adoc +++ b/modules/reference/pages/rpk/index.adoc @@ -1,6 +1,7 @@ = rpk Commands :description: Reference for the rpk commands used to manage the Redpanda Agentic Data Plane from the command line. :page-layout: index +:personas: platform_engineer, agent_builder This section documents the `rpk` commands you use to manage the Redpanda Agentic Data Plane (ADP) from the command line. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc index 126c001..1aaec7b 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc @@ -1,4 +1,5 @@ = rpk ai install +:personas: platform_engineer, agent_builder Install the Redpanda AI CLI. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc index 8ac5cf8..5c95232 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc @@ -1,4 +1,5 @@ = rpk ai uninstall +:personas: platform_engineer, agent_builder Uninstall the Redpanda AI CLI. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc index b8deb43..4e07283 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc @@ -1,4 +1,5 @@ = rpk ai upgrade +:personas: platform_engineer, agent_builder Upgrade to the latest Redpanda AI CLI version. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc index fa251d7..665e945 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc @@ -1,4 +1,5 @@ = rpk ai +:personas: platform_engineer, agent_builder Manage the Redpanda AI Gateway diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc index c9801a8..b53cbe8 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc @@ -1,3 +1,4 @@ = rpk cloud cluster select +:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud-cluster-select.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc index 51fc87c..affe8af 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc @@ -1,3 +1,4 @@ = rpk cloud cluster +:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud-cluster.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc index 877e0b0..d62db97 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc @@ -1,3 +1,4 @@ = rpk cloud login +:personas: platform_engineer, agent_builder include::ROOT:reference:partial$rpk-cloud/rpk-cloud-login.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc index be669f9..7121a8e 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc @@ -1,3 +1,4 @@ = rpk cloud logout +:personas: platform_engineer, agent_builder include::ROOT:reference:partial$rpk-cloud/rpk-cloud-logout.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc index 2ea5d68..1fdb006 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc @@ -1,3 +1,4 @@ = rpk cloud +:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc b/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc index f7fb9ad..b008084 100644 --- a/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc +++ b/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc @@ -1,4 +1,5 @@ = rpk profile :page-aliases: reference:rpk/rpk-profile.adoc +:personas: platform_engineer, agent_builder include::ROOT:reference:rpk/rpk-profile/rpk-profile.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-x-options.adoc b/modules/reference/pages/rpk/rpk-x-options.adoc index bc010c3..a460b55 100644 --- a/modules/reference/pages/rpk/rpk-x-options.adoc +++ b/modules/reference/pages/rpk/rpk-x-options.adoc @@ -1,4 +1,5 @@ = rpk -X +:personas: platform_engineer, agent_builder Use the `-X` flag to override any rpk-specific configuration option for a single command, without modifying your rpk profile. Each option follows the form `key=value`: for example, `rpk -X tls.enabled=true` enables TLS for the Kafka API. From abc4322605fb6c33efb4e57961278d78702b9910 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 26 May 2026 16:45:32 -0600 Subject: [PATCH 2/3] Remove :personas: from pages that previously lacked the attribute Per follow-up review, this PR should only update pages that already carried :personas:. Pages that did not have the attribute before (index pages, reference pages, stubs) should not gain it as part of this vocabulary swap. Drops the :personas: line from 45 files that this branch had newly tagged. No other changes; the 93 pages with pre-existing :personas: metadata keep their newly-assigned slugs. Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/ROOT/partials/integrations/index.adoc | 1 - modules/agents/pages/build-index.adoc | 1 - modules/agents/pages/get-started-index.adoc | 1 - modules/agents/pages/index.adoc | 1 - modules/agents/pages/integration-index.adoc | 1 - modules/agents/pages/troubleshoot/index.adoc | 1 - modules/agents/pages/tutorials/index.adoc | 1 - modules/ai-gateway/pages/admin/index.adoc | 1 - modules/ai-gateway/pages/builders/index.adoc | 1 - modules/ai-gateway/pages/index.adoc | 1 - modules/get-started/pages/first-agent.adoc | 1 - modules/get-started/pages/index.adoc | 1 - modules/get-started/pages/rpk-install.adoc | 1 - modules/governance/pages/dashboard/index.adoc | 1 - modules/governance/pages/guardrails/index.adoc | 1 - modules/governance/pages/index.adoc | 1 - modules/governance/pages/kill-switch.adoc | 1 - modules/integrations/pages/cline.adoc | 1 - modules/integrations/pages/continue.adoc | 1 - modules/integrations/pages/copilot.adoc | 1 - modules/integrations/pages/cursor.adoc | 1 - modules/integrations/pages/index.adoc | 1 - modules/integrations/partials/integrations/index.adoc | 1 - modules/mcp/pages/index.adoc | 1 - modules/mcp/pages/managed/index.adoc | 1 - modules/observability/pages/index.adoc | 1 - modules/observability/pages/ingest-custom-traces.adoc | 1 - modules/observability/pages/logs.adoc | 1 - modules/observability/pages/metrics.adoc | 1 - modules/reference/pages/api.adoc | 1 - modules/reference/pages/glossary.adoc | 1 - modules/reference/pages/index.adoc | 1 - modules/reference/pages/pipeline-examples.adoc | 1 - modules/reference/pages/rpk/index.adoc | 1 - modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc | 1 - modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc | 1 - modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc | 1 - modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc | 1 - .../reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc | 1 - modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc | 1 - modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc | 1 - modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc | 1 - modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc | 1 - modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc | 1 - modules/reference/pages/rpk/rpk-x-options.adoc | 1 - 45 files changed, 45 deletions(-) diff --git a/modules/ROOT/partials/integrations/index.adoc b/modules/ROOT/partials/integrations/index.adoc index 98d378c..8150fff 100644 --- a/modules/ROOT/partials/integrations/index.adoc +++ b/modules/ROOT/partials/integrations/index.adoc @@ -1,5 +1,4 @@ = AI Gateway Integrations :description: Configure AI development tools and IDEs to connect to Redpanda AI Gateway for centralized LLM routing and MCP tool aggregation. :page-layout: index -:personas: agent_builder, platform_engineer diff --git a/modules/agents/pages/build-index.adoc b/modules/agents/pages/build-index.adoc index 2916228..f367980 100644 --- a/modules/agents/pages/build-index.adoc +++ b/modules/agents/pages/build-index.adoc @@ -1,6 +1,5 @@ = Build Agents :page-layout: index :description: Create production AI agents with effective prompts and scalable architecture. -:personas: agent_builder Create agents, write effective prompts, and design scalable agent systems. diff --git a/modules/agents/pages/get-started-index.adoc b/modules/agents/pages/get-started-index.adoc index c6da24d..aa08dab 100644 --- a/modules/agents/pages/get-started-index.adoc +++ b/modules/agents/pages/get-started-index.adoc @@ -1,6 +1,5 @@ = Get Started with AI Agents :page-layout: index :description: Get started with declarative AI agents in ADP. Connect tools, configure behavior, and deploy without writing agent code. -:personas: agent_builder Start here to create your first declarative AI agent. Select an LLM, define behavior, and connect tools from built-in connectors. diff --git a/modules/agents/pages/index.adoc b/modules/agents/pages/index.adoc index 36295da..6bb731e 100644 --- a/modules/agents/pages/index.adoc +++ b/modules/agents/pages/index.adoc @@ -1,5 +1,4 @@ = AI Agents :page-layout: index :description: Declare agent behavior using built-in connectors. No custom agent code required. -:personas: agent_builder, platform_engineer diff --git a/modules/agents/pages/integration-index.adoc b/modules/agents/pages/integration-index.adoc index 4b42f32..7a4b567 100644 --- a/modules/agents/pages/integration-index.adoc +++ b/modules/agents/pages/integration-index.adoc @@ -1,7 +1,6 @@ = Agent Integration :page-layout: index :description: Connect agents to external applications, pipelines, and other systems. -:personas: agent_builder, platform_engineer Choose integration patterns and connect agents to your systems. diff --git a/modules/agents/pages/troubleshoot/index.adoc b/modules/agents/pages/troubleshoot/index.adoc index 205ac67..d83e3e0 100644 --- a/modules/agents/pages/troubleshoot/index.adoc +++ b/modules/agents/pages/troubleshoot/index.adoc @@ -1,5 +1,4 @@ = Troubleshoot :page-layout: index :description: Diagnose and fix common issues with AI agents, including deployment failures, runtime behavior, tool execution, and pipeline integration. -:personas: agent_builder, platform_engineer diff --git a/modules/agents/pages/tutorials/index.adoc b/modules/agents/pages/tutorials/index.adoc index 01609e6..8ec8a2b 100644 --- a/modules/agents/pages/tutorials/index.adoc +++ b/modules/agents/pages/tutorials/index.adoc @@ -1,4 +1,3 @@ = Tutorials :description: End-to-end agent tutorials that walk through customer support, transaction dispute resolution, and other multi-agent workflows. :page-layout: index -:personas: agent_builder diff --git a/modules/ai-gateway/pages/admin/index.adoc b/modules/ai-gateway/pages/admin/index.adoc index 7eba589..b820f01 100644 --- a/modules/ai-gateway/pages/admin/index.adoc +++ b/modules/ai-gateway/pages/admin/index.adoc @@ -1,4 +1,3 @@ = For Admins :description: Set up and operate AI Gateway across providers, secrets, authentication, and observability for your team. :page-layout: index -:personas: platform_engineer, security_compliance_lead diff --git a/modules/ai-gateway/pages/builders/index.adoc b/modules/ai-gateway/pages/builders/index.adoc index 8e20981..f66b716 100644 --- a/modules/ai-gateway/pages/builders/index.adoc +++ b/modules/ai-gateway/pages/builders/index.adoc @@ -1,4 +1,3 @@ = For Builders :description: Discover available gateways and connect your applications and agents to AI Gateway. :page-layout: index -:personas: agent_builder diff --git a/modules/ai-gateway/pages/index.adoc b/modules/ai-gateway/pages/index.adoc index 85bc4b3..c23d63d 100644 --- a/modules/ai-gateway/pages/index.adoc +++ b/modules/ai-gateway/pages/index.adoc @@ -1,5 +1,4 @@ = AI Gateway :page-layout: index :description: Redpanda's managed proxy for LLM APIs. Create an LLM provider, and point your applications at a Redpanda-hosted URL with managed secrets, authentication, and observability. -:personas: agent_builder, platform_engineer diff --git a/modules/get-started/pages/first-agent.adoc b/modules/get-started/pages/first-agent.adoc index d64baf3..64ae9c8 100644 --- a/modules/get-started/pages/first-agent.adoc +++ b/modules/get-started/pages/first-agent.adoc @@ -1,5 +1,4 @@ = Build Your First Agent :description: Create and deploy your first AI agent with Redpanda ADP. -:personas: agent_builder // TODO: Add content diff --git a/modules/get-started/pages/index.adoc b/modules/get-started/pages/index.adoc index 8ccb58a..e6d612f 100644 --- a/modules/get-started/pages/index.adoc +++ b/modules/get-started/pages/index.adoc @@ -1,4 +1,3 @@ = Get Started :description: Set up your ADP environment, build your first agent, and invite your team. :page-layout: index -:personas: agent_builder, platform_engineer, pilot_lead diff --git a/modules/get-started/pages/rpk-install.adoc b/modules/get-started/pages/rpk-install.adoc index 5f8f2d6..ce70bd1 100644 --- a/modules/get-started/pages/rpk-install.adoc +++ b/modules/get-started/pages/rpk-install.adoc @@ -1,6 +1,5 @@ = Install or Update rpk :description: Install or update rpk to interact with Redpanda from the command line. -:personas: platform_engineer, agent_builder :env-cloud: include::ROOT:get-started:rpk-install.adoc[tag=single-source] diff --git a/modules/governance/pages/dashboard/index.adoc b/modules/governance/pages/dashboard/index.adoc index 141ee70..22bcf9e 100644 --- a/modules/governance/pages/dashboard/index.adoc +++ b/modules/governance/pages/dashboard/index.adoc @@ -1,5 +1,4 @@ = Governance Dashboard :page-layout: index :description: See your AI deployment's spending, fleet, and activity in one place, with drill-down into the transcript behind any number, agent, or event. -:personas: pilot_lead, platform_engineer, security_compliance_lead diff --git a/modules/governance/pages/guardrails/index.adoc b/modules/governance/pages/guardrails/index.adoc index a8b9e05..1792a2e 100644 --- a/modules/governance/pages/guardrails/index.adoc +++ b/modules/governance/pages/guardrails/index.adoc @@ -1,4 +1,3 @@ = Guardrails :description: Configurable safety and policy filters that run on the request or response side of every LLM call routed through AI Gateway. :page-layout: index -:personas: security_compliance_lead, platform_engineer diff --git a/modules/governance/pages/index.adoc b/modules/governance/pages/index.adoc index 95f563c..88395c0 100644 --- a/modules/governance/pages/index.adoc +++ b/modules/governance/pages/index.adoc @@ -1,4 +1,3 @@ = Governance :description: Govern agent behavior with guardrails, token budgets, the kill switch, and the governance dashboard. :page-layout: index -:personas: security_compliance_lead, platform_engineer, pilot_lead diff --git a/modules/governance/pages/kill-switch.adoc b/modules/governance/pages/kill-switch.adoc index 4e5bae3..d461b99 100644 --- a/modules/governance/pages/kill-switch.adoc +++ b/modules/governance/pages/kill-switch.adoc @@ -1,5 +1,4 @@ = Kill Switch :description: Emergency controls to stop AI agent operations. -:personas: security_compliance_lead, pilot_lead, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/cline.adoc b/modules/integrations/pages/cline.adoc index c158032..cdf6a63 100644 --- a/modules/integrations/pages/cline.adoc +++ b/modules/integrations/pages/cline.adoc @@ -1,5 +1,4 @@ = Cline Integration :description: Integrate Redpanda ADP with Cline. -:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/continue.adoc b/modules/integrations/pages/continue.adoc index 18ddcb1..71e4664 100644 --- a/modules/integrations/pages/continue.adoc +++ b/modules/integrations/pages/continue.adoc @@ -1,5 +1,4 @@ = Continue Integration :description: Integrate Redpanda ADP with Continue. -:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/copilot.adoc b/modules/integrations/pages/copilot.adoc index b1f9c65..bca5892 100644 --- a/modules/integrations/pages/copilot.adoc +++ b/modules/integrations/pages/copilot.adoc @@ -1,5 +1,4 @@ = GitHub Copilot Integration :description: Integrate Redpanda ADP with GitHub Copilot. -:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/cursor.adoc b/modules/integrations/pages/cursor.adoc index 3f23c87..9100f87 100644 --- a/modules/integrations/pages/cursor.adoc +++ b/modules/integrations/pages/cursor.adoc @@ -1,5 +1,4 @@ = Cursor Integration :description: Integrate Redpanda ADP with Cursor IDE. -:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/integrations/pages/index.adoc b/modules/integrations/pages/index.adoc index 9d44682..b0aff42 100644 --- a/modules/integrations/pages/index.adoc +++ b/modules/integrations/pages/index.adoc @@ -1,4 +1,3 @@ = Integrations :description: Connect ADP-managed LLM providers and MCP servers to AI development environments such as Claude Code, Cursor, Continue, Cline, and GitHub Copilot. :page-layout: index -:personas: agent_builder, platform_engineer diff --git a/modules/integrations/partials/integrations/index.adoc b/modules/integrations/partials/integrations/index.adoc index 98d378c..8150fff 100644 --- a/modules/integrations/partials/integrations/index.adoc +++ b/modules/integrations/partials/integrations/index.adoc @@ -1,5 +1,4 @@ = AI Gateway Integrations :description: Configure AI development tools and IDEs to connect to Redpanda AI Gateway for centralized LLM routing and MCP tool aggregation. :page-layout: index -:personas: agent_builder, platform_engineer diff --git a/modules/mcp/pages/index.adoc b/modules/mcp/pages/index.adoc index 78596e6..ed0a8f1 100644 --- a/modules/mcp/pages/index.adoc +++ b/modules/mcp/pages/index.adoc @@ -1,4 +1,3 @@ = MCP Servers :description: Connect AI agents to your databases, queues, CRMs, and other business systems through MCP servers managed by the Agentic Data Plane. :page-layout: index -:personas: agent_builder, platform_engineer diff --git a/modules/mcp/pages/managed/index.adoc b/modules/mcp/pages/managed/index.adoc index 137d337..0d28037 100644 --- a/modules/mcp/pages/managed/index.adoc +++ b/modules/mcp/pages/managed/index.adoc @@ -1,5 +1,4 @@ = Managed Catalog :page-layout: index :description: Managed MCP servers Redpanda hosts in-process, with deep-dive guides for the most common types. -:personas: agent_builder, platform_engineer diff --git a/modules/observability/pages/index.adoc b/modules/observability/pages/index.adoc index 17dafb3..7c27515 100644 --- a/modules/observability/pages/index.adoc +++ b/modules/observability/pages/index.adoc @@ -1,4 +1,3 @@ = Observability :description: Inspect, debug, and govern agentic AI with execution transcripts, metrics, and logs from Redpanda's Agentic Data Plane. :page-layout: index -:personas: platform_engineer, domain_evaluator, security_compliance_lead, agent_builder diff --git a/modules/observability/pages/ingest-custom-traces.adoc b/modules/observability/pages/ingest-custom-traces.adoc index f9b4533..d474009 100644 --- a/modules/observability/pages/ingest-custom-traces.adoc +++ b/modules/observability/pages/ingest-custom-traces.adoc @@ -1,7 +1,6 @@ = Ingest OpenTelemetry Traces from Custom Agents :description: Configure a Redpanda Connect pipeline to ingest OpenTelemetry traces from custom agents into Redpanda's immutable log for unified governance and observability. :page-topic-type: how-to -:personas: platform_engineer, agent_builder :learning-objective-1: pass:q[Configure and deploy a Redpanda Connect pipeline to receive OpenTelemetry traces from custom agents through HTTP and publish them to `redpanda.otel_traces`] :learning-objective-2: Validate trace data format and compatibility with existing MCP server traces :learning-objective-3: Secure the ingestion endpoint using authentication mechanisms diff --git a/modules/observability/pages/logs.adoc b/modules/observability/pages/logs.adoc index 8049f6d..00f992c 100644 --- a/modules/observability/pages/logs.adoc +++ b/modules/observability/pages/logs.adoc @@ -1,5 +1,4 @@ = Logs :description: Access and analyze AI agent logs. -:personas: platform_engineer, security_compliance_lead // TODO: Add content diff --git a/modules/observability/pages/metrics.adoc b/modules/observability/pages/metrics.adoc index 0f09fa9..5c5ab5e 100644 --- a/modules/observability/pages/metrics.adoc +++ b/modules/observability/pages/metrics.adoc @@ -1,5 +1,4 @@ = Metrics :description: Monitor AI agent metrics in Redpanda ADP. -:personas: platform_engineer, pilot_lead // TODO: Add content diff --git a/modules/reference/pages/api.adoc b/modules/reference/pages/api.adoc index b88a63a..846e9a5 100644 --- a/modules/reference/pages/api.adoc +++ b/modules/reference/pages/api.adoc @@ -1,5 +1,4 @@ = API Reference :description: Redpanda ADP API reference documentation. -:personas: platform_engineer, agent_builder // TODO: Add content diff --git a/modules/reference/pages/glossary.adoc b/modules/reference/pages/glossary.adoc index 0073bb0..b72a4ef 100644 --- a/modules/reference/pages/glossary.adoc +++ b/modules/reference/pages/glossary.adoc @@ -1,6 +1,5 @@ = Glossary :description: Definitions of key terms used in Redpanda Agentic Data Plane documentation. -:personas: agent_builder, platform_engineer, security_compliance_lead, domain_evaluator, pilot_lead == Agentic Data Plane terms diff --git a/modules/reference/pages/index.adoc b/modules/reference/pages/index.adoc index 1366991..3662ce7 100644 --- a/modules/reference/pages/index.adoc +++ b/modules/reference/pages/index.adoc @@ -1,4 +1,3 @@ = Reference :description: API reference, glossary, and pipeline examples for the Redpanda Agentic Data Plane. :page-layout: index -:personas: platform_engineer, agent_builder diff --git a/modules/reference/pages/pipeline-examples.adoc b/modules/reference/pages/pipeline-examples.adoc index de238c3..471e49d 100644 --- a/modules/reference/pages/pipeline-examples.adoc +++ b/modules/reference/pages/pipeline-examples.adoc @@ -1,5 +1,4 @@ = Pipeline Examples :description: Example pipelines for common AI agent use cases. -:personas: agent_builder, platform_engineer // TODO: Add content diff --git a/modules/reference/pages/rpk/index.adoc b/modules/reference/pages/rpk/index.adoc index 51850ef..566fd50 100644 --- a/modules/reference/pages/rpk/index.adoc +++ b/modules/reference/pages/rpk/index.adoc @@ -1,7 +1,6 @@ = rpk Commands :description: Reference for the rpk commands used to manage the Redpanda Agentic Data Plane from the command line. :page-layout: index -:personas: platform_engineer, agent_builder This section documents the `rpk` commands you use to manage the Redpanda Agentic Data Plane (ADP) from the command line. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc index 1aaec7b..126c001 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-install.adoc @@ -1,5 +1,4 @@ = rpk ai install -:personas: platform_engineer, agent_builder Install the Redpanda AI CLI. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc index 5c95232..8ac5cf8 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-uninstall.adoc @@ -1,5 +1,4 @@ = rpk ai uninstall -:personas: platform_engineer, agent_builder Uninstall the Redpanda AI CLI. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc index 4e07283..b8deb43 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai-upgrade.adoc @@ -1,5 +1,4 @@ = rpk ai upgrade -:personas: platform_engineer, agent_builder Upgrade to the latest Redpanda AI CLI version. diff --git a/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc b/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc index 665e945..fa251d7 100644 --- a/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc +++ b/modules/reference/pages/rpk/rpk-ai/rpk-ai.adoc @@ -1,5 +1,4 @@ = rpk ai -:personas: platform_engineer, agent_builder Manage the Redpanda AI Gateway diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc index b53cbe8..c9801a8 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster-select.adoc @@ -1,4 +1,3 @@ = rpk cloud cluster select -:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud-cluster-select.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc index affe8af..51fc87c 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-cluster.adoc @@ -1,4 +1,3 @@ = rpk cloud cluster -:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud-cluster.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc index d62db97..877e0b0 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-login.adoc @@ -1,4 +1,3 @@ = rpk cloud login -:personas: platform_engineer, agent_builder include::ROOT:reference:partial$rpk-cloud/rpk-cloud-login.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc index 7121a8e..be669f9 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-logout.adoc @@ -1,4 +1,3 @@ = rpk cloud logout -:personas: platform_engineer, agent_builder include::ROOT:reference:partial$rpk-cloud/rpk-cloud-logout.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc index 1fdb006..2ea5d68 100644 --- a/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc +++ b/modules/reference/pages/rpk/rpk-cloud/rpk-cloud.adoc @@ -1,4 +1,3 @@ = rpk cloud -:personas: platform_engineer include::ROOT:reference:partial$rpk-cloud/rpk-cloud.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc b/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc index b008084..f7fb9ad 100644 --- a/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc +++ b/modules/reference/pages/rpk/rpk-profile/rpk-profile.adoc @@ -1,5 +1,4 @@ = rpk profile :page-aliases: reference:rpk/rpk-profile.adoc -:personas: platform_engineer, agent_builder include::ROOT:reference:rpk/rpk-profile/rpk-profile.adoc[tag=single-source] diff --git a/modules/reference/pages/rpk/rpk-x-options.adoc b/modules/reference/pages/rpk/rpk-x-options.adoc index a460b55..bc010c3 100644 --- a/modules/reference/pages/rpk/rpk-x-options.adoc +++ b/modules/reference/pages/rpk/rpk-x-options.adoc @@ -1,5 +1,4 @@ = rpk -X -:personas: platform_engineer, agent_builder Use the `-X` flag to override any rpk-specific configuration option for a single command, without modifying your rpk profile. Each option follows the form `key=value`: for example, `rpk -X tls.enabled=true` enables TLS for the Kafka API. From 35df77cca622ad52216839ea8a2938b98917ddf5 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 26 May 2026 16:53:13 -0600 Subject: [PATCH 3/3] minor edit --- modules/integrations/pages/claude-code.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/integrations/pages/claude-code.adoc b/modules/integrations/pages/claude-code.adoc index eba9c22..1cce356 100644 --- a/modules/integrations/pages/claude-code.adoc +++ b/modules/integrations/pages/claude-code.adoc @@ -4,7 +4,7 @@ :personas: agent_builder, platform_engineer :learning-objective-1: Configure Claude Code to call an Anthropic provider hosted in AI Gateway instead of the public Anthropic API :learning-objective-2: Attach ADP-hosted MCP servers to Claude Code so its tools resolve against your managed tool catalog -:learning-objective-3: Verify the connection and read usage in the *Cost & Usage* tab +:learning-objective-3: Verify the connection and read usage Claude Code is Anthropic's command-line coding agent. When you point it at an AI Gateway proxy URL instead of the public Anthropic API, your team's LLM calls flow through ADP: API keys stay in the dataplane secret store, usage rolls up in the *Cost & Usage* tab, and the calls land in xref:observability:transcripts.adoc[the Transcripts view] for investigation.