Update docs to match Package 2 engineering progress#29
Merged
Conversation
Brings ADP docs in line with the Package 2 briefing (May 22, 2026) across five shipped or in-production features. LLM Proxy (configure-provider.adoc) - New "Configure transcript logging" section covering the per-provider toggle, the sensitive-provider pattern, and what telemetry continues to flow when capture is off. - Clarify that Redpanda maintains the available-models catalog and adds upstream releases within a day or two; admins still tick to enable. Claude Code integration (claude-code.adoc) - Replace the TODO stub with a full page. When-to-use, get the proxy URL, two configuration tabs (OIDC service account / Anthropic Auth passthrough), attach ADP-hosted MCP servers, verify, troubleshoot. Managed MCP (create-server.adoc, connect-agent.adoc) - Surface the Connection tab on the MCP server detail page in the Save and verify list (TODO flags the exact tab naming for eng). - Add an explicit [[authenticate-with-oidc-client-credentials]] anchor in connect-agent.adoc so other pages can xref it. Cost Tracking (budgets.adoc, dashboard/overview.adoc) - New "Query spend programmatically" section in budgets.adoc with OIDC auth, the SpendingFilter request shape, group_by values, and worked cURL + Python examples. - TODO comment in dashboard/overview.adoc listing the five surfaces eng needs to confirm as shipped in Package 2 today vs. coming Jun 15 (per-user filter, Top users panel, Agents drill-down, per-agent grouping, Cost & Usage user filter). MCP OAuth Clients (remote-mcp-clients.adoc) - New "No Dynamic Client Registration (RFC 7591)" entry in the Limitations section so readers understand why every MCP client must be registered up-front. - Add Microsoft Copilot Studio to the supported chat clients list (TODO-marked pending an end-to-end verification with eng). Style - Removed all em dashes from new content per docs-team-standards. Replacements split into semicolons, colons, parentheses, and sentence breaks based on construction. PR-context doc - Includes package-2-doc-verification-plan.md at the repo root: the feature-by-feature gap analysis behind these changes. Lives outside modules/ so Antora ignores it; kept for the next time the Package 2 benchmark is updated. Microsoft Teams integration from the briefing (95%+ shipped) is deliberately not in this PR. Eng verification of labels, auth model, and v1/v2 messaging is pending; see plan Section 3 for the recommended approach. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for redpanda-agentic-data-plane ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Brings ADP docs in line with the Package 2 briefing (May 22, 2026) across five shipped or in-production features. The benchmark verification plan that drove these changes is included at
package-2-doc-verification-plan.mdso we can reuse it when the briefing next gets updated.Changes by feature
LLM Proxy (
modules/ai-gateway/pages/configure-provider.adoc)Claude Code integration (
modules/integrations/pages/claude-code.adoc)// TODOstub with a full page: when-to-use, get the proxy URL, two configuration tabs (OIDC service account / Anthropic Auth passthrough), attach ADP-hosted MCP servers, verify, troubleshoot.Managed MCP (
modules/mcp/pages/create-server.adoc,modules/ai-gateway/pages/connect-agent.adoc)[[authenticate-with-oidc-client-credentials]]anchor inconnect-agent.adocso other pages can xref it reliably.Cost Tracking (
modules/governance/pages/budgets.adoc,modules/governance/pages/dashboard/overview.adoc)budgets.adocwith OIDC auth, theSpendingFilterrequest shape,group_byvalues, and worked cURL + Python examples.dashboard/overview.adoclisting the five surfaces engineering needs to confirm as shipped today vs. coming Jun 15 (per-user filter, Top users panel, Agents drill-down, per-agent grouping, Cost & Usage user filter).MCP OAuth Clients (
modules/integrations/pages/remote-mcp-clients.adoc)Out of scope
The Microsoft Teams integration from the briefing (95%+ shipped) is deliberately not in this PR. Engineering verification of labels, auth model, and v1/v2 messaging is pending; see
package-2-doc-verification-plan.mdSection 3 for the recommended approach.Open questions for engineering
Each item below is also flagged as a
// TODOcomment in the relevant file.gen_ai.prompt.*andgen_ai.completion.*OTel attributes only or also touches token-count attributes.GetSpendingBreakdown, per-user filter on Cost & Usage).GetSpendingTimeSeries/GetSpendingSummary/ListSpendingEventsagainst the actual proto, whether the proto-generated client is recommended over raw HTTPS, OIDC-claim population ofuser_idandorganization_id, multi-tenant scope oforganization_idin the public API./mcp/v1/servers/<name>is a placeholder).Preview pages
Test plan
xref:ai-gateway:connect-agent.adoc#authenticate-with-oidc-client-credentials,xref:governance:permissions-reference.adoc#spending-permissions,xref:governance:dashboard/overview.adoc,xref:observability:transcripts.adoc,xref:mcp:user-delegated-oauth.adoc,xref:ai-gateway:aggregation.adoc,xref:integrations:remote-mcp-clients.adoc, andxref:agents:integration-overview.adocall resolve.[[authenticate-with-oidc-client-credentials]]inconnect-agent.adocand[[query-spend-programmatically]]inbudgets.adocrender at the correct headings.<<register-an-oauth-client-in-ai-gateway,Register an OAuth Client>>inremote-mcp-clients.adocresolves to the heading on the same page.claude-code.adoccontent renders correctly (tabs, source blocks, table).package-2-doc-verification-plan.mdat the repo root is not included in the Antora build output (lives outsidemodules/).