UIP エージェントの更新

「uip agent refresh」を使用して、保留中のスキーマ移行を適用し、派生ファイルを再生成します。

uip agent refresh 保留中のスキーマの移行を適用し、 から派生ファイル (entry-points.json、 bindings_v2.jsonを再生成 agent.json。これらの成果物は、ストレージ スキーマがすでに最新バージョンである場合でも、常に再生成されます。agent.jsonを編集するたびに、 をuip agent validate前に実行します。

validateとは異なり、更新はファイルを書き込みます。ドリフトされたcontentTokensを修復し、古いagent.versionをバンプし、移行パイプラインをメモリ内に適用してから移行されたファイルを書き戻し、entry-points.json/bindings_v2.jsonを再生成します。--inline-in-flow エージェントの場合は、有線の Integration Service コネクタ ツールのresources/<id>/resource.jsonを生成し、親の .flow ファイルからこのエージェントの古い埋め込み構成を削除します (ベストエフォート。コマンドは失敗しません)。

概要

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

[path] と --path は相互に排他的であり、両方のスローを AgentRefreshConflictingPath渡します。

すべての呼び出しは、 グローバル オプション (--output、 --output-filter、 --log-level、 --log-file) に従います。終了コードは 標準契約に従います。

引数

• [path] (任意、既定値は .) — エージェントのプロジェクト ディレクトリです。--pathと組み合わせることはできません。

オプション

フラグ	既定 (Default)	目的
--path <path>	—	positional [path] 引数の代替手段です。組み合わせることはできません。
--bindings-target <path>	<projectDir>/bindings_v2.json;--inline-in-flowの場合、直接の親ディレクトリに .flow ファイルが含まれている場合のbindings_v2.json	エージェント ツールのバインドの書き込み/結合先のパスです。
--inline-in-flow	無効	フロー プロジェクト内のインライン エージェントを更新します。entry-points.json/project.uiprojのチェックをスキップします。バインドは親フロー プロジェクトの bindings_v2.jsonにマージされます。

例

# 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

データシェイプ(--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<version>移行を適用していない場合、 は「移行先>」ではなく、「<バージョンです。」と表示されます。Validated以降のすべてのフィールドは任意であり、そのステップが何かを生成した場合にのみ存在します。AgentVersionBumped、agent.version自体が衝突した場合にのみ存在します。MigrationAppliedが true の場合にのみMigratedFilesします。新しいコネクタ ツール リソース ファイルを生成した --inline-in-flow の実行に対してのみConnectorToolsGenerated。FlowShellified/FlowResourceNodesStripped 親.flowの埋め込み構成が削除された--inline-in-flow実行に対してのみ。致命的ではない警告が発生した場合のみWarnings。--inline-in-flow実行に対してInlineInFlow: trueが追加されます。

[失敗] では、 と同じData.Errors配列形状のCode: "AgentRefreshFailed"が使用されuip agent validate。

関連

• uip agent validate — 更新後に実行する、読み取り専用の厳密なチェックです。
• uip agent init — プロジェクトの更新が動作するスキャフォールドです。

参照

• グローバル オプション、 終了コード。