UiPath と連携してエージェントをコーディングする

UiPath スキルを搭載したコーディング エージェントは、UiPath 全体のほとんどの運用タスク (フォルダー、ジョブ、キュー、アセット、監査ログ、コネクションなど) を自然言語での実行依頼を通じて推進できます。これは、ログインしているセッションに対して uip 実行され、指定するコンテキストによってスコープが設定されます。このページでは、何を求めるべきか、何を期待すべきか、そして境界線がどこにあるかについて説明します。

セットアップ (エージェントのインストール、ログイン、スキルのインストール) については、「 UiPath CLI をエージェントのコーディングと使用する」をご覧ください。

前提条件

1. エージェントに UiPath スキルがインストールされているエージェントごとのインストール コマンドについて詳しくは、「 UiPath CLI をコーディング エージェントとともに使用する 」をご覧ください。
2. ログイン中のセッション (uip login) です。
3. 操作する操作スコープのフォルダー アクセス — エージェントは権限を継承します。

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

各行は 1 つの Operate サブドメインをグループ化します。エージェントは、インストール済みのスキルから適切な uip orコマンド、 uip resourceコマンド、 uip solutionコマンド、または uip is コマンドを選択します。コマンドはユーザー側で、コマンドではなく結果を指定します。

領域	エージェントでできること	質問の例
フォルダーとアクセス	フォルダーのリスト表示、作成、入れ子、移動、削除ユーザーとロールを割り当て	Automation User として Finance に [e-mail] を追加してください
ユーザー、ロール、権限	ロールの付与の調査、ロールの作成/編集/削除、権限のリスト表示、誰が何にアクセスできるかの確認	どのフォルダーが [e-mail]何の役割にアクセスできるのか?」
ライセンス	ユーザーとロボット全体にわたる割り当てを検査します。	Unattended ランタイム ライセンスをさらに 2 つ prod-worker-01 に追加してください
マシンとランタイム	マシンのリスト、フォルダーで利用可能なランタイムの検査	現在、運用環境ではどのようなランタイムが利用可能ですか?
セッション	アクティブなロボット セッションのリストの表示、各セッションの確認、スタックしているセッションの切断	「運用環境で実行中のすべての無人セッションと、それらのアクティブな時間を表示する」
プロセスとパッケージ	パッケージのアップロード、バージョンのリストの取得、プロセス リリースの作成または更新パッケージ フィードを管理する	InvoiceBot のバージョン 2.3.0 を Finance にパブリッシュしてください
Solutions (ソリューション)	パブリッシュ、アップロード、デプロイ、アクティブ化テナントとフォルダー全体にわたるデプロイ済みバージョンのリスト表示	請求書処理ソリューションの v1.4 をステージング テナントの Accounting にデプロイしてください
ジョブ	開始、停止、監視、実行ログと添付ファイルの取得、ステートによるグループ化	「昨日までに発生したすべてのエラー ジョブを運用環境に一覧表示し、そのエラー メッセージを表示してください」
アセット	複数のフォルダーにわたるアセットのリスト表示、取得、作成、更新、削除	「フォルダー A からフォルダー B にすべてのアセットをコピーする」
資格情報ストア	Vault インテグレーションのリスト表示、作成、更新、削除参照される資格情報をローテーションする	「運用環境のどのアセットが、まだ古い CyberArk ストアを参照していますか?」
キューとキュー アイテム	キューの深さの検査、アイテムのプッシュ、ステータスの一括更新	「現在、NewItem が 100 個を超えるキューはどれですか?」
ストレージ バケットとファイル	バケットの作成、ファイルのアップロード、ダウンロード、一覧表示、削除	「バケット レポートからすべてのファイルをダウンロードしてください。過去 7 日間に変更されました。」
ライブラリ	パブリッシュ、バージョンのリスト表示、リリースの管理	テナント フィードの Email.Utilities ライブラリのすべてのバージョンを表示してください
トリガー	タイム トリガー、キュー トリガー、イベント トリガーを作成するカレンダーを管理するリストの実行。履歴を検査	「人事オンボーディング ソリューションのトリガーの過去 10 回の実行を表示する」
Webhook	作成、一覧、テスト	「すべてのアクティブな Webhook と、それらがリッスンするイベントを一覧表示してください」
Integration Service のコネクション	OAuth トークンの一覧表示、テスト、更新、トラブルシューティング接続の健全性を確認する	「本番環境のすべての Salesforce 接続をテストして、失敗している接続を報告してください」
監査ログ	ユーザー、コンポーネント、アクション、日付範囲によるフィルター	「先月、Finance フォルダーを削除したのは誰ですか?」

