actualización del agente de uip

Aplique las migraciones de esquema pendientes y regenere los archivos derivados con la `actualización del agente de uip`.

uip agent refresh aplica las migraciones de esquema pendientes y regenera los archivos derivados (entry-points.json, bindings_v2.json) de agent.json. Siempre regenera estos artefactos, incluso cuando el esquema de almacenamiento ya está en la versión más reciente. Ejecútalo después de cada edición en agent.json, antes de uip agent validate.

A diferencia de validate, actualizar escribe archivos: repara contentTokens desplazado, elimina un agent.version obsoleto, aplica el proceso de migración en memoria y luego vuelve a escribir los archivos migrados, regenera entry-points.json / bindings_v2.json, y — para --inline-in-flow agentes: genera resources/<id>/resource.json para cualquier herramienta de conector de Integration Service con cable y elimina la configuración incrustada obsoleta de este agente del archivo .flow principal (mejor esfuerzo; nunca falla el comando).

Sinopsis

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

[path] y --path son mutuamente excluyentes: pasan ambos lanzamientos AgentRefreshConflictingPath.

Todas las invocaciones respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

Argumentos

• [path] (opcional, predeterminado .) — Directorio del proyecto del agente. No se puede combinar con --path.

Opciones

Marca	Predeterminado	Propósito
--path <path>	—	Alternativa al argumento posicional [path]. No se puede combinar con él.
--bindings-target <path>	<projectDir>/bindings_v2.json; para --inline-in-flow, el bindings_v2.json del directorio principal inmediato cuando contiene un archivo .flow	Ruta en la que escribir/fusionar las vinculaciones de herramientas del agente.
--inline-in-flow	Desactivado	Actualizar un agente en línea dentro de un proyecto de flujo. Omite entry-points.json / project.uiproj comprobaciones; las vinculaciones se fusionan en el bindings_v2.json del proyecto de flujo principal.

Ejemplos

# 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

Forma de datos (--json de salida)

{
  "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 dice "ya en <version><versión>" en lugar de "migrado a" cuando no se aplicó ninguna migración. Cada campo después de Validated es opcional y está presente solo cuando ese paso produjo algo: AgentVersionBumped solo si el propio agent.version fue superado; MigratedFiles solo cuando MigrationApplied es verdadero; ConnectorToolsGenerated solo para ejecuciones --inline-in-flow que generaron nuevos archivos de recursos de herramienta de conector; FlowShellified/FlowResourceNodesStripped solo para ejecuciones --inline-in-flow en las que se eliminó la configuración incrustada del .flow principal; Warnings solo cuando se produjeron advertencias no graves. InlineInFlow: true se añade para --inline-in-flow ejecuciones.

El fallo utiliza Code: "AgentRefreshFailed" con la misma forma de matriz Data.Errors que uip agent validate.

Relacionado

• uip agent validate : la comprobación estricta de solo lectura que se ejecutará después de la actualización.
• uip agent init : andamios en los que opera la actualización del proyecto.

Ver también

• Opciones globales, códigos de salida.