Manage workflow agents

  • Updated

Optimizely Opal workflow agents let you automate and optimize complex business processes by orchestrating triggers, logic, and agents. Workflow agents streamline multi-step tasks, support autonomous agent behavior, and enable advanced logic such as looping and branching. Workflow agents scale with your organizational needs and adapt to evolving processes.

Access your agents

  1. Go to home.optimizely.com.
  2. Select your organization.
  3. Click Opal.

    Screenshot of the Optimizely home page showing the Opal option in the navigation
  4. Click Agents.

    Screenshot of the Agents page in Opal where the list of agents is displayed
  5. Click the Your Agents tab.

    Screenshot of the Agents page in Opal where the Your Agents tab is selected

Create a workflow agent

See Create a workflow agent.

Use a workflow agent

Workflow agents are started by their trigger. See Workflow agent triggers.

Edit a workflow agent

  1. Follow the steps in the Access your agents section.
  2. Click the agent name or click More (...) > Edit Agent.

    Screenshot of the Your Agents tab with the Edit Agent highlighted.
  3. Make changes to the workflow agent's configuration in the Workflow Setup.
  4. Click Apply.

Switch between the workflow builder and setup

You can toggle the Workflow Setup panel open or closed.

To close the Workflow Setup panel, click Close or More (...) > Setup.

Screenshot of Close in the Workflow Setup panel.

To open the Workflow Setup panel to update the workflow agent's Name, Id, or Description, click More (...) > Setup.

Screenshot of a workflow with the more options menu expanded and Setup highlighted.

Delete a workflow agent

Deleting an agent is permanent and cannot be undone.

Delete from the Agents page

  1. Follow the steps in the Access your agents section.
  2. Click More (...) on the workflow agent you want to delete.
  3. Select Delete Agent.

    Screenshot of the Agents page with the More options menu expanded and Delete Agent highlighted.
  4. Click Delete on the Delete Agent confirmation page.

Delete from the agent details

  1. Follow the steps in the Access your agents section.
  2. Click the agent name or click More (...) > Edit Agent.
  3. Click More (...) > Delete Agent.

    Screenshot of a workflow agent with the more options expanded and Delete Agent highlighted.
  4. Click Delete on the Delete Agent confirmation page.

Delete multiple agents

Delete several agents in one action to keep your agent list organized. The Agents page lists your specialized agents and workflow agents. Use the Type drop-down list and select Workflow to only delete workflow agents. Deleting agents is permanent and cannot be undone.

  1. Follow the steps in the Access your agents section.
  2. (Optional) Select Workflow from the Type drop-down list to only display workflow agents.
  3. Select the checkbox for each agent you want to delete.
  4. Click Delete.

    Screenshot of the Your Agents tab with two agents selected and Delete highlighted.
  5. Click Delete on the confirmation page.

To select every agent on the page, select the checkbox in the table header. Delete displays the number of agents you selected.

Cancel multiple executions

If a workflow agent triggers many executions at once, cancel them in bulk instead of stopping each one individually. This is useful for runaway triggers or unexpected loops.

Opal cancels only Running or Pending executions. When you cancel, any step in progress finishes and no new steps start.

To cancel multiple workflow agent executions at once, use the Agent Activity Logs tab. See Cancel multiple executions for details.

Deactivate a workflow agent

  1. Follow the steps in the Access your agents section.
  2. Click the agent name or click More (...) > Edit Agent.
  3. Toggle Active to off to prevent the workflow agent from being triggered without deleting it.

    Screenshot of a workflow agent with the Active toggle highlighted.
  4. Click Apply.

Duplicate a workflow agent

If you do not want to start from scratch, you can create a copy of a workflow agent by duplicating it.

Duplicate from the Agents page

  1. Follow the steps in the Access your agents section.
  2. Click More (...) on the workflow agent you want to duplicate.
  3. Select Duplicate Agent.

    Screenshot of the Your Agents tab with duplicate agent highlighted.
  4. Update the agent, including the Id, to make it unique.
  5. Click Save to create the new workflow agent.

Duplicate from the agent details

  1. Follow the steps in the Access your agents section.
  2. Click the agent name or click More (...) > Edit Agent.
  3. Click More (...) > Duplicate Agent.
  4. Update the agent, including the Id, to make it unique.
  5. Click Save to create the new workflow agent.

Download or copy a workflow agent as JSON

After copying a workflow agent as JSON, you can create an agent from the JSON. See Import a workflow agent from JSON.

Download or copy from the Agents page

  1. Follow the steps in the Access your agents section.
  2. Select More (...) for the workflow agent you want to download.
  3. Click Download Agent.

    Screenshot of the your agents tabs wit Download Agent highlighted
  4. Review the information on the Download Agent page.
  5. (Optional) Toggle Include output evaluation examples on if you want to include them.
  6. Click Copy as JSON to copy the agent to your clipboard.
  7. Click Download to download the agent to your computer.

Download or copy from the agent details

  1. Follow the steps in the Access your agents section.
  2. Click the agent name or click More (...) > Edit Agent.
  3. Select More (...).
  4. Click Download Agent.
  5. Review the information on the Download Agent page.
  6. (Optional) Toggle Include output evaluation examples on if you want to include them.
  7. Click Copy as JSON to copy the agent to your clipboard.
  8. Click Download to download the agent to your computer.

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.