---
title: Subject & Preview Text Ideation agent
slug: agent-platform/docs/subject-preview-text-ideation-agent
docTags: 
createdAt: 2026-08-12T15:37:10.000Z
---

**Subject & Preview Text Ideation** is an Optimizely Agent Platform agent that analyzes email content from Optimizely Campaign. It generates three pairs of subject lines and preview texts, each focused on urgency, curiosity, or benefit.

- **Challenge** – Crafting subject lines and preview texts for email campaigns takes significant effort. They must capture audience attention, drive open rates, and adhere to character limits. The work requires brainstorming, an understanding of psychological triggers, and a clear marketing rationale. Marketers find this process time-consuming and challenging.
- **Agent outcome** – The agent analyzes the provided email content and generates three pairs of subject lines and preview texts. Each pair adheres to character limits and focuses on urgency, curiosity, or benefit. The agent provides a marketing rationale for every suggestion.
- **Value** – Marketers access a variety of high-performing subject line and preview text options without time-consuming brainstorming. This improves email open rates and engagement. It also deepens understanding of how different messaging strategies affect campaign performance.

## Required Optimizely products

Optimizely Campaign

## 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 Optimizely Agent Platform 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 *Subject & Preview Text Ideation* or use the drop-down list filters to narrow the list.
3. Click **Install** on **Subject & Preview Text Ideation** to add it to your Agent Platform instance.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/e3ky7_wVilElNgDvvdTOC_install-subjectand-preview-text-idea-agent.png" size="100" isUploading="false" width="2404" height="1100" darkWidth="2404" darkHeight="1100" showCaption="false" indent="1"}

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

If **Install** is disabled, ensure you have the [Required Optimizely products](docId\:YKzJ5nXGart1DVazwK9R2) connected to your Agent Platform instance.
:::

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@subject\_preview\_text\_ideation* and provide at least one of the following details to identify the email content:

- (Optional) `campaignId` – The ID of a Smart Campaign.
- (Optional) `campaignName` – The name of a Smart Campaign.
- (Optional) `mailingId` – The ID of a message belonging to a Smart Campaign or a Transactional Mail.
- (Optional) `emailUrl` – The URL of the online version of a mailing.
- (Optional) `transactionalMailName` – The name of a Transactional Mail.
- (Optional) `transactionalMailId` – The ID of a Transactional Mail.

The agent delivers a [canvas](docId:1_VDSKJ_RG0FEQe0MCTv1) with three subject line and preview text pairs, each with a marketing rationale.

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

## Details

These are the default details for the **Subject & Preview Text Ideation** agent. After you [install the agent in your Agent Platform instance](docId\:YKzJ5nXGart1DVazwK9R2), you can customize these details based on your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **Subject & Preview Text Ideation** agent takes the following input:

- (Optional) `campaignId`
- (Optional) `campaignName`
- (Optional) `mailingId`
- (Optional) `emailUrl`
- (Optional) `transactionalMailName`
- (Optional) `transactionalMailId`

### Tools

The **Subject & Preview Text Ideation** agent uses the following tools internally to process your request:

- `campaign_get_smart_campaign_message_content`
- `campaign_get_smart_campaign`
- `campaign_get_smart_campaign_messages`
- `campaign_get_smart_campaign_list`
- `campaign_get_transactional_mail`
- `campaign_get_transactional_mail_list`
- `campaign_get_transactional_mail_message_content`
- `campaign_get_transactional_mail_messages`
- `browse_web`
- `browse_web_html`
- `create_canvas`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Balanced. Provides reliable answers with additional reasoning.
- **Files** – `agentstyling_20260429.html`.
- **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).
:::