Skip to content

docs: Agent Gateway, API key usage dashboard, agents, and LLM Serving - #20

Closed
tmvfb wants to merge 1 commit into
stagingfrom
docs/agent-gateway-usage-dashboard
Closed

docs: Agent Gateway, API key usage dashboard, agents, and LLM Serving#20
tmvfb wants to merge 1 commit into
stagingfrom
docs/agent-gateway-usage-dashboard

Conversation

@tmvfb

@tmvfb tmvfb commented Aug 3, 2026

Copy link
Copy Markdown
Member

Summary

  • Agent Gateway (docs/agentops/agent_gateway.md): fleshed out from a stub — path families (/ai, /serving, /mcp, /a2a, /sandbox), public vs. internal traffic, and a new admin-only External Model Providers section disambiguating the two sidebar entries both labeled AI Gateway (API Keys under Serving vs. provider management under Admin).
  • API Keys (docs/platform/api_keys.md): new Usage Dashboard section documenting the per-workspace Usage tab (time windows, request-attribution cohorts, token/cost estimates, usage-by-key table, caveats).
  • Agents (docs/agentops/agents.md): fleshed out from a stub — the typical workflow (Secret → Model Configuration → Agent → MCP tools → chat test), the fixed OpenAI/Anthropic/Gemini vs. internal provider list, and the tool-calling caveat for internal models.
  • LLM Serving (docs/agentops/llm_serving.md, new page): deploying self-hosted models, Advanced Configuration (deployment mode, quantization, autoscaling), the tool-call parser table for agent tool calling, testing/editing, and external access via Agent Gateway. Wired into the sidebar nav and cross-linked from Agents, Agent Gateway, and Model Serving.
  • Corrected /ai vs /serving path-family ownership in Agent Gateway docs against the actual pkui route builders (both are shared families, not one-to-one with a single feature).

All facts were verified directly against ~/pkui frontend/backend source (route builders, module registrations, exact UI copy) and closed product-decision issues (prokube/pkui#2115, #2266) for the LLM Serving / AgentOps placement question, rather than assumed.

Two screenshot slots in API Keys use the existing text-placeholder convention (no image yet): api-key-usage-tab.png, api-key-usage-by-key-table.png.

Verification

npm run build — passes cleanly, including cross-page anchor links (verified against rendered HTML output).

…M Serving

- Flesh out Agent Gateway overview: path families (/ai, /serving, /mcp,
  /a2a, /sandbox), public vs. internal traffic, and admin-only External
  Model Providers (AI Gateway) workflow.
- Add a Usage Dashboard section to API Keys covering the per-workspace
  Usage tab (time windows, cohorts, token/cost estimates, usage-by-key
  table).
- Flesh out Agents: the Secret -> Model Configuration -> Agent -> MCP
  tools -> chat-test workflow, and tool-calling caveats for internal
  models.
- Add a new LLM Serving page (deploy, advanced configuration, tool-call
  parsers, testing, editing, external access via Agent Gateway).
- Correct /ai and /serving path-family ownership against the actual
  route builders in pkui.
@tmvfb

tmvfb commented Aug 3, 2026

Copy link
Copy Markdown
Member Author

Superseded by #21 — staging was restructured for versioned docs (#16) while this PR was open, moving all content under docs/versions/development/. Rebuilt the same changes on top of that structure there instead of resolving conflicts in place.

@tmvfb tmvfb closed this Aug 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant