Robot のポリシーの設定

Automation Ops の Robot ガバナンス ポリシーの設定です (ランタイム アナライザーのルール、ブロックするメール リスト、Healing Agent、UI Automation の設定など)。

ランタイム アナライザー

ランタイム アナライザー ルールは、ロボットがプロセスを実行する際にそのプロセスが組織のポリシーに準拠していることを確認し、プロセスの実行中にベスト プラクティスを適用できるようにします。これにより、ロボットが組織外にメールを送信したり、自動化すべきでないアプリや Web ページを自動化したりするのを防ぐことができます。

ランタイム ルールはアクティビティ パッケージに含まれており、それらのパッケージ内の特定のアクティビティに適用されます。設定されているランタイム ルールはロボットによって取得され、対象のアクティビティが実行される際に各ルールが検証されます。

[ ランタイム アナライザー ] タブでは、有効化するランタイム ルールを選択したり、ルール アクションやルール パラメーターを設定したりできます。このルールは、 ワークフロー アナライザー ルールを設定する方法と同様に設定されます。

Automation Ops™ には、以下の既定のランタイム ルールが付属しています。

• RT-UIA-001 (アプリ/URL の制限) - UI Automation アクティビティ パッケージ内のアクティビティで許可/ブロックされているアプリケーションまたは URL のリストを定義できます。
• RT-OUT-001 (ブロックするメール アドレス リスト) - GSuite、Mail、Office 365 アクティビティ パッケージのアクティビティでメールを送信できないアドレスを定義できます。

ルールは既定で有効化されていますが、パラメーターは定義されていません。アクションは Error に設定されています。つまり、ルール違反が検出されると、エラーがスローされて実行が停止します。

ランタイム ガバナンスを有効化する

ランタイム ガバナンスは既定では有効化されていません。Automation Ops™ のページの上部に、この機能が無効化されたことを示すバナーが表示されます。バナーで [ 有効化 ] を選択してランタイム アナライザーを有効化します。

以下の API 要求を使用して、ランタイム ガバナンスを有効化/無効化することもできます。

POST "{AutomationCloudURL}/{organizationName}/roboticsops_/api/Product/Robot/enable" -H "Authorization: Bearer <your-access-token>"

POST "{AutomationCloudURL}/{organizationName}/roboticsops_/api/Product/Robot/disable"``-H "Authorization: Bearer <your-access-token>"

ブラウザーの開発者ツールからトークンを取得できます。Google Chrome で、次の手順を実行します。

1. Automation Ops™ のページから [ 開発者ツール ] を開き、[ アプリケーション] を選択します。
2. [ストレージ] で [ローカル ストレージ] を選択してから、アプリケーション (cloud.uipath.com など) を選択します。
3. トークン キーを見つけて、その値をコピーします。

RT-UIA-001 - アプリ/URL の制限

このルールは、制限されたアプリケーションまたは Web ページがプロジェクトで使用されているかどうかを確認します。利用可能なパラメーターを使用し、許可またはブロックされているアプリケーションおよび URL のリストを定義して、制限を設定します。ルールではローカル アプリケーションとリモート アプリケーション (RDP 接続で自動化されたアプリケーションなど) の両方がチェックされます。

注:

このルールは UiPath.UIAutomation.Activities v21.10.3 以降で使用できます。

許可されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• whitelistApps - このリストにあるアプリケーションに対してのみ、実行が許可されます。
• whitelistUrls - このリストにある URL に対してのみ、実行が許可されます。

禁止されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• blacklistApps - このリストにないすべてのアプリケーションに対して、実行が許可されます。
• blacklistUrls - このリストにないすべての URL に対して、実行が許可されます。

同じスコープ (アプリケーションまたは URL) に対して禁止されているリストと許可されているリストの両方が設定されている場合、許可されているリストが優先されます。

CustomMessage パラメーターを使用すると、ランタイム ガバナンス ルールがトリガーされたときにカスタム メッセージをユーザーに表示できます。このパラメーターの既定値は、 UI Automation が '{0}' で検出されました。これは、組織で定義されている許可されたアプリケーション/URL ではありません。

制限を設定する

URL/アプリケーション名のリストをコンマ (,) またはセミコロン (;) で区切って指定します。複数の項目を指定すると、そのすべてが検証されます。

ワイルドカード文字 * と ? を使用してパターンを定義できます。例:

• *uipath*.exe - uipath で始まる名前のすべての実行可能ファイルをブロックします。
• *www.uipath*.com - 使用されているプロトコルに関係なく、uipath で始まるすべての URL をブロックします。

