Importação/exportação de pacotes de ML

É possível exportar e importar pacotes de ML de/para o UiPath AI Center usando scripts. Isso lhe permite fazer o seguinte:

• Fazer backup de seus pacotes de ML.
• Mover pacotes de ML de um tenant para outro.
• Mova pacotes de ML de um AI Center para outro.

Os dois scripts podem ser encontrados neste link: Scripts.

Pré-requisitos

É possível executar esses scripts de qualquer máquina tendo acesso ao AI Center e ao Identity Server (incluídos no Orchestrator a maior parte do tempo). No entanto, é necessário ter o seguinte instalado na máquina:

• jq
• cURL

Exportação de pacotes de ML

Use o arquivo de script export.sh para exportar um pacote de ML. Esse script baixará o pacote de ML do ambiente de destino (arquivo zip) e o salvará localmente na pasta timestamp. Ele também baixará um arquivo metadata.json para esse pacote de ML.

Antes de executar o script, é necessário criar um arquivo json com a seguinte chave/valores:

• hostOrFQDN: endpoint público de onde o serviço de back-end pode ser acessível com o número da porta.
• identityServerEndPoint: endpoint no qual o Identity Server está hospedado (frequentemente, o Orchestrator).
• hostTenantName: o nome do tenant do host registrado no Identity Server.
• hostTenantIdOrEmailId: a ID ou a ID do e-mail do tenant do host.
• hostTenantPassword: a senha do tenant do host.
• tenantName: o nome do tenant de onde a exportação do pacote de ML será realizada.
• projectName: o nome do projeto de onde o pacote de ML será exportado.
• mlPackageName: o nome do pacote de ML que será baixado do ambiente de destino.
• mlPackageVersion: o número da versão do pacote de ML que será baixado. O número da versão deve ter o seguinte formato: 3.2, 3.1.

Por exemplo, seu arquivo terá a seguinte aparecência:

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

Em seguida, basta executar o seguinte comando a partir da linha de comando:

./export.sh export_input.json

Ele criará localmente os dois arquivos:

• InvoicesFinal.zip: o pacote de ML
• InvoicesFinal_v8.3_metadata.json: metadados do pacote de ML

Importação de pacotes de ML

Use o arquivo de script import.sh para importar um pacote de ML. Esse script carregará um pacote de ML local para o projeto do AI Center.

Antes de executar o script, é necessário fornecer as seguintes informações:

• hostOrFQDN: endpoint público de onde o serviço de back-end pode ser acessível com o número da porta.
• identityServerEndPoint: endpoint no qual o Identity Server está hospedado (frequentemente, o Orchestrator).
• hostTenantName: o nome do tenant do host registrado no Identity Server.
• hostTenantIdOrEmailId: a ID ou a ID do e-mail do tenant do host.
• hostTenantPassword: a senha do tenant do host.
• tenantName: o nome do tenant para o qual a importação do pacote de ML será realizada.
• projectName: o nome do projeto para o qual o pacote de ML será importado.
• mlPackageName: o nome do pacote de ML para o qual uma nova versão será carregada, se existir. Em caso negativo, um novo pacote de ML com o mesmo nome será criado.
• mlPackageMajorVersionForPrivatePackage: é usado para carregar novas versões secundárias (por exemplo, 3.1). É usado apenas para pacotes privados. O valor padrão deve ser zero.
• mlPackageZipFilePath: o caminho do arquivo para o arquivo zip do pacote de ML com a extensão que será carregada para o ambiente de destino.
• mlPackageMetadataFilePath: o caminho do arquivo JSON de metadados de importação do pacote de ML com extensão.

Por exemplo, seu arquivo terá a seguinte aparecência:

{
    "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"
}

Em seguida, basta executar o seguinte comando a partir da linha de comando:

./import.sh import_input.json

Isso carregará o pacote de ML para o tenant e o projeto desejados; a versão será a versão principal especificada em seu arquivo de entrada e a próxima versão secundária disponível.

No exemplo acima, se o pacote de ML InvoicesFinal v8 já existir e a última versão secundária for 8.4, o pacote de ML será carregado com a versão 8.5. Se o pacote de ML ainda não existir nesse projeto, o pacote de ML será carregado com a versão 8.1.