セマンティック アクティビティ

セマンティック アクティビティはフォームの操作専用に設計されており、直接的で強力なメソッドでデータ抽出とデータ入力を行うことができます。

これらのアクティビティでは、ユーザーは柔軟なアプローチを利用できる一方で、複雑な詳細部分は以下のような UiPath の AI と高度な内部コンポーネントによって処理されます。

• AI を活用した DOM 抽出エンジン: フォーム内で使用可能なすべての UI 要素を抽出します。
• セマンティック マッチング エンジン: テキスト ラベルを意味的に一致させることによってオートメーションの回復性を高め、UI の変更に対する安定性を確保します。
• セマンティック ターゲットおよび実行エンジン: 従来のセレクターベースの方式の課題を解消します。セレクターの使用時に起こりがちな複雑さや回復性の問題なしに、シームレスなターゲット設定と実行を可能にします。

このセクションには、次のアクティビティが含まれています。

• ポップアップを閉じる
• フォーム データを抽出
• フォームに入力
• UI 要素を更新 (以前の名称は [値を設定])

言語サポート

現在、英語のみがサポートされています。他の言語についても、サポートされるようになり次第、すぐにお知らせします。

AI ユニットの消費

Each Semantic activity consumes 0.5 AI units per request.

Each request made to Extract Form Data, Fill Form, and Set Value consumes 0.5 AI units by default.

The Close Popup activity consumes 0.5 AI units per request only when the AI-Enhanced mode toggle button is enabled. In this case, each close action via AI consumes 0.5 AI units. When the toggle button is disabled, the activity does not consume any AI units.

AI ユニットの消費数は、Insights の [テナント レベルの AI ユニットの消費] ダッシュボードを使用して監視できます。2025.4 までは、セマンティック アクティビティのメトリックが [Semantic Activities (promo)] に表示され、利用しているが課金されない AI ユニット数が示されます。2025.4 より後は、このダッシュボードを監視して、セマンティック アクティビティの AI ユニット消費量を予測できます。

バージョン 2024.10.6 から 2025.4 までは、セマンティック アクティビティは、Community と Enterprise のユーザーに無料で提供されます。AI ユニットを購入していないユーザーも対象です。このプロモーション期間は、機能の導入を促進し、品質についてのユーザーの信頼を築くことを目的としています。v2025.4 からは、AI ユニットの消費が前述のとおり適用され、すべてのユーザーに対してシームレスな継続性と透明性が確保されます。

ポップアップを閉じる

UiPath.UIAutomationNext.Activities.NClosePopup

説明

設定した [閉じる] ボタンを使用して、アプリケーションの前面にありターゲットをブロックするすべてのポップアップを閉じます。

このアクティビティは、[アプリケーション/ブラウザーを使用] アクティビティの内部と外部の両方で使用できます。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• ポップアップの閉じるボタン - ポップアップを閉じるために使用されるボタンのラベルです。デスクトップ版の Studio では、[閉じる] ボタンと [キャンセル] ボタンのラベルは既定で入力されます。
• AI 強化モード - トグル ボタンが [オン] に設定されている場合に、AI を利用してポップアップを閉じます。AI による閉じる操作ごとに 1 AI ユニットが消費されます。既定のオプションは [オフ] です。

その他のオプション

タイミング

• ポップアップの表示のタイムアウト - ポップアップが出現するまでに待機する時間 (秒) です。既定値は 30 秒です。

入力

• ポップアップ検出例外 - ポップアップが検出されたときにスローされる例外です。

出力

• ポップアップの処理 - ポップアップが処理されたかどうかを示します。

フォーム データを抽出

UiPath.Semantic.Activities.NExtractFormDataGeneric

説明

AI を使用してフォーム データをシームレスに抽出します。

データ エンティティと簡単に連携できます。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• 画面からフィールドを検出 - 操作可能な要素と、その要素に関連付けられたラベルを検索する DOM 分析です。
• フォーム データ - 抽出後のフォーム データの保存場所です。出力は構造化データのカスタム型です。

その他のオプション

タイミング

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

フォームに入力

UiPath.Semantic.Activities.NFillForm

説明

