Variation Creation agent
Variation Creation is an Optimizely Agent Platform agent that creates an experiment or personalization campaign and builds its variations.
- Challenge – Building experiment variations by hand requires manual work in the visual editor for every page change.
- Agent outcome – The agent creates the experiment or campaign, builds each variation, validates the changes, and returns a preview link.
- Value – Teams launch tests faster and spend less time on repetitive variation configuration.
Prerequisites
To use the Variation Creation agent, ensure the following:
- You must have access to Optimizely Web Experimentation.
- Add your Web Experimentation project's snippet to the page to view the changes in preview. If the snippet is not already implemented on the page, use the Optimizely Web Companion Chrome extension to inject it. See Optimizely Web CompanionOptimizely Web Companion.
- You must add the following Internet Protocol (IP) addresses to your allowlist:
- 35.222.134.123
- 34.171.204.197
Install agent
Note
Opal 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.
Install the agent from the Directory.
- Go to Directory > Agents.
- (Optional) Begin entering Variation Creation or use the drop-down list filters to narrow the list.
- Click Install on Variation Creation to add it to your Agent Platform instance.

If Install is disabled, connect the required Optimizely products to your Agent Platform instance first.
Use the agent
In Mark chat, enter @variation_creation and provide the following details:
- Project Name – The project name where the experiment or campaign exists or is built.
- URL – Page URL.
- Variation Count – Number of variations to build.
- Instruction – Instruction for the variations to build.
- (Optional) Name – Experiment or campaign name. When the name matches an existing experiment or campaign in the project, the agent adds the variations to it.
The agent opens a visual editor session for each variation and applies the changes. It saves them, validates the result, and returns a preview link for each variation.
To use the Variation Creation agent in a workflow agent, drag and drop it into your workflow. See Create a workflow agent.
Details
These are the default details for the Variation Creation agent. The Variation Creation agent is an Optimizely-managed agent and you cannot update it. See Optimizely-managed agents overview.
Input variables
The Variation Creation agent takes the following input:
- Project Name
- URL
- Variation Count
- Instruction
- (Optional) Name
Tools
The Variation Creation agent uses the following tools to process your request:
- exp_ve_element_glob
- exp_ve_element_grep
- exp_ve_element_read
- exp_ve_element_tree
- exp_ve_revert_change
- exp_ve_validate_change
- exp_execute_query
- exp_ask_ui_card
- exp_idea_next_steps
- exp_list_ui_cards
- exp_ve_dispatch
- exp_ve_get_dispatch_schema
- execute_specialized_agent
- edit_file
- ask_user_question
- exp_get_entity_templates
- exp_manage_entity_lifecycle
- exp_ve_open_session
- exp_get_schemas
- exp_ve_apply_change
- exp_ve_get_change_schema
- exp_ve_save_changes
- exp_ve_list_pending_changes
- exp_capture_screenshot
Additional details
The agent uses the following default configuration:
- Inference level – Pro. Provides maximum reasoning depth.
- 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.