atualização do agente de UIP

Aplique migrações de esquema pendentes e gere novamente arquivos derivados com a "atualização do agente uip".

uip agent refresh aplica migrações de esquema pendentes e regenera os arquivos derivados (entry-points.json, bindings_v2.json) de agent.json. Ele sempre gera novamente esses artefatos, mesmo quando o esquema de armazenamento já está na versão mais recente. Execute-o após cada edição de agent.json, antes de uip agent validate.

Ao contrário de validate, a atualização grava arquivos: ela repara contentTokens descontrolados, impulsiona um agent.version desatualizado, aplica o pipeline de migração na memória, depois grava os arquivos migrados de volta, regenera entry-points.json / bindings_v2.json e — para --inline-in-flow agentes — gera resources/<id>/resource.json para quaisquer ferramentas de conector do Integration Service com conector e remove a configuração incorporada obsoleta desse agente do arquivo pai .flow (melhor esforço; nunca falha no comando).

Resumo

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

[path] e --path são mutuamente exclusivos — passando ambos os lançamentos AgentRefreshConflictingPath.

Todas as invocações honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Argumentos

• [path] (opcional, padrão .) — Diretório do projeto do agente. Não pode ser combinado com --path.

Opções

Bandeira	Padrão	Finalidade
--path <path>	—	Alternativa ao [path] argumento posicional. Não pode ser combinado com ele.
--bindings-target <path>	<projectDir>/bindings_v2.json; para --inline-in-flow, o bindings_v2.json do diretório pai imediato quando ele contiver um arquivo .flow	Caminho no qual gravar/mesclar associações de ferramentas de agente.
--inline-in-flow	desativada	Atualize um agente embutido dentro de um projeto de fluxo. Ignora entry-points.json / project.uiproj verificações; as associações são mescladas no bindings_v2.json do projeto de fluxo pai.

Exemplos

# 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

Formato dos dados (--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 lê "já em <version><version"gt;" em vez de "migrou para" quando nenhuma migração foi aplicada. Cada campo após Validated é opcional e estará presente apenas quando essa etapa produziu algo: AgentVersionBumped somente se o próprio agent.version tiver sido eliminado; MigratedFiles apenas quando MigrationApplied for verdadeiro; ConnectorToolsGenerated apenas para --inline-in-flow execuções que geraram novos arquivos de recursos de ferramenta de conector; FlowShellified/FlowResourceNodesStripped apenas para --inline-in-flow execuções em que a configuração incorporada do pai .flow foi removida; Warnings apenas quando avisos não fatais ocorriam. InlineInFlow: true é adicionado para --inline-in-flow execuções.

A falha usa Code: "AgentRefreshFailed" com o mesmo formato de matriz Data.Errors que uip agent validate.

Relacionado

• uip agent validate — a verificação rigorosa e somente leitura a ser executada após a atualização.
• uip agent init — estrutura em que a atualização do projeto opera.

Veja também

• Opções globais, Códigos de saída.