コーディング エージェントを使用したローコード エージェントの構築

初回ログイン後にブラウザーを使用せずに、コーディング エージェントやターミナルから UiPath ローコード エージェントを完全にスキャフォールディング、設定、評価、パブリッシュします。

UiPath のスキルがインストールされたコーディング エージェントは、UiPath のローコード エージェントをターミナルから完全に構築、設定、検証、パブリッシュできます。初回ログイン時にブラウザーを使用する必要はありません。構築するエージェントを説明すると、コーディング エージェントがプロジェクト ファイルを作成して反復処理し、結果を Studio Web にアップロードします。

セットアップ (エージェントのインストール、ログイン、スキルのインストール) については、「 インストールとセットアップ」をご覧ください。

前提条件

• コーディング エージェントにインストールされている uipath-agents スキル。詳しくは、「 インストールとセットアップ」をご覧ください。
• ログイン中のセッション (uip login) です。

エージェントでできること

各行は、エージェントのライフサイクルの 1 つの段階に対応しています。コーディング エージェントは、インストールされたスキルから適切なコマンド uip agent を選択します。コマンドではなく結果を指定します。

領域	エージェントでできること	質問の例
足場	agent.json、入力/出力スキーマ、既定の評価セットを含む完全なディレクトリ構造を使用して、新しいエージェント プロジェクトを作成します	「ソーシャル メディアの受信コメント用に新しい感情分析エージェントを作成してください」
プロンプトとスキーマを設定する	システム プロンプト、ユーザー メッセージ テンプレート、入力/出力スキーマ、LLM モデルの設定を編集します。 agent.json	「請求書データを処理できるようにシステム プロンプトを更新し、出力スキーマに信頼度フィールドを追加してください。」
ツールを追加および管理します。	RPA プロセス、他のエージェント、API ワークフロー、Maestro フロー、Integration Service コネクタ ツール、コンテキスト グラウンディング、エスカレーション アプリを追加します	「ドキュメント検証用に SharePoint 検索ツールと RPA プロセスを追加してください」
更新して検証	uip agent refreshを実行して成果物を書き込んでエントリ ポイントのスキーマを同期してから、uip agent validateを実行して JSON 構造 (読み取り専用) を確認します。エラーを自動的に修正する	「エージェントを検証し、エラーを修正してください。」
アップロードとダウンロード	ローカル プロジェクトを Studio Web にアップロードするか (uip solution upload)、既存の Studio Web ソリューションをダウンロードしてローカルで編集します (uip solution download)	「エージェントを Studio Web にアップロードして、確認できるようにしてください。」
評価	評価セットとテスト ケースを作成し、エージェントのランタイムに対して実行し、スコアと実行トレースを確認する	「回帰評価セットを実行して、スコアが 0.7 を下回るテスト ケースを示してください。」
梱包してデプロイする	uip solution pack と uip solution publishを使用してソリューションをパッケージ化してパブリッシュし、プロセスとしてデプロイして、ジョブを開始します	「請求書エージェントを運用フォルダーにデプロイしてください。」

ビルド ループ

コーディング エージェントは、ローコード エージェントを構築または反復処理する際に、次のサイクルに従います。

スキャフォールド > リソースの設定>追加 > 更新>検証>修正>アップロード

1. スキャフォールディング — uip solution initを使用してソリューションを作成し、 を使用してエージェントを uip agent initフォールディングします。

2. 設定 — agent.jsonでプロンプト、スキーマ、モデルの設定を行います。

3. リソースを追加 — エージェントが必要とするツールごとに resources/<tool-name>/ の下にresource.json ファイルを作成します。

4. 更新 — 成果物を書き込み、エントリ ポイントのスキーマを uip agent refreshと同期します。

5. 検証 — JSON 構造を uip agent validate (読み取り専用) で確認します。

6. 修正 — 検証エラーを修正してから、[更新] にループ バックします。複数のサイクルが予想され、正常です。

7. アップロード — プロジェクトがクリーンになったら、 を使用して Studio Web にアップロード uip solution upload。

結果: これで、エージェント プロジェクトが Studio Web に表示され、確認、評価、デプロイできるようになります。

エージェント プロジェクトの構造

コーディング エージェントが uip solution init と uip agent initを実行すると、次のような構造が作成されます。

