Manage specialized agents

Agents in Optimizely Opal are purpose-built AI agents that complete specific, well-defined tasks.

In Opal, Opal Administrators and Agent Builders can create, customize, and manage agents using prompts, input variables, and tools to automate tasks accurately and efficiently.

Access your agents

1. Go to home.optimizely.com.
2. Select your organization.

3. Click Opal.

   

4. Click Agents.

   

5. Click the Your Agents tab.

   

Find your agent

The Your Agents tab lists every agent in your workspace. Use the search field and filters to narrow the list when you have many agents.

The search field and filters apply in combination. For example, search for experiment and set Type to Specialized. The list shows only workflow agents whose name or description contains experiment.

• Search – Enter text to match against the Name and Description columns. The list updates as you type.
• Type – Filter by agent type. Choose All, Specialized, or Workflow.
• Status – Filter by agent status. Choose All, Active, or Inactive.
• Created by – Filter by who created the agent. Defaults to All Users. Select one or more users to display only agents they created. Click Clear to reset to the default.
• Modified by – Filter by who last modified the agent. Defaults to All Users. Select one or more users to display only agents they last modified. Click Clear to reset to the default.

Create a specialized agent

See Create specialized agents.

Use a specialized agent

You can use specialized agents in the following ways:

• Opal Chat – Invoke a specialized agent by calling its @Id in Opal Chat.
• Workflow agent – Run the agent as part of a workflow.

Edit a specialized agent

1. Follow the steps in the Access your agents section.
2. Click the agent name or click More (...) > Edit Agent.
3. Make changes to the agent's configuration, such as its prompt, variables, or tools.
4. (Optional) Click Test Run to verify your changes. See the Test a specialized agent documentation for information.
5. Click Update.

Delete a specialized agent

Delete from the Agents page

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

3. Click Delete Agent.

   

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 (...).
4. Click Delete Agent.
5. Click Delete on the Delete Agent confirmation page.

Deactivate a specialized 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 agent from being triggered without deleting it.
4. Click Update.

Duplicate a specialized agent

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

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. 

Download or copy a specialized agent as JSON

Download or copy a specialized agent as JSON to back up its configuration or transfer it to another Opal instance. Downloading exports the agent as a .json file you can save locally or share with another team. Copying places the JSON directly in your clipboard for quick use.

After downloading or copying a specialized agent as JSON, create a new agent from the JSON.

From the Agents page

1. Follow the steps in the Access your agents section.
2. Click More (...) for the agent you want to export as JSON.

3. Click Download Agent.

   

The Download Agent page displays.

1. (Optional) Toggle Include output evaluation examples on.
2. Click Copy as JSON to copy the agent to your clipboard.
3. Click Download to download the agent to your computer.

From the agent details page

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

4. Click Download Agent.

   

The Download Agent page displays.

1. (Optional) Toggle Include output evaluation examples on.
2. Click Copy as JSON to copy the agent to your clipboard.
3. Click Download to download the agent to your computer.