環境の設定

UiPath CLI をインストールして UiPath Cloud アカウントにログインし、コーディング エージェントに UiPath のスキルを設定して、UiPath VS Code 拡張機能をインストールします。

概要

この開発者ガイドのチュートリアルでは、以下を組み合わせて使用しています。

• UiPath Automation Cloud
• UiPath コマンド ライン インターフェイス (CLI)
• UiPath CLI ツール (プラグイン)
• Visual Studio Code または Open VSX レジストリ用の UiPath Maestro 拡張機能
• エージェントをコーディングするための UiPath スキル

このページには、上記のリストに必要なインストール手順と、インストールが正常に完了していることを確認するための検証手順がまとめられています。

手順 1 - UiPath CLI とツールをインストールする

UiPath CLI (uip) は、UiPath の認証、プロジェクトのスキャフォールディング、デプロイを行うためのクロスプラットフォーム ツールです。プラグイン システムを使用します。ベースの CLI が認証を処理し、ビルドするプロジェクトの種類のツールをインストールします。初回使用時に自動的にインストールされるツールの 許可リスト をご覧ください。各チュートリアルには、手動でインストールする必要があるユーザー向けの手順が含まれています。

1. ベース CLI をグローバルにインストールします。

   npm install -g @uipath/cli
   

2. インストールを確認します。

   uip --version
   

   1.200.0以降が表示されます。

3. インストールされているツールを確認します。

   uip tools list
   

   ツールのリストと、そのバージョンがインストールされていることを確認します。

   {
      "Result": "Success",
      "Code": "ToolList",
      "Data": [
         {
            "Name": "solution-tool",
            "Version": "1.200.0",
            "Description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
            "CommandPrefix": "solution"
         },
         {
            "Name": "agent-tool",
            "Version": "1.200.0",
            "Description": "cli plugin for creating and managing UiPath low-code agents",
            "CommandPrefix": "agent"
         },
         {
            "Name": "codedagent-tool",
            "Version": "1.200.0",
            "Description": "Build, run, deploy, and manage AI Agents.",
            "CommandPrefix": "codedagent"
         },
         {
            "Name": "rpa-tool",
            "Version": "1.200.1",
            "Description": "Tool for creating and managing UiPath RPA projects",
            "CommandPrefix": "rpa"
         },
         {
            "Name": "maestro-tool",
            "Version": "1.200.0",
            "Description": "Create, debug, and run Maestro projects and jobs.",
            "CommandPrefix": "maestro"
         }
      ]
   }
   

手順 2 - コーディング エージェントに UiPath スキルをインストールする (任意)

CLI とともにコーディング エージェント (Claude Code、Cursor、Copilot、Gemini、または Codex) を使用している場合は、UiPath スキルをインストールすることで、エージェント プロジェクトの構造、CLI コマンド、ベスト プラクティスに関する知識を得られます。コマンドを実行して任意のコーディング エージェントのスキルをインストールする前に、まずそのスキルがインストールされていることを確認してください。以下の例では、Claude Code のスキルをインストールします。

uip skills install --agent claude

別のエージェントを使用している場合は、 claude をエージェントに置き換えてください。uip skills install --help を実行して、サポートされているコーディング エージェントのリストの [--agent <agent>] オプションを確認できます。

スキルはホームディレクトリ (~/.uipath/.skills/) にグローバルにインストールされ、今後はすべてのプロジェクトで使用できます。

手順 3 - UiPath Maestro VS Code 拡張機能をインストールする (任意)

Maestro Flow、BPMN ダイアグラム、ケース プランを構築するチュートリアルでは、この拡張機能を使用して、これらのファイルを生のテキストとしてではなくビジュアル キャンバスで開きます。また、テナントにサインインし、ローカル ワークスペースからパッケージ化やデプロイも行います。

1. VS Code Marketplace または Open VSX レジストリ から UiPath Maestro をインストールします。

   拡張機能には、VS Code 1.110.0 以降が必要です。Code > の「Visual Studio Code について」でバージョンを確認するか、code --versionを実行します。

2. プロンプトが表示されたら、VS Code を再読み込みします。

3. アクティビティ バーの [ UiPath ] アイコンを選択して、[UiPath] ビューを開きます。

4. [ 接続 ] セクションで [ サインイン] を選択します。

5. 開いたブラウザー ウィンドウでサインインを完了します。

   CLI がまだインストールされていない場合は、プロンプトを受け入れると、拡張機能によって npm を使用してインストールされます。サインインでは、ポート 8104でコールバックを持つ OAuth ブラウザー フローを使用しますlocalhost。作成に失敗した場合は、古いプロセスがそのポートを保持している可能性があります。

6. UiPath を実行する: コマンド パレットから [環境] を選択し (Ctrl/Cmd+Shift+P環境) し、環境を確認します。既定値は Cloud です。

7. UiPath を実行します。[テナント] を選択し、構築するテナントを選択します。

拡張機能の [ リソース] セクションに、そのテナントのフォルダーと Orchestrator リソースが表示されます。

拡張機能は、CLI の独自のコピーを管理します。インストールするバージョンは、手順 1 でインストールしたバージョンと一致する必要はありません。サインイン後に uip --version を実行し、元に戻すと現在のリリース npm install -g @uipath/cli に戻ります。

ヒント:

リモートワークスペースで作業していますか?Linux (WSL)、Secure Shell (SSH)、Codespaces、および開発コンテナー ワークスペース用の Windows サブシステムでは、拡張機能はリモート ホストで実行されるため、UiPath CLI はローカル マシンではなくリモート ホストにインストールする必要があります。

手順 4 - UiPath への認証

CLI をインストールしたら、以下の手順を使用して CLI を認証し、使用するテナントを選択します。

1. UiPath アカウントに対して CLI を認証します。

   uip login
   

   ブラウザー ウィンドウが開き、そこでサインインしてテナントを選択します。完了すると、ターミナルはログインを確認します。

2. 以下を実行して、ログイン ステータスを確認する "Status": "Logged in" が表示されていることを確認し、ログイン ステータスを確認します。

   uip login status
   

これで、チュートリアルを実行する準備は整いました。