---
id: video/3UcLmXqyl44
type: video
title: "What's New: Exporting and Importing Agent in Business Central"
summary: Exporting and importing agent definitions in Business Central as XML files, from the agent card or agent list. Covers the import wizard with preview, validation warnings, replace-or-create choice, and activation after import. Useful for backing up agents and sharing them across environments.
tier: official
language: en
tags:
  - agent export
  - agent import
  - agent definition
  - xml
  - agent backup
  - cross-environment sharing
  - agent activation
  - validation warnings
  - security
  - agent permissions
system: copilot
review:
  state: reviewed
  by: opus
  at: "2026-10-07T22:51:04.302Z"
  flags: []
generated:
  at: "2026-10-07T22:51:04.348Z"
  pipeline: 0.2.0
  prompts:
    extract-video: 1
    summarize-video: 2
  input_hash: 3d88e0b06ed28cca89713bf1ad22bf13d3bb86675741c7024c495b8bb0d5bdd4
evidence:
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=16s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 16
    quote: It is quite useful sometimes to back up your agents when you are working on them and you want to make sure that you
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=27s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 27
    quote: The other thing is that you might want to share them across environments and easily import them.
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=103s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 103
    quote: It will contain its name, its display name, the different permissions it's using and also the instructions that it is using.
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=119s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 119
    quote: The importing experience is designed to offer both security and convenience uh for viewing what changes will happen to existing agents.
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=242s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 242
    quote: a warning which says that the profile that it is being imported with was not found in the system
  - kind: video
    url: https://www.youtube.com/watch?v=3UcLmXqyl44&t=257s
    title: "What's New: Exporting and Importing Agent in Business Central"
    date: "2026-02-27T15:13:02.000Z"
    commit: null
    t: 257
    quote: want to replace existing agents or to add a new one in which case a new instance will be
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
video_id: 3UcLmXqyl44
channel: yt-microsoft
source_name: Microsoft Dynamics 365 Business Central (YouTube)
url: https://www.youtube.com/watch?v=3UcLmXqyl44
published_at: "2026-02-27T15:13:02.000Z"
duration_s: 331
captions: full
audience:
  - administrator
  - developer
  - functional consultant
chapters:
  - t: 0
    title: Why export agents and overview of export options
  - t: 47
    title: Exporting agents via the UI - live demonstration
  - t: 103
    title: Import process overview and security features
  - t: 155
    title: Importing agents - file selection and preview
  - t: 196
    title: Reviewing import details and validation warnings
  - t: 257
    title: Completing import and activating agents
  - t: 308
    title: Conclusion and resources
features:
  - name: Export agent definition
    status: unclear
    t: 47
    verified: false
    status_source: video
  - name: Agent XML format
    status: unclear
    t: 103
    verified: false
    status_source: video
  - name: Import agent definition
    status: unclear
    t: 119
    verified: false
    status_source: video
  - name: Agent import preview
    status: unclear
    t: 119
    verified: false
    status_source: video
  - name: Agent validation warnings
    status: unclear
    t: 196
    verified: false
    status_source: video
  - name: Agent replace or create option
    status: unclear
    t: 257
    verified: false
    status_source: video
  - name: Agent activation after import
    status: unclear
    t: 278
    verified: false
    status_source: video
  - name: Agent productization via API
    status: unclear
    t: 27
    verified: false
    status_source: video
objects_mentioned:
  - other agent list
  - other agent card
  - other inventory agent
  - other sales validation agent
quotes:
  - t: 16
    text: It is quite useful sometimes to back up your agents when you are working on them and you want to make sure that you
    check: exact
  - t: 27
    text: The other thing is that you might want to share them across environments and easily import them.
    check: exact
  - t: 103
    text: It will contain its name, its display name, the different permissions it's using and also the instructions that it is using.
    check: exact
  - t: 119
    text: The importing experience is designed to offer both security and convenience uh for viewing what changes will happen to existing agents.
    check: exact
  - t: 242
    text: a warning which says that the profile that it is being imported with was not found in the system
    check: fuzzy
  - t: 257
    text: want to replace existing agents or to add a new one in which case a new instance will be
    check: fuzzy
---

# What's New: Exporting and Importing Agent in Business Central

> Exporting and importing agent definitions in Business Central as XML files, from the agent card or agent list. Covers the import wizard with preview, validation warnings, replace-or-create choice, and activation after import. Useful for backing up agents and sharing them across environments.

