docs: sync ADP changes from cloudv2 (2026-06-21)

[micheleRP]

Summary

Syncs one user-facing ADP change from cloudv2 main (last 24h) into the docs.

The agent Setup tab now generates ready-to-paste integration samples for three additional frameworks — Vercel AI SDK, ADK Python, and Mastra — expanding the picker from 5 to 8 frameworks. This PR documents them on the self-managed agents page:

• modules/connect/pages/self-managed-agents.adoc
  • Updated the supported-frameworks list (Prerequisites) to include ADK Python, Vercel AI SDK, and Mastra.
  • Added a tab for each of the three frameworks in the Framework samples section, following the existing per-framework convention: a complete code file that runs the client_credentials grant, points the model at the provider-scoped gateway URL, connects MCP servers over Streamable HTTP, and stamps the X-Redpanda-Genai-Conversation header on every LLM and tool call. Each sample switches on REDPANDA_LLM_PROVIDER_TYPE to cover OpenAI-compatible, Anthropic, and Google providers, matching the existing ai-sdk-go / LangChain / CrewAI tabs.

The samples are grounded in the cloudv2 snippet templates (apps/adp-ui/src/components/agents/setup-tab-snippets.{vercel-ai-sdk,adk-python,mastra}.ts): provider constructors, base-URL version segments (/v1, /v1beta), package APIs, and the conversation-header wiring are taken verbatim. The docs render a single unified sample per framework (rather than the per-provider variant the Setup tab emits), to match the page's convention.

cloudv2 commits documented

• 1cb2760 feat(adp-ui): add Vercel AI SDK, ADK Python, and Mastra setup guides (PR #27322, author @malinskibeniamin). Follow-up commits in the same window (62455d5, 58af412, 3807f0c, 66caba4) are review/test/CSS refinements to the same feature.

Reviewed but not documented (no docs impact)

• PR #27305 — aigw: pin (mcp.v1.tool_name) on all managed MCPs (AI-1347 sweep). This pins the short, snake_case tool names (for example get_employee, copy_object, query) that the managed MCP server pages already document. Spot-checked bamboohr, salesforce, servicenow, sharepoint, ironclad, and workday — every documented tool name already matches the newly-pinned name, and no doc references the old redpanda_mcps_<server>_v1_<Service>_<Method> form. No docs change required.
• PR #27311 — mcp/compliance-quality. Internal handler refactor (removes unused cfg fields). No user-facing surface.
• Remaining adp-ui commits in the window (pagination defaults, line-number gutter CSS, visual-baseline regen) are internal/UI-only with no docs surface.

Optional reviewer

Added @malinskibeniamin (author of the source commit) as an optional reviewer for a source-accuracy courtesy check — their approval is not blocking for merge.

Preview

Deploy preview (404s until Netlify finishes building):
https://deploy-preview-107--redpanda-agentic-data-plane.netlify.app/agentic-data-plane/connect/self-managed-agents/

[netlify]

✅ Deploy Preview for redpanda-agentic-data-plane ready!

Name	Link
🔨 Latest commit	368fcb4
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a37d66ec8b6d200084a3c20
😎 Deploy Preview	https://deploy-preview-107--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[micheleRP]

[adp-docs PR critic]

Verdict: looks accurate against the source. I reviewed the full diff and verified every factual claim against the cloudv2 snippet templates at the same ref the PR cites. No critical or correctness issues found.

What I verified (source accuracy)

All three new samples are faithful, unified-env-var adaptations of the cloudv2 per-provider templates (commit a7ce4cd):

• ADK Python vs apps/adp-ui/src/components/agents/setup-tab-snippets.adk-python.ts: model routing matches exactly — anthropic/<model> on the native Messages wire, and openai/<model> for both OpenAI and Google (LiteLlm's gemini/ provider drops /v1beta on a custom api_base). LiteLlm(api_base, api_key="redpanda-gateway", extra_headers=…), StreamableHTTPConnectionParams(url=…, headers=…), imports, and the client_credentials POST all match. The model_arg() switch on REDPANDA_LLM_PROVIDER_TYPE is a correct unified-form rewrite of the build-time providerKind branch.
• Vercel AI SDK vs …setup-tab-snippets.vercel-ai-sdk.ts: the createAnthropic (${base}/v1), createGoogleGenerativeAI (${base}/v1beta), and createOpenAICompatible (bare base, apiKey: token) blocks match verbatim, including that only the OpenAI-compatible branch turns apiKey into the bearer while the native branches carry Authorization in headers. createMCPClient({ transport: { type: 'http', url, headers } }) and stopWhen: stepCountIs(10) match.
• Mastra vs …setup-tab-snippets.mastra.ts: gatewayFetch (bearer cached + refreshed, conversation id from AsyncLocalStorage), the three provider blocks with fetch: gatewayFetch, MCPClient server map, agent.generate(prompt, { maxSteps: 10 }), and mcp.disconnect() all match.

Other checks

• Env-var contract: every variable the new samples read (REDPANDA_TOKEN_URL, REDPANDA_CLIENT_ID/SECRET, REDPANDA_LLM_PROVIDER_URL, REDPANDA_LLM_PROVIDER_TYPE, REDPANDA_LLM_MODEL, REDPANDA_MCP_BASE_URL, REDPANDA_MCP_SERVERS) is documented in the table at lines 150–180 and is the same contract the existing CrewAI / ADK Java / ADK Go tabs use. Consistent.
• Header name X-Redpanda-Genai-Conversation confirmed against apps/aigw/internal/spanidentity/spanidentity.go and apps/ai-agent/internal/agent/session.go.
• Prereq list (line 48) correctly grows from 5 to 8 frameworks, in the same order as the tabs. No other framework-count reference in the file needed updating.
• AsciiDoc: the three new Label:: / + / -- … -- tabs are inserted inside the existing [tabs] / ====== block before the closing delimiter, matching the existing tab structure. Source blocks are -----delimited (verbatim), so the ${…} template literals won't trigger attribute substitution. The trailing ADK Go NOTE remains accurate.

Minor (non-blocking)

• The PR's "Reviewed but not documented" notes (e.g. the #27305 tool-name pin claim that documented names already match) are scoping decisions outside this diff; I did not independently re-verify each spot-check, but nothing in the documented diff depends on them.

No changes requested — this is a clean sync.

---

Generated by Claude Code