docs(kdp): document AI Blueprints and AI-generated forms#2227
Conversation
kubermatic-bot
added
do-not-merge/work-in-progress
|
Skipping CI for Draft Pull Request. |
kubermatic-bot
added
the
size/L
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
kubermatic-bot
removed
the
do-not-merge/work-in-progress
There was a problem hiding this comment.
Pull request overview
Adds documentation for two KDP v1.1 AI-assisted authoring features: generating tailored dashboard UIs for services (UI Builder + generateUI) and AI-assisted Blueprint authoring within the dashboard.
Changes:
- Adds a new “AI-Generated Forms” page describing the UI Builder workflow,
spec.generateUI: true, and schema drift/regeneration. - Expands the Blueprints documentation with a “Building Blueprints with AI” section covering grounding, modes (Create/Edit/Fix), and safety notes.
- Cross-links both AI feature pages in their respective “Availability” and “Related topics” sections.
Reviewed changes
Copilot reviewed 2 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| content/developer-platform/v1.1/service-providers/generated-forms/_index.en.md | New page documenting UI Builder usage, async first-draft generation via generateUI, and UI/schema sync behavior. |
| content/developer-platform/v1.1/service-providers/blueprints/_index.en.md | Adds an AI assistant section to Blueprint authoring docs and links to the new AI-Generated Forms page. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
mstruebing
left a comment
mstruebing
left a comment
There was a problem hiding this comment.
In one of my previous companies, where we've had dedicated technical writers for our documentation, there was a rule to never include screenshots as they are a hell to maintain. They will get outdated VERY quickly and it's super super hard to keep track of every place that needs an update and regenerating these updated screenshots is also very hard with the exact same scenarios.
I do not say we shouldn't include screenshots, but we should think about it and make it conscious.
| Graph** you can inspect either as a diagram or as the underlying RGD YAML. | ||
| The dashboard provides a visual Blueprint builder: a resource-graph editor where you add | ||
| services as nodes and wire their fields together, plus an **AI assistant** panel (see | ||
| [Building Blueprints with AI](#building-blueprints-with-ai) below). Published Blueprints get a |
There was a problem hiding this comment.
We should align on releasing it/toggling the feature flag before publishing these docs or mentioning the feature flag.
| @@ -0,0 +1,79 @@ | |||
| +++ | |||
| title = "AI-Generated Forms" | |||
There was a problem hiding this comment.
We also have the ability AI generate detail pages.
| @@ -0,0 +1,79 @@ | |||
| +++ | |||
| title = "AI-Generated Forms" | |||
There was a problem hiding this comment.
We should probably mention in here that this is workspace specific, every workspace can have their own UI for create/detail and even list view (list view is no AI involved though) as well as the service provider can provide defaults.
Service provider can generate a UI -> every consumer workspace will use that unless they create their own.
Documents two KDP AI features under v1.1: AI-assisted blueprint authoring and AI-generated service UI.
generateUIfirst draft.Screenshots are placeholders for now. I'll drop the images in before marking this ready.
Closes kubermatic/developer-platform#735.