ルールが検証する項目

モダン アクティビティとクラシック アクティビティのどちらについても、このルールは実行時に、定義済みのセレクターや入力 UI 要素を使用して検出された各ターゲット UI 要素を検証します。

注:

パフォーマンスへの影響を回避するため、[ クリック トリガー ] や [キー押下トリガー ] などの UI 自動化関連のトリガーでは検証は実行されません。チェックは、基になるワークフロー アクティビティによって実行されます。

RT-OUT-001 - ブロックするメール アドレス リスト

このルールは、メール、Microsoft 365、および Google Worskpace パッケージに含まれる、メールの送信、返信、転送、通知の送信、イベントの作成、予定表の招待の送信を行うすべてのアクティビティを確認し、ブロックするメール リストに追加された受信者にメールが送信されないことを確認します。

注:

このルールは、以下のパッケージ バージョン以降で使用できます。

• UiPath.GSuite.Activities v1.11.3
• UiPath.Mail.Activities v1.12.2
• UiPath.Office365.Activities v1.11.1

制限を設定する

EmailRegex パラメーターを使用して、許可されないメール アドレスのパターンを正規表現で指定します。

例:

• .*@uipath.com - uipath.com ドメインのアドレスに送信されるすべてのメールをブロックします。
• .*@(?!uipath\.com$) - uipath.com ドメインのアドレスに送信されるメール以外のすべてのメールをブロックします。

カスタム エラー メッセージ

CustomMessage パラメーターを使用して、[RT-OUT-001 - ブロックするメール アドレス リスト] ルールをトリガーしたときに表示されるエラー メッセージをカスタマイズします。長さの制限は 2000 文字に設定されています。

[ 既定値を使用 ] パラメーターは既定で有効化されています。カスタム メッセージを使用するには無効化します。

ルールが検証する項目

このルールは、メールを送信できる以下のアクティビティで、メールの受信者を示すすべてのプロパティを検証します。

• Mail パッケージ:
  • [連携] カテゴリ (StudioX) のアクティビティ - [メールを送信]、[メールを転送]、[メールに返信]、[カレンダー/予定表の招待を送信]
    注:

    このルールは、アクティビティがメッセージを送信するのではなく下書きとして保存する場合には適用されません。

  • [アプリの連携] カテゴリのアクティビティ - [Exchange メール メッセージを送信]、[IBM Notes メール メッセージを送信]、[Outlook メール メッセージを送信]、[Outlook メール メッセージに返信]
• Google Workspace パッケージ - メール メッセージを送信、イベントを作成、参加者を追加、ファイルを共有、イベントを削除、イベント/予定を変更
• Microsoft 365 パッケージ - メールを送信、メールに返信、メールを転送、出席者を追加、ファイル/フォルダーを共有

Healing Agent ランタイム ガバナンス

ヒーリングエージェントのランタイムガバナンスは、組織管理者がエージェントのランタイム機能を制御するのに役立ちます。

次の値を設定できます。

• 修正の推奨事項を許可 — UI Automation のエラーが発生したときに、Healing Agent で推奨の修復手順を生成できるようにします。無効にすると、実行時に Healing Agent の機能がすべて無効になり、他のガバナンス オプションに影響します。
• 自己修復を許可 — [推奨の推奨事項を許可] オプションが有効な場合にのみ使用できます。Healing Agent が生成した推奨手段を使用して自律的に自己修復することを Healing Agent に許可するかどうかを指定します。無効にすると、実行時に自己修復は試行されません。
• スクリーンショットの保存を許可 — [推奨の修正事項を許可] オプションを有効にしている場合にのみ使用できます。Healing Agent がその実行中にスクリーンショットをキャプチャできるかどうかを指定します。
• Healing Agent のアプリ/URL の制限 — 対象のアプリケーションおよび URL を操作しているときにエージェントの動作を制御します。推奨の修復方法の提供を許可または制限するアプリまたは URL を指定します。
• ポップアップ制御の制限 — 予期しないポップアップを操作するときにエージェントの動作を制御します。たとえば、セキュリティのポップアップが Healing Agent によって閉じられないようにします。

これらの設定は Orchestrator プロセスのオプションを制御するものではなく、実行時にのみ適用されます。

ランタイム アナライザーのルールと異なり、Healing Agent のルールではエラーがスローされず、実行が停止することはありません。ルールのアクションは、ロボット ログに書き込まれるメッセージの重要度を設定するだけで、Healing Agent はルールで制限されているアクションを停止します。

