You can import all of the assets in an export file or select the assets that you want to import.
When you import assets, you specify the following information:
•The assets in the export file that you want to import and the projects in which to import them.
•Whether to overwrite assets in the target project with assets in the export file when there is a name conflict.
•Whether to merge tags when you overwrite assets in the target project.
•The runtime environments to use for the imported assets.
The target organization must have all the required licenses for the assets being imported.
The Import Assets page lists the assets that are in the export file. You can select which assets you want to import, and then specify which project to import the assets to. You can accept the default project, which is the same project name as the source project, or you can select a different project. If the project doesn't exist in the target organization, AI Agent Engineering creates it.
Asset name conflicts
You can specify how AI Agent Engineering handles asset name conflicts when the export file contains assets with the same name as assets in the target project. You can choose whether to overwrite the assets in the target project or use the existing assets in the target project.
To see how the import handles any asset name conflicts before you start the import job, you can test the import on the Import Assets page before you import the assets. The import action displays in the Status column for each asset. You can filter the list of assets by asset name, asset type, or status.
If the target organization has runtime environments with the same name as those in the export file, AI Agent Engineering uses the runtime environments that exist in the target organization. AI Agent Engineering does not overwrite the runtime environments in the target organization.
Runtime environment selection
If the export file contains dependent objects, the target runtime environments field shows the runtime environments from the export file as the default. You can accept the default or select a different runtime environment.
If the export file doesn't include dependent objects and the runtime environments that are used by the assets in the export file don't exist in the target organization, you must select a target runtime environment.
If a suitable runtime environment doesn't exist in the target organization, create it in the target organization before you import the file.
The following image shows the source runtime environment and the selected target runtime environment:
Asset tags
Asset tags are included in the export file and imported with the asset to the target project. When you overwrite existing assets, you can choose to merge tags in the target project with tags in the export file or keep only the tags in the export file.
When you import a new asset, its tags are also imported to the target project. When you overwrite existing assets in the target project, you can choose to merge tags. When you merge tags, after import, both export and target project tags are assigned to the asset.
You can choose to merge tags for all assets or for some assets in the export file. You can only merge tags when you overwrite existing assets in the target project.
If you choose to merge tags and the asset in the export file does not have tags but the asset in the target project does, after import, the asset will retain tags from the target project. To remove the target project tags, navigate to the asset on the Explore page and remove the tags.
The following table shows how AI Agent Engineering merges tags when you overwrite existing assets on import:
Asset name
Export file tags
Target project tags
Merge tags
Tags after import
Asset_1
Tag_1, Tag_2
Tag_3
Yes
Tag_1, Tag_2, Tag_3
Asset_2
Tag_1, Tag_2
Tag_4, Tag_5
No
Tag_1, Tag_2
Asset_3
Tag_1, Tag_2
-
Yes
Tag_1, Tag_2
Asset_4
-
Tag_5, Tag_6
Yes
Tag_5, Tag_6
Asset_5
-
Tag_5, Tag_6
No
Tag_5, Tag_6
Importing assets
Import assets from an AI Agent Engineering export file.
1Log in to the target organization.
2On the Explore page, navigate to All Projects and click Import.
3On the Import Assets page, navigate to the export file and click Open, or drag the zip file from the Downloads folder in Windows.
The Import Assets page lists the assets in the file.
4Optionally, change the import job name.
5Choose whether to overwrite existing assets with the assets in the import.
- If you choose to overwrite existing assets, when an asset has the same name as an asset in the target project, the asset replaces the existing asset in the target project.
- If you do not choose this option, if an asset with the same name exists in the target project, the asset is not imported.
6Select the assets to import.
If the export file contains a project and you want to import the entire project, select all of the assets. AI Agent Engineering creates the project in the target organization.
7Select the target project or accept the default.
8For each source runtime environment, select the target runtime environment or accept the default.
9Click Test to see the potential results of the import.
In the Select Assets area, the status for each asset shows the action that the service performs when you import the files.
10If necessary, revise your selections to resolve any issues in the test results.
11Click Import.
You can see the progress of the import on the Import tab of the My Import/Export Logs page. When the import process is complete, a message appears in Notifications. Click the link in the message to open the log details page and see the results of the import.
