UIP-Agent-Paket

uip agent pack bündelt ein lokales Agent-Projekt in eine .uis -Datei. .uis ist ein einfaches ZIP-Archiv der Projektstruktur; Es ist das von Studio Web akzeptierte Transportformat (uip agent push) und die Eingabe in den Orchestrator-Veröffentlichungsablauf (uip agent publish).

Vor dem Packen der Befehl:

1. Validiert die Projektstruktur (agent.json, entry-points.json, project.uiproj, Ressourcenstruktur).
2. Führt den Validierungslauf des Schemas in Studio Web aus (es sei denn, --skip-schema-validation ist festgelegt). Alle nicht schwerwiegenden Warnungen werden angezeigt; Jedes schwerwiegende Problem bricht das Paket mit einem Schema validation failed -Fehler ab.

Das erzeugte Archiv schließt .agent-builder/ (lokales Entwicklungsgerüst, das Studio Web beim Import neu generiert) aus.

Zusammenfassung

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

Alle uip agent pack -Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Argumente

• [path] (optional, Standard .) – Der Pfad zum Agent-Projektverzeichnis.

Optionen

Markieren	Standard	Zweck
-d, --destination <dir>	.	Zielverzeichnis für die Datei .uis . Wird erstellt, wenn er nicht vorhanden ist.
-n, --name <name>	Agent metadata.name → Projektverzeichnis Basisname	Paketname. Die Ausgabedatei ist <name>.uis.
--skip-schema-validation	aus	Überspringen Sie den Validierungslauf des Studio Web-Schemas. Nützlich zur Überprüfung von Projekten, die sich in Bearbeitung befinden, die von der Live-API abgelehnt würden; nicht in einer Release-Pipeline verwenden.

Beispiele

# 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

Datenform (--output json)

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

Warnungen, die während der Schemavalidierung ausgegeben werden, werden separat protokolliert (Warning Einträge) und erscheinen nicht im erfolgreichen Data. Bei schwerwiegenden Schemafehlern schlägt der Befehl fehl, bevor das Archiv geschrieben wird.

Zu veröffentlichende Beziehung

uip agent publish führt intern seine eigene Pack-/Migrations-/Neupack-Pipeline aus; müssen Sie pack nicht zuerst ausführen, wenn Ihr nächster Schritt publish ist. Verwenden Sie pack wenn Sie möchten:

• Ein .uis das Sie manuell überprüfen (in .zip umbenennen und entpacken können).
• Ein .uis den Sie über uip agent push <file.uis> in Studio Web übertragen möchten.
• Ein deterministisches lokales Archiv als Artefakt in einem CI-Auftrag.

Zugehörig

• uip agent validate – Führen Sie die Migrationspipeline vor dem Packen aus.
• uip agent publish – Packen und Pushen Sie das Paket in einem Schritt an den Orchestrator.
• uip agent push – importieren Sie ein gepacktes Projekt in Studio Web.

Siehe auch

• Globale Optionen, Exitcodes.