---
title: Create a specialized agent from JSON
slug: agent-platform/docs/create-a-specialized-agent-from-json
docTags: 
createdAt: 2026-08-12T15:37:09.000Z
---

Use JSON to configure the same specialized agent across multiple Agent Platform instances, or to share agent configurations with other teams. If you are working within a single instance, copy the specialized agent instead. See [Manage specialized agents](docId\:cFB_b7jzgV6k0Ry_cVXSS).

## Download a specialized agent as JSON

Before importing, you must export the agent from an existing Mark instance. See [Download or copy a specialized agent as JSON](docId\:cFB_b7jzgV6k0Ry_cVXSS) in Manage specialized agents.

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

When you export a specialized agent, files added to the agent are not exported. The JSON includes a link to the file stored in the originating Mark instance. Ensure users in the target instance have access to that file, or upload the file again after importing.
:::

## Upload a specialized agent from JSON

1. Go to [home.optimizely.com](https://home.optimizely.com).
2. Select your organization.
3. Click **Mark**, then click **Agents**.
4. Click **Add Agent** and select **Upload Agent**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/p4NUwDSrcb5ptmsYPXssB_upload-agent-json.png" size="100" isUploading="false" position="center" width="1994" height="694" darkWidth="1994" darkHeight="694" showCaption="false" indent="1"}

5. Paste the JSON or upload the `.json` file.
6. (Optional) Toggle **Overwrite existing agents** on to replace an agent with the same Id in this instance.
7. Click **Import Agent**.

The specialized agent is added to your **Your Agents** list.

## Next steps

- See [Create a specialized agent](docId\:tZPJWDyE1GSB-epLsUh5S) to edit or extend the imported agent.
- See [Manage specialized agents](docId\:cFB_b7jzgV6k0Ry_cVXSS) for information on editing, copying, and deleting agents.

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