> For the complete documentation index, see [llms.txt](https://imbrace.gitbook.io/imbrace-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://imbrace.gitbook.io/imbrace-documentation/ai-agent/import-ai-agent.md).

# Import AI Agent

The **Import AI Agent** feature lets you bring an existing agent into IMBRACE from a .zip file. The file holds the agent's definition, so you don't need to rebuild it from scratch. This is useful for moving an agent between workspaces, restoring a backup, or using an agent shared by a teammate.

#### Before you start

Make sure you have the agent's .zip file saved on your device. It must be the original export file containing the agent definition. Other file types, or a .zip that has been changed or re-compressed, may not import correctly.

#### How to import an AI agent

1. Go to **Actions** and from the drop-down menu, select **Agent IQ.** 
2. Click on + button on the main Ai Agent screen and select **Import AI Agent.**  
3. **Import AI Agent** window opens.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FUZPhXemAk5gUfVMLdgao%2FScreenshot%202026-09-30%20163632.png?alt=media&amp;token=dfab2312-41b3-43e8-91ab-019a94128f87" alt=""><figcaption></figcaption></figure>

4. Under **Select a .zip file**, click on **Upload File**.
5. Find the agent's .zip file on your device, select it, and confirm.
6. Click **UPLOAD**.  Wait for the import to finish. The agent then appears in **\[agent list location]**.