Heatmap Analysis agent
Heatmap Analysis is an agent in Mark (Optimizely Agent Platform). It transforms a provided heatmap image and URL into precise, tailored test ideas.
- Challenge – Creating high-quality test ideas is difficult.
- Agent outcome – Analyzes your webpage based on the heatmap and URL you provide, and generates test ideas to optimize it.
- Value – Pinpoint high-impact optimization opportunities and reduce the time required to translate user behavior data into testable experiments.
See Heatmap Analysis Agent in Optimizely Academy for information.
Install agent
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.
Install the agent from the Directory.
- Go to Directory > Agents.
- (Optional) Enter Heatmap Analysis or use the drop-down list filters to narrow the list.
- Click Install on Heatmap Analysis to add it to your Mark instance.

Use the agent
In Mark chat, enter @heatmap_analysis and provide the following details:
- url – The page to analyze.
- heatmap – Heatmap image of the page you are analyzing.
The Heatmap Analysis agent returns a prioritized list of conversion rate optimization (CRO) test ideas. The list contains key findings, ranked opportunities, and a test backlog organized by quick wins, medium bets, and bold bets.
To use the Heatmap Analysis agent in a workflow agent, add it to your workflow. See Create a workflow agent.
Default agent details
The following are the default details of the Heatmap Analysis agent. After you install the agent in your Mark instance, customize these details based on your organization's needs. See Manage agents for instructions.
Input variables
The Heatmap Analysis agent takes the following input:
- url
- heatmap
Tools
The Heatmap Analysis agent uses the following tools internally to process your request:
- take_webpage_screenshot
- get_file_metadata
- read_file_content
- retrieve_file_from_gcs_uri
Default configuration
The agent uses the following default configuration:
- Inference level – Balanced, which provides reliable answers with additional reasoning.
- Files – None.
- Output – Text.
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.