Use Builder Agent in Builder Content
Builder Agent can assist you in the Builder Content UI. You describe a task in plain language, then the agent creates Pages, scaffolds sites, imports records, or updates content for you.
You review and approve the agent's work. You can then fine-tune individual entries in the Visual Editor. The agent follows your roles and permissions, so it can't do anything you couldn't do yourself.
Open and close the Builder Agent
The Builder Agent appears as a sidebar on the right side of the Content and Content Models pages. To make it appear, click the Open Content Agent button.
Start a chat
You can start a chat in two ways:
- Describe what you want in the chat input.
- Type
/to choose a built-in skill. Each skill has a short description.
A skill is a built-in workflow for a common task. The Builder Agent includes three built-in skills:
| Skill | What it does |
| Creates a new Page for a Page model. |
| Builds a set of Pages from a sitemap, CSV, or site URL. |
| Imports a CSV file into an existing Model. The agent maps your CSV's columns to the Model's fields. |
You aren't limited to skills. The agent can do anything the Builder Content MCP server supports, including targeting and scheduling.
In the video below, the Builder Agent is prompted to create a new content entry.
Scaffold a site
Use the scaffold-site skill to create the Pages for a new site. You can start from a sitemap, a CSV, or an existing site URL.
To scaffold a site:
- In the Builder Agent, type
/and selectscaffold-site. - Enter a site URL, or attach a sitemap or CSV.
- Review the structure the agent proposes. It lists the Pages it plans to create and the Pages it plans to exclude.
- Tell the agent what to change. For example, say “trim this to essential pages” or “add the pricing pages back.” Repeat until the list looks right.
- Choose to implement the list.
- Approve each batch of Pages. The agent asks for approval five Pages at a time.
The agent creates Pages as empty drafts and provides an editor link for each. You can then add content to the page from the agent or in the Visual Editor.
Import records from a CSV
Use the import-records skill to bring in many entries at once. For example, you can import blog posts exported from another CMS.
To import records from a CSV:
- In the Builder Agent, type
/and selectimport-records. - Drag your CSV file into the chat.
- If your Space has no matching Model, create one first. The agent asks which existing Model to import into.
- Review how the agent maps your CSV's columns to the Model's fields. The agent previews the first five rows.
- Approve the request to import the records.
To review what the agent sends, expand the request details before you approve.
Attach files and designs
You can attach context to any chat. You have three options:
- Import a Figma design to build a Page from it.
- Pick an existing file from your Asset Library.
- Upload a new file.
For example, attach a design and ask the agent to build out your Contact Us Page.
Approve the agent's actions
The agent asks for your approval before it changes your content. Each request shows what the agent will do and which entries it affects. Choose Approve to continue, or Cancel to stop.
You can choose how much approval the agent needs:
- Ask for approval (default): The agent asks before it changes content or Models.
- Full access: The agent can create content and Models without asking.
In either mode, the agent creates content as a draft unless you ask it to publish. To publish, go to the entry on the Content page. You can use the usual content tools there to review and undo changes.
Review your chat history
The Builder Agent keeps a history of your chats. To review past work, open the chat history. Then select a chat to review what the agent did or to continue it. Chats are private to you.
Choose a model and give feedback
The chat includes two controls for tuning your experience:
- Use the model selector in the chat input to choose which AI model powers your chat. Each response also shows the credits used.
- Use the feedback controls on the agent's responses to share what worked and what didn't.
Connect other tools
You can add other MCP servers to the agent to bring in outside context. Examples include Google Docs, Notion, Jira, and Linear.
