---
title: Manage specialized agents
slug: agent-platform/docs/manage-specialized-agents
docTags: 
createdAt: 2026-08-12T15:37:10.000Z
---

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

In Agent Platform, [Mark Administrators](docId\:pe0pbUJveWrG8ewvZWDRE) and [Agent Builders](docId\:HOJ_6dibwNf8Qz7WMIDie) 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](https://home.optimizely.com).
2. Select your organization.
3. Click **Opal**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6jLEWe63JyOlsWmw0H0Ag_optimizely-world-organization-home-product-selector-opal-tile.png" size="100" width="2190" height="1378" isUploading="false" darkWidth="2190" darkHeight="1378" showCaption="false" indent="1"}

4. Click **Agents**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yOfCKLgJlc4xmxsytTvUL_opal-agents-nav-item-in-sidebar.png" size="100" width="2120" height="1250" isUploading="false" darkWidth="2120" darkHeight="1250" showCaption="false" indent="1"}

5. Select the **Your Agents** tab.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Mckv-up3ITywFTXbsCzUQ_agents-your-agents-tab-list-view.png" size="100" width="2172" height="1204" isUploading="false" darkWidth="2172" darkHeight="1204" showCaption="false" indent="1"}

### 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.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0mfgfaOKU5zS4dwxhDRey_find-agent.png)

- **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](docId\:tZPJWDyE1GSB-epLsUh5S).

## Use a specialized agent

You can use specialized agents in the following ways:

- [Mark chat](docId\:cFB_b7jzgV6k0Ry_cVXSS) – Invoke a specialized agent by calling its `@Id` in Mark chat.
- [Workflow agent](docId\:KWaI2TBwD38sN7p74exoy) – Run the agent as part of a workflow.

## Edit a specialized agent

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)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](docId\:Mn4hsPtFZEpNFsJuNfO33) documentation for information.
5. Click **Update**.

### Ask Mark to edit a specialized agent

:::hint{type="success"}
**Beta**

Asking Mark to edit a specialized agent is in beta.
:::

If you need help editing your agent, ask Mark to make the changes for you. To do so, complete the following steps:

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)section.
2. Click the agent name or click **More (...) > Edit Agent**.
3. Click **Ask Mark**.
4. Enter a prompt requesting your changes. For example, enter *Update the agent's prompt template to review the article against the style guide before assigning it.*
5. Review the changes and update any fields.
6. Click **Save changes** to make the updates.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/bjS_6IRTPM653AeSP4KuE_ask-opal-to-edit-specialized-agent.png" size="100" isUploading="false" width="1156" height="1926" darkWidth="1156" darkHeight="1926" showCaption="false" indent="1"}

See [Use Mark to create or edit a specialized agent automatically](docId\:jRodvjyE-5jiJfwac6Qai) for details.

## Delete a specialized agent

:::hint{type="danger"}
**Warning**

Deleting an agent is permanent and cannot be undone.
:::

### Delete from the Agents page

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)section.
2. Click **More (...)** on the agent you want to delete.
3. Click **Delete Agent**.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FT20ZTK1JNC3r1bSgq284_delete-specialized-agent-from-agents-page.png)
4. Click **Delete** on the **Delete Agent** confirmation page.

### Delete from the agent details

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)section.
2. Click the agent name or click **More (...) > Edit Agent**.
3. Click **More (...)**.
4. Click **Delete Agent**.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BvpfsGO9McbaQ7W3wAG8u_delete-specialized-agent-from-agent-details.png)
5. Click **Delete** on the **Delete Agent** confirmation page.

### Delete multiple agents

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)section.
2. Select the checkbox for each agent you want to delete.
3. Click **Delete**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6YFpaKRVVPXOeziU5sxYN_delete-multiple-specialized-agents.png" size="100" isUploading="false" width="2232" height="1144" darkWidth="2232" darkHeight="1144" showCaption="false" indent="1"}

4. 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.

## Deactivate a specialized agent

1. Follow the steps in the [Access your agents ](docId\:SSeNiblVMXwVvDR_lhtvI)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 ](docId\:cFB_b7jzgV6k0Ry_cVXSS)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 Agent Platform 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.

:::hint{type="info"}
**Note**

When you export agents, any [files](docId\:tZPJWDyE1GSB-epLsUh5S) previously added to the specialized agent are not exported. Instead, the JSON includes a link to the file stored in the current instance of Agent Platform. Re-upload your files to the new agent.
:::

After downloading or copying a specialized agent as JSON, [create a new agent from the JSON](docId\:m7s90A4_qd1GsR7DnU9dw).

### From the Agents page

1. Follow the steps in the [Access your agents ](docId\:cFB_b7jzgV6k0Ry_cVXSS)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 ](docId\:cFB_b7jzgV6k0Ry_cVXSS)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.

:::hint{type="info"}
**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](docId\:X5U0kKD2azV5cIdNqwGNj).
:::