[Watch on YouTube](https://www.youtube.com/watch?v=3UcLmXqyl44) · Microsoft Dynamics 365 Business Central (YouTube) · 2026-02-27 · 5:31 · tier official · reviewed (checked by Opus)

## Overview

The video shows how to export an agent definition as an XML file, either from the agent card using an export agent definition action or from the agent list. The file holds the agent's name, display name, permissions and instructions. Reasons given for exporting are backing up agents while working on them and sharing them across environments.

The import part walks through the import agent definition wizard: selecting a file, previewing the definitions and their effect on existing agents, reviewing validation warnings, choosing which agents to import, and deciding whether to replace existing agents or create new instances. After import, agents can be activated from the results view or reviewed on the agent card first. The video also mentions that agents can be productized through AL code via the API, using exported definitions as a reference.

## Key points

- Export an agent definition as an XML file from the agent card (Design > export agent definition) or export multiple agents from the agent list.
- The XML contains the agent's name, display name, permissions and instructions.
- Import runs through an import agent definition wizard (Design > import agent definition, then select XML file) that previews the agents and what will change for existing agents before anything is imported.
- You can view each agent's instructions in the preview and check a validation status column with warnings and errors, for example a profile that was not found in the system.
- An agent imported without a profile cannot navigate the UI, so this must be fixed manually after import.
- During import you choose to replace existing agents or create a new instance, and you can select only the agents you want.
- After import, a results view lists what was imported; clicking an agent's initials opens the agent card where you can activate it and review permissions, user access and other settings.

## Chapters

- [0:00](https://www.youtube.com/watch?v=3UcLmXqyl44&t=0s) Why export agents and overview of export options
- [0:47](https://www.youtube.com/watch?v=3UcLmXqyl44&t=47s) Exporting agents via the UI - live demonstration
- [1:43](https://www.youtube.com/watch?v=3UcLmXqyl44&t=103s) Import process overview and security features
- [2:35](https://www.youtube.com/watch?v=3UcLmXqyl44&t=155s) Importing agents - file selection and preview
- [3:16](https://www.youtube.com/watch?v=3UcLmXqyl44&t=196s) Reviewing import details and validation warnings
- [4:17](https://www.youtube.com/watch?v=3UcLmXqyl44&t=257s) Completing import and activating agents
- [5:08](https://www.youtube.com/watch?v=3UcLmXqyl44&t=308s) Conclusion and resources

## Features

| Feature | Status | At |
|---|---|---|
| Export agent definition | status not stated, demoed | [0:47](https://www.youtube.com/watch?v=3UcLmXqyl44&t=47s) |
| Agent XML format | status not stated | [1:43](https://www.youtube.com/watch?v=3UcLmXqyl44&t=103s) |
| Import agent definition | status not stated, demoed | [1:59](https://www.youtube.com/watch?v=3UcLmXqyl44&t=119s) |
| Agent import preview | status not stated, demoed | [1:59](https://www.youtube.com/watch?v=3UcLmXqyl44&t=119s) |
| Agent validation warnings | status not stated, demoed | [3:16](https://www.youtube.com/watch?v=3UcLmXqyl44&t=196s) |
| Agent replace or create option | status not stated, demoed | [4:17](https://www.youtube.com/watch?v=3UcLmXqyl44&t=257s) |
| Agent activation after import | status not stated, demoed | [4:38](https://www.youtube.com/watch?v=3UcLmXqyl44&t=278s) |
| Agent productization via API | status not stated | [0:27](https://www.youtube.com/watch?v=3UcLmXqyl44&t=27s) |

## AL objects mentioned

As heard in the captions. A name that matches one object page by exact type and name links to it; the others stay as named.

- other "agent list" at [1:10](https://www.youtube.com/watch?v=3UcLmXqyl44&t=70s)
- other "agent card" at [0:47](https://www.youtube.com/watch?v=3UcLmXqyl44&t=47s)
- other "inventory agent" at [1:10](https://www.youtube.com/watch?v=3UcLmXqyl44&t=70s)
- other "sales validation agent" at [3:16](https://www.youtube.com/watch?v=3UcLmXqyl44&t=196s)

## Quotes

- [0:16](https://www.youtube.com/watch?v=3UcLmXqyl44&t=16s) "It is quite useful sometimes to back up your agents when you are working on them and you want to make sure that you"
- [0:27](https://www.youtube.com/watch?v=3UcLmXqyl44&t=27s) "The other thing is that you might want to share them across environments and easily import them."
- [1:43](https://www.youtube.com/watch?v=3UcLmXqyl44&t=103s) "It will contain its name, its display name, the different permissions it's using and also the instructions that it is using."
- [1:59](https://www.youtube.com/watch?v=3UcLmXqyl44&t=119s) "The importing experience is designed to offer both security and convenience uh for viewing what changes will happen to existing agents."
- [4:02](https://www.youtube.com/watch?v=3UcLmXqyl44&t=242s) "a warning which says that the profile that it is being imported with was not found in the system"
- [4:17](https://www.youtube.com/watch?v=3UcLmXqyl44&t=257s) "want to replace existing agents or to add a new one in which case a new instance will be"