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îchir les fichiers d’écriture: elle répare le contentTokens dérivé, déplace le fichier agent.version obsolète, applique le pipeline de migration en mémoire, puis réécrit les fichiers migrés, régénère entry-points.json / bindings_v2.json et — pour --inline-in-flow agents: génère resources/<id>/resource.json pour tous les outils de connecteur Integration Service filés et supprime la configuration intégrée obsolète de cet agent du fichier .flow parent (dans le meilleur effort; la commande n'échoue jamais).

Synthèse

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

Drapeau	Default	Objectif
--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 .flow	Chemin d’accès dans lequel écrire/fusionner les liaisons de l’outil de l’agent.
--inline-in-flow	dé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

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,
    "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à au niveau de <version>". au lieu de « migré vers » lorsqu’aucune migration n’était 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é; 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 d’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.

Associé

• 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

• Options globales, codes de sortie.