UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

actualisation d’agent uip

Appliquez les migrations de schéma en attente et régénérez les fichiers dérivés avec `uip agent refresh`.

uip agent refresh applique les migrations de schéma en attente et régénère les fichiers dérivés (entry-points.json, bindings_v2.json) à partir de agent.json. Elle régénérera toujours ces artefacts, même lorsque le schéma de stockage correspond déjà à la dernière version. Exécutez-le après chaque modification de agent.json, avant uip agent validate.

Contrairement à validate, rafraîchissez les fichiers d’écriture: elle répare contentTokens dérivé, déplace un agent.version obsolète, crée un project.uiproj manquant nommé d’après le répertoire du projet (agents autonomes uniquement), applique le pipeline de migration en mémoire, puis écrit le les fichiers sont migrés, régénérera entry-points.json / bindings_v2.json et, pour les agents --inline-in-flow , génère resources/<id>/resource.json pour tous les outils de connecteur Integration Service filés et élimine la configuration intégrée et obsolète de cet agent du fichier parent .flow . effort; n'échoue jamais la commande).

Synthèse​

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] et --path sont mutuellement exclusifs — en transmettant les deux génération de AgentRefreshConflictingPath.

Toutes les 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) — Répertoire du projet d'agent. Ne peut pas être combiné avec --path.

Options​

DrapeauDefaultObjectif
--path <path>—Alternative à l’argument positionnel [path]. Ne peut pas être combiné avec.
--bindings-target <path><projectDir>/bindings_v2.json; pour --inline-in-flow, le fichier bindings_v2.json du répertoire parent immédiat lorsqu'il contient un fichier .flowChemin d’accès dans lequel écrire/fusionner les liaisons de l’outil de l’agent.
--inline-in-flowdésactivéActualisez un agent en ligne dans un projet de flux. Ignore entry-points.json / project.uiproj vérifications; les liaisons sont fusionnées dans le fichier bindings_v2.json du projet de flux parent.

Exemples​

# 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

Format des données (--sortie 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 lit « déjà à <version>» au lieu de « migré vers» lorsqu’aucune migration n’a été appliquée. Chaque champ après Validated est facultatif et présent uniquement lorsque cette étape a produit quelque chose: AgentVersionBumped uniquement si agent.version lui-même a été bloqué; ProjectUiprojCreated uniquement lorsque l'actualisation a créé un project.uiproj manquant; MigratedFiles uniquement lorsque la valeur MigrationApplied est définie sur Vrai; ConnectorToolsGenerated uniquement pour les exécutions --inline-in-flow qui ont généré de nouveaux fichiers de ressources pour l’outil de connecteur; FlowShellified/FlowResourceNodesStripped uniquement pour les exécutions --inline-in-flow où la configuration intégrée du parent .flow a été supprimée; Warnings uniquement lorsque des avertissements non fatals se sont produits. InlineInFlow: true est ajouté pour --inline-in-flow exécutions.

L’échec utilise Code: "AgentRefreshFailed" avec la même forme de tableau Data.Errors que uip agent validate.

  • uip agent validate — la vérification stricte en lecture seule à exécuter après l'actualisation.
  • uip agent init — élaborations sur lesquelles fonctionne l'actualisation du projet.

Voir également​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour