Export and import an agent as a file
Back up an agent's settings as a JSON file and transfer them to another agent. What the file contains and what happens on import.
Ask AI
You can download an agent’s settings as a file and upload them into another agent. This helps if you want to use a well set-up agent as a template for another location, or back up a state before larger changes.
The file is a JSON file. You don’t need to edit it. If you know JSON, you can also change texts in it directly.
Before you start
Section titled “Before you start”- You need the Company Admin role. With the User role you don’t see the Agents area.
- For the import you need an existing agent to load the file into. The import doesn’t create a new agent. We set up new agents and phone numbers for you; write to [email protected].
What the file contains
Section titled “What the file contains”| In the file | Not in the file |
|---|---|
| From the Personality tab: name, internal note, role, task, persona, Default greeting, Scheduled greetings, organization, organization description, additional instructions and the Voice | Phone number |
| Whether the agent is active | From the Availability tab: timezone, Activity schedule, behavior outside activity hours and the notification settings |
| All actions of type Forwarding, FAQ and Information capture, with their schedules and the email recipients of the information capture | Actions of type Appointment booking |
| Silence detection, greeting speed and the settings for several languages |
The file contains phone numbers from your forwardings and email addresses of your recipients. Only share it with people who are allowed to see this data.
Export an agent
Section titled “Export an agent”- Open Agents and select the agent at the top.
- To the right of the tabs, click the download icon (Download agent).
Your browser downloads a file with a name like qutee-ai_agent_Reception_2026-11-11_14-30-00.json. The app shows, for example, Agent “Reception” downloaded successfully.
Import an agent
Section titled “Import an agent”Before anything changes, the import shows you what it would change on the agent. You decide for each change whether it is applied.
- Open Agents and select the agent you want to load the file into at the top.
- To the right of the tabs, click the upload icon (Upload agent).
- Choose the JSON file.
- The Review import window lists every change with Before and New. Everything is ticked. Untick anything you do not want to apply.
- Click Apply changes (the button names the number, for example Apply 3 changes).
The app shows Agent uploaded successfully. Data will be refreshed. and reloads the page. If the file already matches the agent, the app shows “The file matches the current agent. There is nothing to change.” and nothing happens.
What happens on import
Section titled “What happens on import”- The fields from the Personality tab get the values from the file, as far as you leave them ticked.
- Whether the agent is active can also come from the file. If it is in the list, check the Agent active switch in the Availability tab after the import.
- Forwardings, FAQs and information captures are matched by their name: an action with the same name is updated, new ones are added. Actions of these three kinds that are not in the file are listed as Removed and are ticked. Untick them if they should stay.
- The phone number, the other settings in the Availability tab, Appointment booking actions and the selected email templates stay as they are.
- If the file names a voice that isn’t unlocked for your company, the import proposes the default voice. Check the Voice after the import.
If the import is rejected
Section titled “If the import is rejected”If the file doesn’t meet the agent editor’s rules, the app shows the Import not possible window with the file name and a list of the entries that don’t fit. For each entry it shows where it is, what is wrong and the path in the JSON file. Nothing was changed on the agent in that case.
Common reasons:
- The file is not valid JSON.: The file was damaged while editing, for example a comma or a bracket is missing. Export the agent again or check the position shown.
- Too long: A text exceeds the allowed length. The message tells you by how many characters to shorten it.
- Not a valid phone number: Numbers from Germany, Austria or Switzerland in the format +491711234567 are allowed.
- This file version is not supported.: The file doesn’t come from the export or is outdated. Export the agent again.
Correct the file, close the window with Close and upload it again.
Check that it works
Section titled “Check that it works”- Go through the Personality and Action tabs and check whether texts and actions are right.
- In the Availability tab, check the Agent active switch.
- Call the agent’s number and make a short test call.
Next steps
Section titled “Next steps”Was this page helpful?
Thanks for your feedback!