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.

Im Gegensatz zu validate schreibt die Aktualisierung Dateien: sie repariert die Folgen contentTokens, stößt ein veraltetes agent.version an, wendet die Migrationspipeline im Arbeitsspeicher an und schreibt dann die migrierten Dateien zurück, generiert entry-points.json / bindings_v2.json neu und – für --inline-in-flow Agents – Generiert resources/<id>/resource.json für alle verzweigten Integration Service-Connector-Tools und entfernt die veraltete eingebettete Konfiguration dieses Agents aus der übergeordneten .flow -Datei ( nach bestem Wissen und Gewissen; der Befehl schlägt nie fehl).

Zusammenfassung

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

Markieren	Standard	Zweck
--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ält	Pfad, in den Agent-Tool-Bindungen geschrieben/zusammengeführt werden sollen.
--inline-in-flow	aus	Aktualisieren 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

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,
    "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 liest „bereits bei <version>&LT;Version“;“ anstelle von „migriert nach“ wenn keine Migration angewendet wurde. Jedes Feld nach Validated ist optional und nur dann vorhanden, wenn dieser Schritt etwas erzeugt hat: AgentVersionBumped nur, wenn agent.version selbst bußen wurde; MigratedFiles nur, wenn MigrationApplied „true“ ist; ConnectorToolsGenerated nur für --inline-in-flow Ausführungen, die neue Connector-Tool-Ressourcendateien generiert haben; FlowShellified/FlowResourceNodesStripped nur für --inline-in-flow -Ausführungen, bei denen die eingebettete Konfiguration des übergeordneten .flow entfernt wurde; Warnings nur, wenn nicht schwerwiegende Warnungen aufgetreten sind. InlineInFlow: true wird für --inline-in-flow -Ausführungen hinzugefügt.

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

Zugehörig

• 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

• Globale Optionen, Exitcodes.