docs: Agentic Data Plane docs updates (2026-08-07) - #202
Conversation
The agent detail view's interactive test tab is now labeled Playground, and its URL uses ?tab=playground. Update the agent testing, quickstart, troubleshooting, chart-rendering, and cost and usage pages to use the new name, and remove a tab that no longer appears from the quickstart's list of agent detail tabs.
✅ Deploy Preview for redpanda-agentic-data-plane ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
malinskibeniamin
left a comment
malinskibeniamin
left a comment
There was a problem hiding this comment.
Automated /review: 1 finding(s).
| * *Overview*: The agent's full configuration, organized into sections that you edit and save one at a time. The *Agent* section holds the display name, description, and tags (the agent ID is fixed). The *Model & runtime* section holds the LLM provider, model, and max iterations, along with the runtime status and endpoint. The *System prompt*, *MCP servers*, and *Subagents* sections hold the instructions, attached servers, and subagents. | ||
| * *Triggers*: Schedules and event sources that invoke the agent. See xref:connect:triggers/overview.adoc[]. | ||
| * *Inspector*: An interactive test surface. See <<test-your-agent,Test your agent>>. | ||
| * *Playground*: An interactive test surface. See <<test-your-agent,Test your agent>>. |
There was a problem hiding this comment.
Priority: P1
Rename is incomplete: one agent-tab reference still says Inspector.
Evidence: this PR renames the agent interaction tab to Playground across create-agent.adoc, draw-charts.adoc, cost-usage.adoc, agent-builder-quickstart.adoc, monitor-agents.adoc, and troubleshoot-ai-agents.adoc, but modules/gateway/pages/configure-provider.adoc:207 still reads "...such as the context-window indicator on the agent's Inspector tab." That is the same agent detail tab this PR renamed, not the MCP server Inspector tab (correctly left alone in test-tools.adoc and the managed/* pages).
Consequence: a reader following the provider/model-limits page looks for an Inspector tab that no longer exists in the UI, and the docs now contradict themselves on the label for the same surface.
Correction: in modules/gateway/pages/configure-provider.adoc:207, change the agent's *Inspector* tab to the agent's *Playground* tab.
Verify: rg -n 'agent.{0,20}\*Inspector\*' modules/ returns no matches (remaining Inspector hits should be MCP-server pages and dated release-notes entries only).
Automated /review.
The context-window indicator sentence still referred to the agent's Inspector tab; the tab is now named Playground. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3 participants
Summary
Updates the Agentic Data Plane docs for 2026-08-07.
Changes
modules/monitor/pages/monitor-agents.adoc: Rename the agent's interactive test tab from Inspector to Playground throughout the agent monitoring guide.modules/monitor/pages/troubleshoot-ai-agents.adoc: Refer to the agent's Playground tab when reproducing and diagnosing issues.modules/connect/pages/create-agent.adoc: Rename the agent's Inspector test tab to Playground.modules/connect/pages/draw-charts.adoc: Describe inline chart rendering in the agent's Playground tab.modules/control/pages/cost-usage.adoc: Update the Activity hand-off note to reference the Playground live view.modules/get-started/pages/agent-builder-quickstart.adoc: Use the Playground tab name and drop a tab that no longer appears from the list of agent detail tabs.modules/gateway/pages/configure-provider.adoc: Rename the remaining agent Inspector tab reference (the context-window indicator sentence) to Playground.The production UI may lag these changes by a few days.
Preview pages