UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

UIP-Agent-Aktualisierung

Wenden Sie ausstehende Schemamigrationen an, und generieren Sie abgeleitete Dateien mit „uip agentfresh“ neu.

uip agent refresh wendet ausstehende Schemamigrationen an und generiert die abgeleiteten Dateien (entry-points.json, bindings_v2.json) von agent.json neu. Diese Artefakte werden immer neu generiert, auch wenn das Speicherschema bereits auf der neuesten Version ist. Führen Sie es nach jeder Bearbeitung von agent.json, vor uip agent validate aus.

Unlike validate, refresh writes files: it repairs drifted contentTokens, bumps an outdated agent.version, creates a missing project.uiproj named after the project directory (standalone agents only), applies the migration pipeline in-memory then writes the migrated files back, regenerates entry-points.json / bindings_v2.json, and — for --inline-in-flow agents — generates resources/<id>/resource.json for any wired Integration Service connector tools and strips this agent's stale embedded config out of the parent .flow file (best-effort; never fails the command).

Zusammenfassung​

uip agent refresh [path] [--path <path>] [--bindings-target <path>] [--inline-in-flow]
uip agent refresh [path] [--path <path>] [--bindings-target <path>] [--inline-in-flow]

[path] und --path schließen sich gegenseitig aus – beide Trigger werden übergeben AgentRefreshConflictingPath.

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

Argumente​

  • [path] (optional, Standard .) – Agent-Projektverzeichnis. Kann nicht mit --path kombiniert werden.

Optionen​

MarkierenStandardZweck
--path <path>–Alternative zum Positionalargument [path]. Kann nicht damit kombiniert werden.
--bindings-target <path><projectDir>/bindings_v2.json; für --inline-in-flow das bindings_v2.json des unmittelbar übergeordneten Verzeichnisses, wenn es eine .flow -Datei enthältPfad, in den Agent-Tool-Bindungen geschrieben/zusammengeführt werden sollen.
--inline-in-flowausAktualisieren Sie einen Inline-Agent innerhalb eines Flow-Projekts. Überspringt entry-points.json / project.uiproj Prüfungen; Bindungen werden mit dem bindings_v2.json des übergeordneten Flow-Projekts zusammengeführt.

Beispiele​

# Refresh the current directory after editing agent.json
uip agent refresh

# Refresh a specific standalone project
uip agent refresh ./my-agent

# Refresh an inline agent, merging bindings into the parent flow
uip agent refresh ./my-flow/<uuid> --inline-in-flow
# Refresh the current directory after editing agent.json
uip agent refresh

# Refresh a specific standalone project
uip agent refresh ./my-agent

# Refresh an inline agent, merging bindings into the parent flow
uip agent refresh ./my-flow/<uuid> --inline-in-flow

Datenform (--output json)​

{
  "Code": "AgentRefresh",
  "Data": {
    "Status": "Refreshed — storage schema migrated to 47.0.0; artifacts regenerated",
    "ProjectDir": "/abs/path/my-agent",
    "Model": "gpt-5.4",
    "StorageVersion": "47.0.0",
    "MigrationApplied": true,
    "Validated": { "agent": true, "resources": 2, "evalSets": 0, "evaluators": 0 },
    "AgentVersionBumped": true,
    "ProjectUiprojCreated": true,
    "MigratedFiles": 1,
    "ConnectorToolsGenerated": [
      { "nodeId": "n1", "name": "SlackSender", "connectorKey": "uipath-slack", "resourceId": "a1b2c3d4-0000-0000-0000-000000000605" }
    ],
    "DerivedFilesGenerated": true,
    "DerivedFiles": 2,
    "FlowShellified": true,
    "FlowResourceNodesStripped": 1,
    "Warnings": ["..."]
  }
}
{
  "Code": "AgentRefresh",
  "Data": {
    "Status": "Refreshed — storage schema migrated to 47.0.0; artifacts regenerated",
    "ProjectDir": "/abs/path/my-agent",
    "Model": "gpt-5.4",
    "StorageVersion": "47.0.0",
    "MigrationApplied": true,
    "Validated": { "agent": true, "resources": 2, "evalSets": 0, "evaluators": 0 },
    "AgentVersionBumped": true,
    "ProjectUiprojCreated": true,
    "MigratedFiles": 1,
    "ConnectorToolsGenerated": [
      { "nodeId": "n1", "name": "SlackSender", "connectorKey": "uipath-slack", "resourceId": "a1b2c3d4-0000-0000-0000-000000000605" }
    ],
    "DerivedFilesGenerated": true,
    "DerivedFiles": 2,
    "FlowShellified": true,
    "FlowResourceNodesStripped": 1,
    "Warnings": ["..."]
  }
}

Status reads "already at <version>" instead of "migrated to" when no migration was applied. Every field after Validated is optional and present only when that step produced something: AgentVersionBumped only if agent.version itself was bumped; ProjectUiprojCreated only when refresh created a missing project.uiproj; MigratedFiles only when MigrationApplied is true; ConnectorToolsGenerated only for --inline-in-flow runs that generated new connector-tool resource files; FlowShellified/FlowResourceNodesStripped only for --inline-in-flow runs where the parent .flow's embedded config was stripped; Warnings only when non-fatal warnings occurred. InlineInFlow: true is added for --inline-in-flow runs.

Fehler verwendet Code: "AgentRefreshFailed" mit derselben Data.Errors -Array-Form wie uip agent validate.

  • uip agent validate – die strenge, schreibgeschützte Prüfung, die nach der Aktualisierung ausgeführt werden soll.
  • uip agent init – Gerüst, auf dem die Projektaktualisierung ausgeführt wird.

Siehe auch​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben