pack d’agent uip

uip agent pack regroupe un projet d'agent local dans un fichier .uis . Une .uis est une archive ZIP simple de l’arborescence du projet; il s'agit du format de transport accepté par Studio Web (uip agent push) et de l'entrée du flux de publication Orchestrator (uip agent publish).

Avant de compresser, la commande:

1. Valide la structure du projet (agent.json, entry-points.json, project.uiproj, arborescence des ressources).
2. Exécute la réussite de la validation du schéma Studio Web (à moins que --skip-schema-validation ne soit défini). Tous les avertissements non fatals sont apparus; un problème critique abandonne le pack avec une erreur Schema validation failed .

L’archive produite exclut .agent-builder/ (élaboration de développement local que Studio Web régénère lors de l’importation).

Synthèse

uip agent pack [path] [-d <dir>] [-n <name>] [--skip-schema-validation]

Toutes les uip agent pack 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 .) — Chemin d'accès au répertoire du projet d'agent.

Options

Drapeau	Default	Objectif
-d, --destination <dir>	.	Répertoire de destination pour le fichier .uis . Créé si elle n’existe pas.
-n, --name <name>	agent metadata.name → nom de base du répertoire du projet	Nom du package. Le fichier de sortie est <name>.uis.
--skip-schema-validation	désactivé	Ignorez la validation du schéma Studio Web. Utile pour inspecter les projets en cours qui seraient rejetés par l'API active; ne l'utilisez pas dans un pipeline de version.

Exemples

# Pack the current directory into ./my-agent.uis
uip agent pack

# Pack a specific project into ./dist/my-agent.uis
uip agent pack ./my-agent -d ./dist

# Override the archive name
uip agent pack ./my-agent -d ./dist --name invoice-agent-v1

# Skip schema validation to pack a work-in-progress project
uip agent pack ./my-agent --skip-schema-validation

Format des données (--sortie json)

{
  "Code": "AgentPack",
  "Data": {
    "Status": "Agent packed successfully",
    "Name": "my-agent",
    "Output": "/abs/path/dist/my-agent.uis"
  }
}

Les avertissements émis lors de la validation du schéma sont consignés séparément (Warning entrées) et n'apparaissent pas dans la réussite Data. Les erreurs de schéma fatales échouent la commande avant l’écriture de l’archive.

Relation à publier

uip agent publish exécute son propre pipeline de pack/migrate/repack en interne; vous n'avez pas besoin d'exécuter d'abord pack si votre étape suivante est publish. Utilisez pack lorsque vous souhaitez:

• Un .uis que vous pouvez inspecter à la main (renommer .zip et décompresser).
• Un .uis que vous prévoyez de transmettre à Studio Web via uip agent push <file.uis>
• Une archive locale déterministe en tant qu'artefact dans une tâche CI.

Associé

• uip agent validate — exécute le pipeline de migration avant la mise en package.
• uip agent publish — compressez et transmettez le package à Orchestrator en une seule étape.
• uip agent push — importer un projet compressé dans Studio Web.

Voir également

• Options globales, codes de sortie.