Export and import

An agent can be saved as an agent file, a .json file that holds the whole canvas: every node, every setting and every connection. Keys are never included.

Export

Open the Agents list from the toolbar, hover an agent’s row and click the download icon (Export as an agent file). The agent on the canvas can also be exported from the Agent menu (the chevron next to its name) with Export agent file. Your browser downloads a .json file named after the agent. Use it to:

Keep a backup before a big change.
Move an agent to another workspace.
Send the agent to support when something is wrong. See Troubleshooting.

Import

On the empty canvas, click Import an agent file under the prompt box (start one with + New in the Agents list, or the logo in the toolbar). Or, with any agent open, choose Import an agent file from the Agent menu.
Choose the file. The agent appears on the canvas as a new agent.

Importing never overwrites an existing agent. Rename the imported one from the toolbar if you keep both.

What the file looks like

{
  "version": "2",
  "name": "Clinic receptionist",
  "exportedAt": "2026-10-09T12:00:00.000Z",
  "nodes": [
    { "id": "persona-1", "nodeType": "persona", "agentName": "Luna", "language": "en", "position": { "x": 0, "y": 0 } },
    { "id": "agent-1", "nodeType": "agent", "skillName": "Intake", "command": "Ask for the caller's name and reason for calling.", "position": { "x": 320, "y": 0 } },
    { "id": "end-1", "nodeType": "end", "command": "Thanks for calling. Goodbye.", "position": { "x": 640, "y": 0 } }
  ],
  "edges": [
    { "source": "persona-1", "sourceHandle": "output", "target": "agent-1", "targetHandle": "persona_in" },
    { "source": "agent-1", "sourceHandle": "output", "target": "end-1", "targetHandle": "in" }
  ]
}

Node types and handle names match the Node reference. A file that is not an agent file at all is rejected with That is not an agent file. A file without both nodes and connections is rejected with That file does not contain an agent. A file that uses node types no longer in the catalog is rejected with Could not read that agent file. A file with no Persona, more than one Persona, or no Skill is rejected with That agent file is incomplete and the reason. Nothing is saved in any of these cases.

What is not in the file

Provider keys.
Version history and conversation history.
Publish history and share links.

Getting started

Building your agent

Build with AI

Testing

Tools

After the call

Publishing

Self-hosting

Export

Import

What the file looks like

What is not in the file

​Export

​Import

​What the file looks like

​What is not in the file

Export

Import

What the file looks like

What is not in the file