ツール (プラグイン)

UiPath CLI は、インストール可能な ツールのセットをラップした小さなホストです。各ツールは、1つのトップレベルコマンド(およびそのサブコマンド)をホストに登録する通常のnpmパッケージです。これは、 uip がなぜそのように動作するのか、つまり、自動的にインストールされるもの、インストールされないもの、バージョンの同期を維持する方法、マシンごとに異なるコマンドが表示される理由を理解するための最も重要な概念です uip --help 。

ホストとツール

ホスト (@uipath/cli、 uip 実行可能ファイル) は、 限られた関心事のみを所有します。

• 認証 (uip login、 uip logout、 uip login status、 uip login tenant …)
• セッションと資格情報の管理。
• ツールのライフサイクル (uip tools list / search / install / update / uninstall
• エージェントをコーディングするためのスキル (uip skills install / update / uninstall)
• モデル コンテキスト プロトコル ブリッジ (uip mcp)。
• シェル補完インストール (uip completion)
• グローバル オプション (--output、 --output-filter、 --log-level、 --log-file)、および JSON 出力エンベロープ

UiPath サーフェスに触れるすべてのもの (Orchestrator、ソリューション、エージェント、フロー、Maestro、RPA パッケージ、Test Manager、Integration Service、Data Fabric、Insights、トレース、DocsAI、API ワークフロー、垂直ソリューション、コード化されたエージェント、コード化されたApps) は、ホストがオンデマンドで読み込む独立した npm パッケージに含まれています。

分割の理由:

• 独立したリリース周期 — Orchestrator ツールは、ホストを再リリースせずに出荷できます。また、その逆も同様です。
• インストールフットプリントの縮小 — テストパイプラインのみを実行するユーザーは、ディスク上にFlowまたはMaestroツールを必要としません。
• 安定したコントラクト — ツールは、共有内部ではなく、バージョン管理されたプログラムインターフェイス(コマンド登録、出力エンベロープ、コンテキスト、テレメトリ)を介してホストと通信します。
• 起動の高速化 — ツールコードは遅延して読み込まれます。ホストは、argvを解析して関連するツールを識別するために最小限のことを行い、そのツールのバンドルを一度要求します。

自動インストールのホワイトリスト

UiPath が所有する一連のツールは、 自動インストールのホワイトリストに登録されています。ホストはコマンドエイリアスでそれらを認識し、エイリアスをnpmパッケージにマッピングします。

エイリアス	パッケージ	長い名前
or	@uipath/orchestrator-tool	Orchestrator
solution	@uipath/solution-tool	解決策
resource	@uipath/resource-tool	リソース
rpa	@uipath/rpa-tool	RPA (Studio のパッケージ化、アナライザー、復元)
agent	@uipath/agent-tool	オペレーター
codedagent	@uipath/codedagent-tool	コード化されたエージェント
codedapp	@uipath/codedapp-tool	コード化されたアプリ
maestro	@uipath/maestro-tool	Maestro
tm	@uipath/test-manager-tool	Test Manager
is	@uipath/integrationservice-tool	Integration Service
vss	@uipath/vertical-solutions-tool	バーティカルソリューション
api-workflow	@uipath/api-workflow-tool	API ワークフロー
df	@uipath/data-fabric-tool	Data Fabric
insights	@uipath/insights-tool	Insights
traces	@uipath/traces-tool	トレース
docsai	@uipath/docsai-tool	DocsAI

ホストは、他のすべてをツールではないものとして扱います。2つの追加ツールが出荷されますが、明示的なインストールが必要です—それらは自動インストールのホワイトリストに載っていません。

• Flow (@uipath/flow-tool, alias flow) — uip flowコマンドを実行する前に uip tools install @uipath/flow-tool でインストールします。
• RPA レガシ (@uipath/rpa-legacy-tool、別名 rpa-legacy) — クロスプラットフォーム rpa ツールにまだ移植されていない Studio コマンド (debug、validate、find-activities、find-package、type-definition、package) 用のuipcli.exe Windows 専用ラッパーです。uip tools install @uipath/rpa-legacy-toolとともにインストールします。「uip rpa-legacy」をご覧ください。

自動的にインストールされるものとインストールされないもの

何もプリインストールされていません。新しい npm install -g @uipath/cli では、ホストのみがディスクに配置されます。

マシンにツールをインストールするには、次の 2 つの方法があります。

1. 初回使用時に自動インストールされます。プレフィックスがホワイトリストのエントリと一致するコマンドを初めて呼び出すと (たとえば、Orchestrator ツールがインストールされる前 uip or folders list )、ホストは npm から @uipath/orchestrator-tool をダウンロードしてインストールし、コマンドを実行します。その後の呼び出しでは、インストールされているツールが直接使用されるため、2 回目の実行は高速です。

2. 明示的なインストール。uip tools install <alias> (または完全なパッケージ名) を実行します。同じ終了状態。自動インストールの手順が不要なため、実行時の処理時間が短縮されます。詳しくは、「 uip tools reference」をご覧ください。

CI ランナーとオフライン環境では明示的なインストールを使用して、ビルド時間が決定論的であり、ジョブの最初のコマンドで 1 回限りのダウンロード コストが支払われないようにします。完全なトレードオフについては、 インストールガイドの自動インストールセクションを参照してください 。

注:

現在、自動インストールを無効にすることはできません。それをスキップする環境変数やフラグはありません — CI=trueですら。実用的な回避策は、使用することがわかっているツールをプリインストールすることです。ツールがすでに存在する場合は、自動インストールは不要です。これは、将来のマイナー リリースで変更される可能性があります。

サードパーティ ツールは UiPath CLI 1.x で はサポートされていません 。ホストはインストール時にホワイトリストに対して検証を行うため、uip tools install my-company/some-toolValidationErrorで失敗します。パブリック拡張メカニズムは、後のバージョンで表示される場合があります。現時点では、上記の表のツールのみが読み込まれ uip 。

ディスク上のツールが存在する場所

ツールは、CLI のエントリ スクリプトを所有する npm プレフィックスの下の @uipath/ フォルダーにインストールされます。

• @uipath/cli をグローバルにインストールした場合 (npm install -g @uipath/cli)、ツールはその隣にグローバルにインストールされます — $(npm root -g)/@uipath/<tool-name>/.
• CLI をローカル プロジェクト(パッケージ内のnpm install @uipath/cli )にインストールした場合、ツールはその隣に ローカル (そのプロジェクトの node_modules/@uipath/<tool-name>/)にインストールされます。

言い換えれば、ツールはCLIに従います:グローバルCLI、グローバルツール。ローカル CLI、ローカル ツール。これは自動的に処理され、スコープ フラグを渡す必要はありませんuip tools install

uip tools listを実行して、インストールされているツールとバージョンを確認します。npm root -gを実行して、マシン上のグローバル インストール パスを見つけます。

バージョンの解決 — ツールはホストを追跡します

デフォルトでは、 各ツールバージョンはCLIのmajor.minor行に固定されます。CLI 1.0.xを使用して uip tools install or を実行すると、ホストはバージョンが 1.0. で始まる最新の@uipath/orchestrator-toolを解決してインストールします。uip tools updateを実行すると、インストールされているすべてのツールが、CLIのmajor.minor行内の最新バージョンにバンプされます。

実際的な結果:

• CLI を新しいマイナー バージョンにアップグレードするには、2 段階の操作が必要です。npm install -g @uipath/cli@1.1.0後、uip tools updateを実行して、インストールされているすべてのツールを 1.1.x にします。行。
• CLI をピン留めすると、すべてのツールが効果的にピン留めされます。npm install -g @uipath/cli@1.0.3 、 uip tools update は、任意のマシン上で決定論的なツール バージョンのセットを生成します。
• ホストとツールは、互換性のあるプロトコルの変更を一緒に出荷します。1.1.x に対して構築されたツール1.0.x という内部コントラクトを呼び出すことができます知らない — CLI+ツールのバージョンを混在させると、ホストが理解できないツールをロードするリスクがあります。

既定値を上書きして、特定のツール バージョンを明示的にインストールできます。

uip tools install orchestrator-tool@1.2.3
uip tools update --name @uipath/orchestrator-tool --version 1.2.5

チャンネル(alpha、 beta)は、npmのdist-tagメカニズム(たとえば、最新のベータリリースを選択する uip tools install orchestrator-tool@beta )を介してサポートされています。安定したツール内のプレビュー コマンドは、個別にラベル付けされます。 「バージョン管理と安定性」をご覧ください。

ヒント:

デプロイ後にマシン上に存在するツールのバージョンを確認するために、 uip tools list --output json はインストールされた各ツールの名前、バージョン、およびコマンド プレフィックスを出力します。これを既知の正常なスナップショットと比較し、ドリフトをキャッチします。

ホストによるツールの読み込み方法

uip <alias> … が実行されると、以下のようになります。

1. ホストは argv を読み取り、グローバルフラグ (--output、 --log-levelなど) を取り除き、最初の非フラグトークンを潜在的なツールエイリアスとして識別します。
2. エイリアスがインストールされたツールと一致する場合、ホストはそのツールをオンデマンドでロードし、サブコマンドの登録を要求します。
3. エイリアスがホワイトリストにあるが、ツールがインストールされていない場合、ホストは自動インストール(上記を参照)を実行してから、ステップ2に進みます。
4. エイリアスがホワイトリストになく、認識されたホスト コマンドでない場合、ホストは "unknown command" で失敗し、使用状況を出力します。

これがローディングモデル全体です。プラグインマニフェスト、レジストリ設定ファイル、ユーザーが編集できるリストはありません。ホストパッケージに組み込まれているホワイトリストが信頼できる情報源です。

次に読むもの

• UIPツールリファレンス — すべての uip tools サブコマンドの完全な構文と例。
• UiPath CLI をインストールする — ホストをインストールします。そこからツールが続きます。
• ツールの自動インストールの制御 — CI のオプトアウトなしの現実とインストール前の回避策。
• ツールとスキルの管理 — 日常のワークフロー (アップグレード、バージョンのピン留め、ドリフトの検査)。
• スキル — コーディングエージェントに uipの使い方を教えるための並列システム。スキルはツールではなく、 uip skills は別のコマンドグループです。
• バージョン管理と安定性 — ホストとツールのバージョンが SEMVER の下でどのように調整されるか。