UIP-Agent pushen/ziehen

uip agent push und uip agent pull sind die beiden Hälften des Studio Web-Round Überprüfen. Sie haben das gleiche Transportformat (.uis, ein ZIP-Archiv des Agent-Projekts), das gleiche Authentifizierungsmodell und die gleiche Fehleroberfläche. Verwenden Sie push , um ein lokales Projekt an Studio Web zu senden, damit es in der Agent Builder-Benutzeroberfläche angezeigt wird; Verwenden Sie pull um eine Lösung von Studio Web als .uis herunterzuladen, die Sie überprüfen, extrahieren oder wieder in eine Orchestrator-Bereitstellung packen können.

Beide Verben erfordern eine aktive CLI-Sitzung (uip login).

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

---

uip agent push

Importieren Sie ein Agent-Projekt als neue Lösung in Studio Web oder überschreiben Sie eine vorhandene Lösung.

Wenn es sich bei der Eingabe um ein Verzeichnis handelt, validiert push die Projektstruktur, führt den Validierungslauf des Schemas von Studio Web aus (außer --skip-schema-validation), verpackt es in ein temporäres .uis ohne .agent-builder/ und veröffentlicht das Archiv in der Studio Web-Lösung Import-API. Wenn die Eingabe bereits ein .uis ist, wird das Archiv so hochgeladen, wie es ist.

Bei einem erfolgreichen Verzeichnis-Pfad wird SolutionStorage.json im Projektstamm mit der zurückgegebenen Cloud-Lösung und Projekt-IDs aktualisiert – nachfolgende uip agent eval run -Aufrufe können diese IDs verwenden, ohne dass Sie --solution-id übergeben.

Zusammenfassung

uip agent push [path] [-n <name>] [--overwrite <solutionId>] [--skip-schema-validation] [--login-validity <minutes>]

Argumente

• [path] (optional, Standard .) – Der Pfad zum Agent-Projektverzeichnis oder zu einer .uis -Datei.

Optionen

Markieren	Standard	Zweck
-n, --name <name>	Agent metadata.name → Pfadbasisname	Lösungsname in Studio Web.
--overwrite <solutionId>	–	Überschreiben Sie eine vorhandene Lösung nach ID, anstatt eine neue zu erstellen. Ändert den Endpunkt von POST /api/Solution/Import zu POST /api/Solution/<id>/Overwrite.
--skip-schema-validation	aus	Überspringen Sie den Validierungslauf des Studio Web-Schemas. Nur Verzeichniseingaben – eine .uis -Eingabe führt nie eine Schemavalidierung aus.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiele

# Push the current directory as a new solution
uip agent push

# Push a specific directory
uip agent push ./my-agent

# Overwrite an existing solution in place
uip agent push ./my-agent --overwrite a1b2c3d4-0000-0000-0000-000000000001

# Push a pre-packed archive
uip agent push ./dist/my-agent.uis

Datenform (--output json)

{
  "Code": "AgentPush",
  "Data": {
    "Status": "Agent imported into Studio Web",
    "Name": "my-agent",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectCount": 1,
    "CloudProjectId": "a1b2c3d4-0000-0000-0000-000000000002"
  }
}

Mit --overwrite ist Status "Solution overwritten successfully" und SolutionId gibt den übergebenen Wert wieder. CloudProjectId ist "-" wenn die Antwort kein Projekt-Array enthält.

---

UIP-Agent-Pull

Laden Sie eine Lösung von Studio Web als .uis -Archiv herunter. Extrahieren Sie optional das Archiv in ein gleichgeordnetes Verzeichnis.

Zusammenfassung

uip agent pull <solutionId> [-d <dir>] [-n <name>] [--extract] [--login-validity <minutes>]

Argumente

• <solutionId> (erforderlich) – Lösungs-UUID. Rufen Sie eine von uip agent list ab.

Optionen

Markieren	Standard	Zweck
-d, --destination <dir>	.	Zielverzeichnis für die heruntergeladene Datei. Wird bei Bedarf erstellt.
-n, --name <name>	<solutionId>	Ausgabedateiname (ohne Erweiterung). .uis wird angefügt, wenn nicht vorhanden.
--extract	aus	Extrahieren Sie die .uis nach dem Herunterladen in ein Verzeichnis mit demselben Namen.
--login-validity <minutes>	10	Mindestlaufzeit des Tokens in Minuten erforderlich.

Beispiele

# Download by ID into the current directory
uip agent pull a1b2c3d4-0000-0000-0000-000000000001

# Download into a specific directory
uip agent pull a1b2c3d4-0000-0000-0000-000000000001 -d ./downloads

# Download with a friendly filename and extract
uip agent pull a1b2c3d4-0000-0000-0000-000000000001 \
  -d ./downloads \
  -n invoice-agent \
  --extract

Datenform (--output json)

{
  "Code": "AgentPull",
  "Data": {
    "Status": "Solution exported successfully",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Output": "/abs/path/downloads/a1b2c3d4-0000-0000-0000-000000000001.uis"
  }
}

Bei --extract enthält die Nutzlast zusätzlich ExtractedTo: "/abs/path/downloads/<name>".

---

Beispiel für einen Round Trip

# Iterate locally, push to Studio Web, edit in the UI, pull back
uip agent init ./my-agent
uip agent validate ./my-agent
uip agent push ./my-agent               # captures SolutionId

# (edit in Studio Web)

uip agent pull <SolutionId> -d ./downloads --extract
# compare ./my-agent with ./downloads/<SolutionId>/ to reconcile

Zugehörig

• uip agent list – Lösungs-IDs auflisten, die in pull eingegeben werden sollen.
• uip agent pack – erstellen Sie ein .uis ohne Studio Web einzubeziehen.
• uip agent validate – Vor push ausführen, um serverseitige Ablehnungen zu vermeiden.
• uip agent share – teilen Sie eine Lösung nach dem Pushen.

Siehe auch

• Authentifizierung – Sitzungen und --login-validity.
• Konzepte: Fähigkeiten – Wie die Einstiegspunkte einer importierten Lösung zu Fähigkeiten werden.
• Globale Optionen, Exitcodes.