AI を使用して、指定したデータ ソースから抽出した情報を指定したフォームにシームレスに入力します。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• データ ソース - サポートされている型のデータ ソースを選択します。DocumentData、Dictionary、DataEntity、DataRow、DataTable、JSON ファイル、非構造化テキスト ファイル、さらにはカスタム型 ([フォーム データを抽出] アクティビティの出力として生成される型など) がサポートされています。
  注:

  DataTable では、最初の行のデータのみがフォームへの入力に使用されます。

  IEnumerable をデータ ソースとして使用するには、このアクティビティを [繰り返し (コレクションの各要素)] アクティビティ内に追加する必要があります。
• 検証を有効化 - トグル ボタンが [オン] に設定されている場合、実行時の値の実行検証を有効化します。実行後に内部検証メカニズムで無効な値が検出されると、例外がスローされます。既定のオプションは [オフ] です。

その他のオプション

タイミング

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

UI 要素を更新 (以前の名称は [値を設定])

UiPath.Semantic.Activities.NSetValue

説明

AI を使用して、入力ボックス、ドロップダウン、チェック ボックス、ラジオ ボタン、日付の選択などの任意の入力フィールドにシームレスに値を設定します。

Chrome、Edge、Firefox、Safari でのみ使用できます。

[フォームに入力] と同じ機能を使用しますが、要素レベルで使用します。

特定の入力フィールドごとに別のアクティビティ (例: 入力ボックスには [文字を入力]、チェック ボックスには [チェック/チェック解除] など) を使用するのではなく、1 つの汎用の [UI 要素を更新] アクティビティを使用できます。また、日付の選択やラジオ ボタンのグループも処理できます。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

このアクティビティはオブジェクト リポジトリに対応しています。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• 画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。

  ターゲットを指定したら、プラス ボタンをクリックします。以下のオプションが表示されます。

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
• 値 - フィールドに設定される値です。このフィールドは String 型の変数のみを受け入れます。
  指定したターゲットがチェックボックスの場合、次の値が受け入れられます。

  • True: "true"、 "yes"、 "checked"、 "x"
  • False: "false"、"no"、"unchecked"
• 検証を有効化 - トグル ボタンが [オン] に設定されている場合、実行時の値の実行検証を有効化します。実行後に内部検証メカニズムで無効な値が検出されると、例外がスローされます。既定のオプションは [オフ] です。

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

ターゲット

• ターゲットのプロパティを展開 - ターゲットとアンカーのプロパティを表示します。これにより、アクティビティの他のプロパティは非表示になり、ターゲットに関連するプロパティのみが表示されます。

• ターゲットのプロパティを折りたたみ - ターゲットとアンカーのプロパティを非表示にします。これにより、ターゲットに関連するプロパティが非表示になり、アクティビティのプロパティが表示されます。

• ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
  • None
  • 厳密セレクター - ターゲット UI 要素に対して生成される厳密セレクターです。
  • あいまいセレクター - あいまいセレクターのパラメーターです。

  • Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。

    Computer Vision をターゲット メソッドとして使用するもう 1 つの方法は、[ ローカル サーバーを使用 ] を [ True] に設定することです。これは、 UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。Local Server が有効な場合、サーバーの値は上書きされます。ただし、ローカル サーバーはクロスプラットフォーム プロジェクトでは利用できません。

    • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
    • CV テキスト - Computer Vision で識別するテキストを指定します。
    • CV テキストの出現 回数 - 複数の一致が見つかった場合に使用する特定の出現を示します。
    • CV テキストの精度 - OCR でテキスト照合の精度レベルを示します。
  • セマンティック セレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
  • 画像 (Windows のみ)
    • 画像の精度 - 画像照合の精度レベルを指定します。
    • 画像の発生 - 複数の一致が見つかった場合に使用する特定の出現位置を指定します。
  • ネイティブ テキスト (Windows のみ)
    • ネイティブ テキスト - UI 要素を識別するために検索するテキストです。
    • ネイティブ テキストの出現 - 複数の一致が見つかった場合に使用する特定の出現を示します。
• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウのセレクターです。[ウィンドウ アタッチ モード] を [アプリケーション インスタンス] に設定している場合にのみ適用されます。
• ページの読み込みを待機 - アクションを実行する前に、アプリケーションが入力を受け入れる準備が整うまで待機します。以下のオプションを利用できます。
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。
• 表示設定の確認 - 有効化すると、アクティビティは UI 要素が表示されているかどうかも確認します。ドロップダウン メニューから次の 3 つのオプションのいずれかを選択できます。
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
• レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

タイミング

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。