Build a page with AI

Turn a one-paragraph brief into a draft page built from real blocks, then make it yours. The AI never publishes: it drafts, you review, an editor publishes.

Before you start: a manager sets up a provider under Site settings → AI (Anthropic, OpenAI, Google, xAI or any OpenAI-compatible endpoint; the key is encrypted at rest) and fills the Brand profile (voice, tone, audience, terminology, banned words, boilerplate). You need content.create and ai.use.

Steps

1. Content → Pages → New page → Draft with AI. Write the brief as you would to a colleague: what the page is for, who reads it, what they should do next, the two or three facts that must be on it. Optionally pick the goal and audience.
2. Spillway asks the model for a layout made only of registered blocks, validates every block against its fields, repairs or drops what does not fit, and opens the result in the page builder as a draft. Nothing is saved until you save.
3. Read it as an editor would. Replace placeholder claims with facts, swap the Hero image for one from the media library, delete what you do not need. Select any text field and use Assist (rewrite, shorten, expand, change tone, fix, translate, summarize); the brand profile shapes every suggestion.
4. Run Checks: banned words from the brand profile, heading order, alt text, SEO lengths and internal links are all checked on the draft.
5. Submit for review, then an editor publishes (see Publish a campaign page).

Check the result

• The page exists as a draft with revision 1 authored by you, not by the model; its first revision note says it came from a brief.
• Site settings → AI → Usage shows the call with its provider, model and tokens; the audit log has a matching row.
• Nothing is public: the page's path answers 404 until an editor publishes.

From an agent

The same works through the MCP server: draft_page_from_brief returns a draft entity id, get_checks runs the checks, update_entity fixes fields, submit_for_review hands it to a person. See Connect an agent.

Going further

• AI in the API: POST /api/ai/page, POST /api/ai/assist, settings and usage.
• Blocks reference: the AI hint each block carries is what the model is told.
• Agent rules: why publishing stays with people.

Spillway 0.1.0 · Edit this page on GitHub