---
title: Page Builder agent (CMS SaaS)
slug: agent-platform/docs/page-builder-agent
docTags: 
createdAt: 2026-08-12T15:37:10.000Z
---

**Page Builder** is an agent in Agent Platform. It analyzes a document, image, or URL. The agent then creates an Optimizely Content Management System (SaaS) content item of a specified content type.

- **Challenge** – Editors spend significant time manually creating CMS (SaaS) content from designs, documents, or external sources.
- **Agent outcome** – The Page Builder agent creates a populated CMS (SaaS) content item that matches the specified content type, using the provided input.
- **Value** – The Page Builder agent accelerates content production by eliminating manual content entry and formatting steps.

## Prerequisites

Before using the **Page Builder** agent, complete the following:

- Have Optimizely Content Management System (SaaS).
- Run the [Content Analysis agent](docId:5m5PFazFb6v6PDJgVJq7B) for the content type you want to build.

## Install agent

:::hint{type="info"}
**Note**

**Mark Administrators**, **Agent Builders**, and users with the **Add, edit, and install specialized agents** attribute for a custom role can add agents to their organization's Mark instance. See [Add users and set permissions.](../../get-started/get-started-with-optimizely-opal-for-administrators.mdx)
:::

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Begin entering *Page Builder* or use the drop-down list filters to narrow the list.
3. Click **Install** on **Page Builder** to add it to your Mark instance.

![screenshot of the Directory Agents page where Install is selected for Page Builder](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/v9orAO72KWutGtWc-hRS2_pagebuilderinstall.png)

:::hint{type="info"}
**Note**

If **Install** is disabled, connect the [Required Optimizely products](docId\:cDY-jFUnmvDkCFBHpFVi_) to your Mark instance first.
:::

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@page\_builder* and provide these details:

- `content_type` – The CMS (SaaS) content type to use when creating content.
- `parent` – The parent content item under which Page Builder creates the content.
- (Optional) `file` – Images or documents to use as input for creating content or as assets in the created content.
- (Optional) `prompt` – A URL or other input for creating content.

The agent creates a CMS (SaaS) content item populated with content from the provided input, matching the specified content type structure.

To use the **Page Builder** agent in a [workflow agent](docId:2HD0fUsIsfdek516VtN9l), drag and drop it into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

The **Page Builder** agent uses these default details. After you [install the agent in your Mark instance](docId\:cDY-jFUnmvDkCFBHpFVi_), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **Page Builder** agent takes this input:

- `content_type`
- `parent`
- (Optional) `file`
- (Optional) `prompt`

### Tools

The **Page Builder** agent uses the following tools internally to process your request:

- `cms_get_content_type_details`
- `cms_update_content_item`
- `browse_web_html`
- `cms_list_content_types`
- `take_webpage_screenshot`
- `cms_get_content_preview_url`
- `cms_upload_media`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Pro. Provides maximum reasoning depth.
- **Files** – None.
- **Output** – Text.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::