読み取りと書き込み

エージェントは、運用操作を次の 2 つの層で扱います。

• 読み取り操作 — list、 get、 logs、 audit-logs など。エージェントは、独自の判断でこれらを実行します。
• 書き込み操作 — 作成、更新、削除するものすべて。エージェントは、実行する前にユーザーに確認する必要があります。

質問が複雑な場合は、期待を前もって述べてください。例: 「未使用のプロセス パッケージをクリーンアップします。ただし、最初にリストを表示する」

認可と範囲

エージェントはログインしている uip セッションとして機能し、ユーザーの権限を正確に継承します。UiPath UI で自分のアカウントで何かできる操作があれば、エージェントはそれを行うことができます。自分もできないのであれば、エージェントもできません。

エージェントはフォルダー コンテキストも考慮します。操作スコープは、「すべてのフォルダーに」などと指示しない限り、特定のフォルダーにスコープを設定します。会話の途中でフォルダーを変更した場合は、スコープを言い直してください。

サービス ID の作業 (CI/CD、スケジュールされた監査) の場合は、外部アプリ セッションに対してエージェントを実行します ( 「認証」のフロー 2 を参照)。

一般的な複数ステップのパターン

これらは、コーディングエージェントが最も時間を節約するパターンです — 複数ステップの要求は、そうでなければ複数のCLI呼び出しを手動でチェーンすることを意味します。

失敗したジョブをトリアージする

「過去24時間から本番環境で発生したすべてのジョブをトリアージします。エラー メッセージでグループ化し、根本原因の上位 5 つを表示します。

エージェントは、ステートと時間でフィルター処理されたジョブを一覧表示し、それぞれのログをフェッチし、エラー署名でグループ化して、ランク付けされた概要を表示します。次に、どちらをリトライするかを決定します。

テナント間で昇格する

請求書処理ソリューションを開発テナントからステージング テナントに昇格させてください。これを Accounting フォルダーの下にデプロイします。

エージェントは開発テナントからソリューションをプルし、セッションをステージング テナントに切り替えて、Accounting フォルダーにデプロイします。動作する前に、各テナントの切り替えを確認します。

ユーザーをフォルダーに割り当てる

[e-mail] の割り当てAutomation User として Accounting フォルダーに追加し、VM マシンも割り当てます。

エージェントは、ユーザーを Automation User ロールを持つフォルダーに割り当ててから、仮想マシンを同じフォルダーに割り当てて、ユーザーがその仮想マシンに対して無人ジョブを実行できるようにします。

監査ロールの付与

「外部ユーザー(ドメイン外の@を持つユーザー)に割り当てられたすべてのロールを監査し、編集できるフォルダを報告してください。」

エージェントは、ユーザーを一覧表示し、ドメインでフィルタリングし、各ユーザーのロール付与をフォルダーごとに展開し、構造化されたレポートを表示します。

参照

• UiPath CLI をコーディング エージェントと使用する — エージェントの設定とスキルのインストール。
• スキル — この動作を促進するスキル モデルです。
• 認証 — 外部Appsを含むセッション フロー。
• UIP または参照 — フォルダー、ユーザー、ロール、ライセンス、ジョブ、マシン、セッション、監査ログ、資格情報ストア
• UIP Resource Reference — アセット、キュー、バケット、ライブラリ、トリガー、Webhook
• UIP ソリューション リファレンス — パッケージ化、パブリッシュ、デプロイ、アクティブ化
• uip は参照です — Integration Service のコネクション、コネクタ、アクティビティ