publication d’agent UIP

uip agent publish compresse un projet d'agent et transmet le package résultant à Orchestrator sous forme de nouvelle version de package de solution. Le PackageVersionKey renvoyé est l'entrée de uip agent deploy.

En interne, publish exécute un pipeline en plusieurs étapes:

1. Si l'entrée est un répertoire, il valide la structure du projet et le compresse dans un .uis temporaire.
2. Il extrait le fichier .uis, migre tout le fichier agent.json / resource.json vers le storageVersion attendu (actuellement 44.0.0) et le compresse.
3. Il se développe vers uip solution pack pour produire une solution .zip (contenant un ou plusieurs fichiers .nupkg ).
4. Il télécharge la solution, soit par le biais de l'API Solutions standard (par défaut), soit directement dans le flux de packages d'Orchestrator lorsque --direct est défini.

Nécessite une session CLI active (uip login).

Synthèse

uip agent publish [path] [-t <tenant>] [-l <locationKey>] [-n <name>]
                  [--package-version <version>]
                  [--folder-id <id>] [--direct]
                  [--login-validity <minutes>]

Toutes les uip agent publish invocations respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

Arguments

• [path] (facultatif, par défaut .) — Le chemin d'accès au répertoire du projet d'agent ou à un fichier .uis déjà compressé. Une entrée .uis ignore l'étape de compression; tout ce qui se trouve en aval (migrer, compresser, pack de solution, téléchargement) s'exécute toujours.

Options

Drapeau	Default	Objectif
-t, --tenant <tenant>	se connecter au locataire	Locataire cible. Requis si la session de connexion n’a pas de locataire par défaut.
-l, --location-key <guid>	—	GUID facultatif transféré vers l'appel packagesUpload d'API Solutions (utilisé par le chemin de téléchargement par défaut uniquement).
-n, --name <name>	agent metadata.name → nom de base du chemin	Nom du package. Devient le nom du fichier .uis / .zip et le nom du package dans Orchestrator.
--package-version <version>	1.0.0	Chaîne de version du package téléchargé.
--folder-id <id>	ID d'unité organisationnelle du dossier de connexion	ID d'unité organisationnelle du dossier Orchestrator. Consulté uniquement lorsque --direct est défini; le chemin de téléchargement des solutions par défaut l'ignore.
--direct	désactivé	Chargez chaque .nupkg directement dans le flux de package d’Orchestrator et créez une Release par package, en contournant l’API Solutions. Utilisez cette option lorsque le chemin de déploiement des solutions échoue ou si vous souhaitez que les versions soient créées immédiatement dans un dossier spécifique.
--login-validity <minutes>	10	Nombre minimum de minutes de validité du jeton requis. Voir Authentification.

Exemples

# Publish the current project to the login tenant
uip agent publish --package-version 1.0.0

# Publish a specific project folder
uip agent publish ./my-agent --package-version 1.0.0

# Publish a pre-packed .uis
uip agent publish ./dist/my-agent.uis --package-version 1.0.0

# Direct upload into a specific folder (creates releases in that folder)
uip agent publish ./my-agent \
  --package-version 1.1.0 \
  --direct --folder-id 42

# Override tenant and name
uip agent publish ./my-agent \
  -t production \
  -n invoice-agent \
  --package-version 2.0.0

Format des données (--sortie json)

Chemin de téléchargement par défaut (Code: "AgentPublish"):

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published successfully",
    "Name": "my-agent",
    "Version": "1.0.0",
    "PackageVersionKey": "a1b2c3d4-0000-0000-0000-000000000050"
  }
}

Le PackageVersionKey est ce que vous transmettez à uip agent deploy.

--direct Chemin d'accès

{
  "Code": "AgentPublish",
  "Data": {
    "Status": "Published to Orchestrator (direct)",
    "Name": "my-agent",
    "Version": "1.0.0",
    "Releases": [
      {
        "Name": "InvoiceAgent",
        "Key": "a1b2c3d4-0000-0000-0000-000000000055",
        "ProcessKey": "com.uipath.agent.InvoiceAgent"
      }
    ]
  }
}

En mode --direct , chaque .nupkg à l’intérieur de la solution .zip est téléchargé séparément, et une version est créée par package. Il n’y a pas PackageVersionKey; le concept correspondant est le Key par version — utilisable directement avec uip agent run start.

Comportement de migration

publish attend une storageVersion pas supérieure à 44.0.0, tandis que les nouveaux projets Studio Web peuvent être 47.0.0. Il réécrit en mode silencieux les fichiers agent.json et resource.json à l'intérieur du répertoire d'extraction temporaire vers le schéma attendu avant de procéder au compressage. Votre projet sur disque n’est jamais modifié.

Chaque fichier migré produit une entrée de journal Message (par exemple, Migrated /tmp/…/agent.json: storageVersion 47.0.0 → 44.0.0).

Associé

• uip agent pack — l'étape de compression locale (incluse en interne).
• uip agent deploy — installez et activez la version du package téléchargée.
• uip agent validate — exécutez des vérifications statiques et la migration par rapport à votre projet sur disque avant la publication.

Voir également

• Authentification — sessions, locataires et --login-validity.
• Orchestrator: tâches — où les processus d'agent publiés s'exécutent au final.
• Options globales, codes de sortie.