注:

ロボット ログは、Orchestrator によって有効化されたヒーリング エージェント機能がランタイム ガバナンスによって無効化されるたびに更新されます。

HA-UIA-001 - アプリケーション/URL の制限

このルールは、ヒーリングエージェントがプロジェクトで使用される特定のアプリケーションやWebページとの対話を制限されているかどうかを確認します。制限を設定するには、使用可能なパラメーターを使用して、許可または禁止するアプリケーションおよび URL のリストを定義します。このルールは、ローカルとリモートの両方のアプリケーション (RDP 接続で自動化されるアプリケーションなど) をチェックします。

注:

このルールは、[推奨の修正事項を許可] を有効化し、UiPath.UIAutomation.Activities v25.10 を使用している場合にのみ適用されます。

レコメンデーションの発行や自己修復のためにヒーリングエージェントが操作できるアプリケーションまたはURLを定義するには、次のパラメータを使用します。

• allowedApps - 実行は、このリストにあるアプリケーションに対してのみ許可されます。
• allowedUrls—実行は、このリストにある URL に対してのみ許可されます。

禁止されているアプリケーションまたは URL を定義するには、次のパラメーターを使用します。

• forbiddenApps - このリストにあるすべてのアプリケーションの実行が禁止されています。
• forbiddenUrls:このリストにあるすべての URL に対して実行が禁止されます。

同じスコープ (アプリケーションまたは URL) に対して禁止されているリストと許可されているリストの両方が設定されている場合、許可されているリストが優先されます。

制限を設定する

制限を設定するには、URL/アプリケーション名をコンマ (,) またはセミコロン (;)) で区切ったリストを指定します。複数の項目を指定した場合は、すべて検証します。***** と ?ワイルドカード文字を使用してパターンを定義します。

例:

• *uipath*.exe - uipath で始まる名前の実行可能ファイルをすべてブロックします。
• *www.uipath*.com - 使用されているプロトコルに関係なく、uipath で始まるすべての URL をブロックします。

ルールが検証する項目

モダン アクティビティの場合、ルールは実行時に、ヒーリング エージェントと定義されたアプリケーションとの対話が許可されているかどうかを検証します。これは、レコメンデーションと自己修復オプションの両方に当てはまります。

HA-UIA-002 - ポップアップを閉じるの制限

このルールは、ヒーリング エージェントが、予期せず表示され、オートメーションをブロックする可能性のある定義済みのポップアップやウィンドウを閉じないように制限されているかどうかを確認します。

注:

このルールは、[推奨の修正事項を許可] を有効化し、UiPath.UIAutomation.Activities v25.10 を使用している場合にのみ適用されます。

ポップアップ リストを定義するには、次のパラメーターを使用します。

• forbiddenPopups - 自然言語を使用して、エージェントが操作を禁止されているポップアップまたはウィンドウを表します。例えば：
  • セキュリティ アラート
  • 不審なアクティビティの検出
  • [許可]、[このまま続行]、[ブロック] などのボタンのあるアラート。
• 制限の構成 - 自然言語を使用して、ポップアップの説明のリストをコンマ (,) またはセミコロン (;)) で区切って指定します。複数の項目を指定した場合は、すべて検証します。

ルールが検証する項目

モダン アクティビティの場合、ルールは実行時に、ヒーリング エージェントが記述されたポップアップの種類との対話を許可されているかどうかを検証します。これは、レコメンデーションと自己修復オプションの両方に当てはまります。

このルールは、自己修復機能が無効化されている場合を含め、Healing Agent に失敗の分析が許可されているたびに評価されます。ポップアップがリストに一致しても、Healing Agent はポップアップを閉じず、ルール メッセージがロボット ログに記録されます。

ポップアップの説明との比較は、モデルによって実行されます。その呼び出しを実行できない場合、ポップアップは一致しません。ポップアップ リストが設定されている間は、Healing Agent はポップアップを閉じません。

ランタイム ルールを設定する

既定のルールそれぞれに、以下のオプションを設定できます。

• 有効化 - ルールを有効化するには、このオプションを選択します。
• アクション - ルールのアクションを設定します。Error、Warning、Info、または Verbose のいずれかです。既定のアクションは Error です。
• パラメーター - パラメーターを編集するには、その横にある [ 編集 ] を選択し、[ 既定値を使用 ] オプションの選択を解除して、[ 値 ] ボックスで制限を設定します。

UI Automation

