---
title: Test a specialized agent
slug: agent-platform/docs/test-a-specialized-agent
docTags: 
createdAt: 2026-08-12T15:37:06.000Z
---

Test your specialized agent in Optimizely Agent Platform before deploying it or after editing it. Testing lets you verify that your agent responds correctly and catches configuration issues before users encounter them.

Tests run inside the agent editor. Single-shot agents run once and return a result. Multi-turn agents let you give follow-up instructions after the agent responds.

## 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"}

## Test your specialized agent

Follow these steps to run a **Test Run** on your specialized agent:

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

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/TkI4Gep4haHblIwfkEbUo_specialized-agent-setup-test-run-button-highlighted-on-content-translation-agent.png" size="100" isUploading="false" width="870" height="588" darkWidth="870" darkHeight="588" showCaption="false" indent="1"}

4. (Optional) Enter values for your agent's input variables (placeholders defined in the agent prompt that are filled in at runtime). To remove all values, click **Clear All**.
5. (Optional) Turn on **Run this agent as private execution** so only you can see the run's contents. This option does not display if the agent already has **Private executions** enabled, because every run is private.
6. Click **Run**.

The agent runs and displays the **Execution Results**. Click **Stop Execution** to end the **Test Run**.

## Test a multi-turn specialized agent

When you test a multi-turn specialized agent, the test run stays active after each response. This lets you continue the conversation across multiple turns.

1. Follow the steps in the [Access your agents](docId\:Mn4hsPtFZEpNFsJuNfO33) section.
2. Click the agent name or click **More actions (...) > Edit Agent**.
3. Click **Test Run**.
4. (Optional) Enter values for any input variables, then click **Run**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0Pbt8PDIAYUYowtpB-JwQ_test-run-multi-turn-campaign-brief-generator-run-button-in-test-run-panel.png" size="50" isUploading="false" width="742" height="878" darkWidth="742" darkHeight="878" showCaption="false" indent="1"}

5. Wait for the agent to complete Turn 1. An **Agent response complete** notification displays when the agent is ready for your reply.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/1IuxRkGwhVEqWNwQhhBYa_test-run-multi-turn-campaign-brief-generator-multi-turn-chat-execution-results.png" size="50" isUploading="false" width="752" height="1226" darkWidth="752" darkHeight="1226" showCaption="false" indent="1"}

6. Type your reply in the **Type your message** field and click **Send** to continue the conversation.

:::hint{type="info" indent="1"}
**Note**
Input variable values lock when the conversation starts. Click **Reset to edit** to change them and restart the test run.
:::

7. Continue replying across as many turns as needed. The **Output** section updates to show **Execution Results (Turn X)** after each turn. **Execution Memory** grows to reflect the full conversation history.
8. Click **Done** to end the test run.

## Execution results

The **Execution Results** include the following information:

- **Output** – The agent's execution results for the current turn.
  - **Execution ID** – The unique identifier of the request.
  - **Status** – Whether the run was successful.
  - **Agent's response** – The agent's text response for the current turn. For single-shot agents, this is the final result returned to Mark chat or a [workflow agent](docId:2HD0fUsIsfdek516VtN9l). For multi-turn agents, the label displays as **Execution Results (Turn X)** and updates with each turn.
- **Execution Memory** – Memory shows each step that Agent Platform takes while executing the agent. Use this information to debug your agent and confirm that the outputs and steps are correct.
  - The first message shows the initial request, including the prompt template and variable values.
  - The last message is the final output returned to you.
  - Other messages in between are steps Agent Platform takes to form its response, including tool calls in JSON format.
  - For multi-turn agents, memory grows with each turn and includes both **User** and **Assistant** chunks for the full conversation history.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Pgdcd0rQ9WDLakstNYyWn_test-run-documentationstyleguidereviewer-execution-results-and-memory-chunks-panel.png" size="70" isUploading="false" width="788" height="4486" darkWidth="788" darkHeight="4486" showCaption="false"}

The execution details also display in the [specialized agent's logs](docId\:nt3nlnNvyD_-F82soWgev).

:::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).
:::