<AgentName>/
├── agent.json               # System prompt, user message template, LLM settings, input/output schemas
├── project.json             # Project metadata
├── entry-points.json        # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json         # Resource binding references
├── SolutionStorage.json     # Written after push — captures the Studio Web solution ID
│
├── resources/               # One directory per tool
│   └── <tool-name>/
│       └── resource.json    # Tool config: type, connector key, schema, connection ID
│
├── connections/             # Connection references for bound Integration Service tools
│
├── evals/                   # Evaluation configuration
│   ├── evaluators/          # Evaluator definitions (semantic similarity, trajectory by default)
│   └── eval-sets/           # Test case collections
│
└── userProfile/
    └── debug_overwrites.json  # Local connection overrides for debugging

ツールの種類

コーディング エージェントは、resources/<tool-name>/の下にresource.jsonファイルを直接作成することによって、ツールの種類を登録します。各ファイルの type フィールドによって、ツールの種類が決まります。ランタイム実行のサポートはさまざまです。一部の種類は、Studio Web の相互運用性のために登録することはできますが、エージェントのランタイムではまだ実行されません。

ツールの種類	resource.json type	エージェントの実行時に実行
Integration Service のコネクタ	integration	はい
Orchestrator のプロセス (RPA)	process	あり (非対話型)
サブエージェント	agent	はい
API ワークフロー	api	登録のみ
Maestro Flow	processOrchestration	登録のみ
IXP (ドキュメント処理)	ixp	登録のみ

コンテキスト グラウンディング、エスカレーション アプリ、MCP サーバーは、ツールタイプの resource.json ファイルではなく、個別のソリューション リソースとして追加されます。コーディング エージェントがそれらを作成し、 uip solution resources refreshを使用してプロジェクトに同期します。

ビルド例

コーディング エージェントを開き、目的のエージェントの説明を入力します。エージェントが UiPath Agents のスキルを読み込んで、残りを処理します。

何を尋ねるか	構築されるもの
「ソーシャル メディアの受信コメント用に新しい感情分析エージェントを作成してください」	カスタムのシステム プロンプトと構造化された入力/出力スキーマを持つスタンドアロン エージェント
「受信コメントのバッチを処理するよう感情分析エージェントに委任するソーシャル メディア マネージャー エージェントを追加してください」	感情分析エージェントをツールとして使用するマネージャー エージェントを含むマルチエージェント ソリューション
「AI エージェントを使用して、プロフェッショナルなメールの下書きを作成するためのフローを構築してください。」	インラインのエージェント ノードが開始ノードと終了ノードに接続されたフロー プロジェクト

エージェントを評価する

コーディング エージェントは、完全な構築-評価-改善ループを駆動できます。

1. エージェントをローカルで構築して設定します。
2. Studio Web にアップロード (uip solution upload) — 評価はエージェントのランタイムに対して実行され、最初にプロジェクトをアップロードする必要があります。
3. 評価セットを実行し、結果を待ちます。
4. テスト ケースごとのスコア、実行トレース、失敗メッセージを確認します。
5. 失敗に基づいてプロンプトや設定を調整します。
6. 更新したエージェントをアップロードします (uip solution upload)。
7. 評価セットを再実行します。

結果: 評価の実行は正常に完了し、各テスト ケースのスコアが表示され、どのケースが成功または失敗したかが明確に示されます。

例では次のように質問されます。

• 「請求書の主な入力シナリオをカバーする 5 つのテスト ケースを含む、回帰テストという評価セットを作成してください」
• 「回帰テストの評価セットを実行して、結果を表示します。」
• 「3 番目のテスト ケースは軌跡スコアが低く失敗しました。システム プロンプトを更新してツールの選択をより明確にしてから、再実行してください。」

次の種類の評価器を使用できます。

評価器	評価項目
Semantic similarity (意味的類似性)	期待される出力と実際の出力を意味的に比較する
軌跡	エージェントが予期されるツールの使用法と推論の手順に従ったかどうかを確認します
コンテキストの精度	スコア: 取得したコンテキストとクエリの関連性
忠実度	エージェントの応答が、指定したコンテキストに基づいているかどうかをスコアリングします

参照

• Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
• インストールとセットアップ — エージェントの設定とスキルをインストールします。
• コーディング エージェントを使用してコード化されたエージェントを構築する — コーディング エージェント端末からの Python ベースのコード化されたエージェントです。
• スキルの概要 — この動作を促進するスキル モデルです。
• UIP エージェント リファレンス — エージェントのライフサイクル、ツール、評価、プッシュ、プル、デプロイに関する完全なコマンド リファレンスです。