Importer/exporter des paquets de ML

Vous pouvez exporter et importer des paquets ML depuis/vers UiPath AI Center à l'aide de scripts. Cela vous permet d'effectuer les opérations suivantes :

• Sauvegardez vos paquets ML.
• Déplacez les paquets ML d'un locataire à un autre.
• Déplacez les paquets ML d'un AI Center à un autre.

Les deux scripts peuvent être trouvés sur ce lien : Scripts.

Prérequis

Vous pouvez exécuter ces scripts à partir de n'importe quelle machine ayant accès à AI Center et à Identity Server (inclus dans Orchestrator la plupart du temps). Cependant, vous devez avoir installé les éléments suivants sur la machine :

• jq
• cURL

Exportation de paquets ML

Utilisez le fichier de script export.sh pour exporter un paquet ML. Ce script téléchargera le paquet ML à partir de l'environnement cible (fichier zip) et l'enregistrera localement dans le dossier timestamp. Il téléchargera également un fichier metadata.json pour ce paquet ML.

Avant d'exécuter le script, vous devez créer un fichier json avec les clés/valeurs suivantes :

• hostOrFQDN : point de terminaison public à partir duquel le service de backend peut être accédé avec le numéro de port.
• identityServerEndPoint : point de terminaison où le serveur d'identité est hébergé (souvent Orchestrator).
• hostTenantName : nom du locataire hôte enregistré dans le serveur d'identité.
• hostTenantIdOrEmailId : l'ID ou l'ID d'e-mail du locataire hôte.
• hostTenantPassword : le mot de passe du locataire hôte.
• tenantName : le nom du locataire à partir duquel l'exportation du paquet ML sera effectuée.
• projectName : le nom du projet à partir duquel le paquet ML sera exporté.
• mlPackageName : le nom du paquet ML qui sera téléchargé à partir de l'environnement cible.
• mlPackageVersion : le numéro de version du paquet ML qui sera téléchargé. Le numéro de version doit avoir le format suivant : 3.2, 3.1.

Par exemple, votre fichier ressemblera à ceci :

{
    "hostOrFQDN":  "myinternalAIC.com:31390",
    "identityServerEndPoint": "internal-orchestrator.com",
    "hostTenantName": "host",
    "hostTenantIdOrEmailId": "admin",
    "hostTenantPassword": "P@sswOrd123",
    "tenantName":  "DevTenant",
    "projectName": "InvoicesProject",
    "mlPackageName": "InvoicesFinal",
    "mlPackageVersion": "8.3"
}

Ensuite, exécutez simplement la commande suivante à partir de la ligne de commande :

./export.sh export_input.json

Elle va créer localement les deux fichiers :

• InvoicesFinal.zip : le paquet ML
• InvoicesFinal_v8.3_metadata.json : métadonnées du paquet ML

Importation de paquets ML

Utilisez le fichier de script import.sh pour importer un paquet ML. Ce script téléchargera un paquet ML local dans le projet AI Center cible.

Avant d'exécuter le script, vous devez fournir les informations suivantes :

• hostOrFQDN : point de terminaison public à partir duquel le service de backend peut être accédé avec le numéro de port.
• identityServerEndPoint : point de terminaison où le serveur d'identité est hébergé (souvent Orchestrator).
• hostTenantName : nom du locataire hôte enregistré dans le serveur d'identité.
• hostTenantIdOrEmailId : l'ID ou l'ID d'e-mail du locataire hôte.
• hostTenantPassword : le mot de passe du locataire hôte.
• tenantName : le nom du locataire vers lequel l'importation du paquet ML sera effectuée.
• projectName : le nom du projet à partir duquel le paquet ML sera exporté.
• mlPackageName : le nom du paquet de ML vers lequel une nouvelle version sera téléchargée, si elle existe. Sinon, un nouveau paquet ML portant le même nom sera créé.
• mlPackageMajorVersionForPrivatePackage : utilisé pour télécharger de nouvelles versions mineures (par exemple, 3.1). Ceci n'est utilisé que pour les packages privés. La valeur par défaut doit être zéro.
• mlPackageZipFilePath : le chemin d'accès au chemin du fichier zip du paquet ML avec son extension qui sera téléchargé dans l'environnement cible.
• mlPackageMetadataFilePath : le paquet ML importe le chemin du fichier des métadonnées JSON avec l'extension.

Par exemple, votre fichier ressemblera à ceci :

{
    "hostOrFQDN":  "myinternalAIC.com:31390",
    "identityServerEndPoint": "internal-orchestrator.com",
    "hostTenantName": "host",
    "hostTenantIdOrEmailId": "admin",
    "hostTenantPassword": "P@sswOrd123",
    "tenantName":  "ProdTenant",
    "projectName": "InvoicesProject",
    "mlPackageName": "InvoicesFinal",
    "mlPackageMajorVersionForPrivatePackage": 8,
    "mlPackageZipFilePath": "full/path/InvoicesFinal.zip",
    "mlPackageMetadataFilePath": "full/path/InvoicesFinal_v8.3_metadata.json"
}

Ensuite, exécutez simplement la commande suivante à partir de la ligne de commande :

./import.sh import_input.json

Cela téléchargera le paquet ML sur le locataire et le projet souhaités, la version sera la version majeure spécifiée dans votre fichier d'entrée et la prochaine version mineure disponible.

Dans l'exemple ci-dessus, si le paquet ML InvoicesFinal v8 existe déjà et que la dernière version mineure est 8.4, le paquet ML sera téléchargé avec la version 8.5. Si le paquet ML n'existe pas déjà sur ce projet, le paquet ML sera téléchargé avec la version 8.1.