Skip to main content

Export an agent

Updated this week

Export packages your agent's Flows, Knowledge Base (AKB), and Customer Attributes into a single .zip file. Use it to back up an agent before making large changes, copy a configured agent to another account or project, or share an agent template with a partner.

Export an agent

  1. Open the Builder and go to Settings.

  2. Click Export.

  3. Optionally expand Advanced settings and adjust the options (see Advanced settings below).

  4. Click Export.

The file downloads automatically. The filename follows this pattern:

organization-{timestamp}.zip

Advanced settings

Expand Advanced settings to control what is included in the export. Both options are enabled by default.

Setting

Default

What it does

Export AKB files

On

Includes akb.json in the archive. Uncheck to exclude Knowledge Base data.

Export Customer Attributes

On

Includes attributes.json in the archive. Uncheck to exclude Customer Attribute definitions.

Uncheck either option if you only want to export the agent's Flows β€” for example, when sharing a Flow template with a partner who will supply their own knowledge base.

What's inside the ZIP

The exported archive contains the following files:

File

Contents

flows/flows.json

Agent Personas and their Flow configurations.

flows/{FlowIdn}.{SkillIdn}.nsl

Skill prompt scripts for each Flow. One file per Flow skill.

akb.json

AKB / Knowledge Base entries (included unless Export AKB files is unchecked).

attributes.json

Customer Attribute definitions in YAML format (included unless Export Customer Attributes is unchecked).

When to export

  • Before risky changes β€” Export before making large edits to Flows or the Knowledge Base so you have a restore point.

  • Copy an agent to another account or project β€” Export from the source agent, then import into the target. See Import an agent for the matching workflow.

  • Share an agent template with a partner β€” Export the Flows (optionally without AKB or Attributes) and send the archive to a partner who can import it into their own account.

Did this answer your question?