Variation Creation agent

  • Updated

Variation Creation is an Optimizely Opal 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 setup.

Prerequisites 

To use the Variation Creation agent, ensure the following:

  • You must have access to Optimizely Web Experimentation.
  • Your Web Experimentation project's snippet must be added on the page to view the changes in preview. If the snippet is not already implemented on the page, you can use the Optimizely Web Companion Chrome extension to inject it. See Optimizely Web Companion.
  • You must add the following IP addresses to your allowlist:
    • 35.222.134.123
    • 34.171.204.197

Install agent

Opal administrators, agent builders, and Opal users with the Add, edit, and install specialized agents  attribute for a custom role can add agents to their organization's Optimizely Opal instance. See Add users and set permissions.

Install the agent from the Opal Agent Directory.

  1. Go to Agents > Agent Directory.
  2. Select Variation Creation.

  3. Click Install Agent to add it to your Opal instance.

Use the agent

In Opal 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 new variations to it.

The agent opens a visual editor session for each variation, applies the changes, 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, which provides maximum reasoning depth.
  • Files – None.
  • Output – Text.

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.