[ UI Automation] タブでは、実行時の UI Automation アクティビティ パッケージの動作を制御します。実行トレースがロボット端末に保持される期間と、 ScreenPlay が指示に追加するプロンプトを定義します。

このタブでは、次のように設定がグループ化されます。

• 全般 - UI Automation とドライバーのトレースの保持期間
• ScreenPlay - ScreenPlay のトレースと、ScreenPlay の実行で使用されるプロンプトのトレースの保持期間です。
• Computer Vision - Computer Vision のトレースの保持期間

これらの設定は、実行時にのみ適用されます。設計時の Studio には影響しません。

トレースの保持

トレースの保持期間の設定では、その種類のトレースがロボット端末に保持され、削除されるまでの日数を定義します。クリーンアップは、ロボット プロセス内の UI Automation の初期化時に開始され、最大で 1 日に 1 回実行されます。

設定	トレースの削除
全般的 な> トレースの保持	UI Automation とドライバーのトレース ファイル
ScreenPlay > トレースの保持	ScreenPlay のトレース フォルダー (そのサブフォルダーを含む)。
Computer Vision > トレースの保持	Computer Vision のトレース ファイル (表のスクロール トレースやテキストのスクロール トレースを含む)。

次の値がサポートされています。

• 正の日数 - その日数より古いトレースが削除されます。
• 0 - トレースは無期限に保持され、クリーンアップは実行されません。

この 3 つの設定にはそれぞれ、[ トレース ファイルの保持期間 (日)] という名前の、Studio のプロジェクト レベルでの設定があります。

Robot のポリシー設定	Studio のプロジェクト設定
全般的 な> トレースの保持	UI Automation モダン > 汎用
ScreenPlay > トレースの保持	UI Automation モダン > ScreenPlay
Computer Vision > トレースの保持	Computer Vision > ロボット ログ

ポリシー値は、プロジェクト設定を上書きします。ポリシーで値が定義されていない場合は、プロジェクト設定が適用され、既定値は 7 日です。

ScreenPlay のプロンプト

ScreenPlay のプロンプトの設定: ロボットによって実行される ScreenPlay の実行に指示を追加します。[ ScreenPlay ] アクティビティで設定したプロンプトを拡張し、置換しません。

設定	説明
ベース プロンプト	スコープ内のアプリケーションや Web ページに関係なく、すべての ScreenPlay の実行に指示が追加されます。
アプリケーションのカスタム プロンプト	対象のアプリケーションが構成されているアプリケーション名のいずれかと一致する場合に追加される指示です。
URL のカスタム プロンプト	対象の Web ページが設定された URL のいずれかと一致する場合に追加される指示。ブラウザーのターゲットにのみ適用されます。

カスタム プロンプトを設定する

カスタム プロンプト ルールは、アプリケーションまたは URL のリストと、それらに適用されるプロンプト テキストを組み合わせます。同じルール内の項目は、コンマ (,)、セミコロン (;)、または改行で区切られます。一致では大文字と小文字が区別されません。

ルールは、設定された順に評価されます。現在のターゲットのアプリケーション名または URL は、最初に部分文字列として各エントリと比較されます。一致するエントリがない場合、各エントリはパターンとして再度評価され、 * ワイルドカード文字と ? ワイルドカード文字がサポートされます。

最初に一致するルールが適用されます。ScreenPlay の実行に適用されるアプリケーション プロンプトは最大 1 つと URL プロンプトは 1 つです。

プロンプトの組み合わせ方法

アプリケーション プロンプトと URL プロンプトが両方とも一致する場合、ベース プロンプトとともに ScreenPlay の指示に追加されます。プロンプトは互いに上書きされず、どのプロンプトも他より優先されません。

例

設定	アプリケーションまたは URL	プロンプト
ベース プロンプト	該当なし	何かを削除する前に確認を求めてください。
アプリケーションのカスタム プロンプト	excel.exe, outlook.exe	既存の行は変更せず、新しいエントリのみを追加します。
URL のカスタム プロンプト	*.internal.contoso.com	内部サイトでの Cookie バナーは絶対に受け入れないでください。

この設定では、アプリケーション プロンプトとベース プロンプトを受信 excel.exe を対象とする ScreenPlay の実行が実行されます。ブラウザーの https://crm.internal.contoso.com/orders を対象とする実行は、URL プロンプトとベース プロンプトを受信します。どちらの場合も、[ ScreenPlay] アクティビティで設定したプロンプトは変更されずに送信されます。