アクションアプリを使用したエージェントエスカレーションの作成

アクション アプリを使用して、Action Center でエージェントのエスカレーションを作成します。これには、アプリの作成、エージェントの設定、人間による承認などがあります。

用語:

• エージェント: 大規模言語モデル (LLM)、機械学習、従来のエンタープライズ オートメーションといったテクノロジを活用した機能は、動的で非決定論的な環境で動作するように設計されています。エージェントは計画を立て、行動し、学習し、適応することができます。そのため、意思決定、柔軟性、コンテキストの認識が要求されるプロセスに最適です。構造化されたロジックと決まったルールに従う RPA ロボットのような決定論的なシステムとは異なり、エージェントは確率論的アプローチを用いて、パターンとリアルタイム データに基づいて決定を下します。このため、エージェントは、条件や結果が変化する、構造化されておらず例外が多いワークフローを自動化するのに非常に適しています。
• アクション アプリ: UiPath App Studio で、または Studio Web で直接設計されたアプリの一種です。承認などの人間の介入が必要なタスク (Action Center タスク) 向けに、特定のオプションを指定してフォームや UI の操作を作成できます。アクション スキーマにアクションのプロパティを追加することで、アクション アプリの入力プロパティと出力プロパティを定義できます。UiPath App Studio および Studio Web のアプリ デザイナー以外に、 コード化されたアクション アプリ (任意の IDE でコードとして開発されたカスタムの React または Angular アプリケーション) としてタスク インターフェイスを構築することもできます。

注:

エージェントのエスカレーションの設定に使用できるのは、パブリッシュ済みおよびデプロイ済みのアプリのみです。

エージェントが課題に直面したり、重要な詳細を評価、確認、提供するために人間の介入を必要としたりする場合があります。これは意図的なアクションである可能性があり、エージェントに戻る前に特定のステップが常に人間に割り当てられます。エスカレーションが必要になる例としては、次のようなものがあります。 ツール呼び出しが予期せず失敗したり、予期しない構造のデータが返されたりすることがあります。サードパーティ アプリ内で同じ名前の複数の顧客を見分けるために必要な場合や、アクションの信頼性が低い可能性があります。また、特定の種類の意思決定や特定の行動を取ることを信頼されていないという組織的な理由もあるかもしれません。

これらすべての場合において、エージェントは人間にエスカレーションできる必要があります。

1. 効果的で、わかりやすく、カスタマイズ可能な方法で、関連するすべての詳細を表示します。
2. ケースの単純な承認/却下の決定、またはメール、注文番号、外部プラットフォームのアカウントへの参照など、いくつかのビジネスの詳細を提供するかどうかにかかわらず、人間参加型 (HITL) が関連する決定または情報を提供できるようにします。

エージェントは、ビジネス ケースの操作を続行する前に、ツールの 1 つを修正する必要がある場合もあります。ガードレール ツールを使用すると、不正なツール呼び出しを自動的に管理できます。詳しくは、「 ガードレール」をご覧ください。ガードレールのエスカレーションを作成する際は、UiPath Marketplace のテンプレート「 Agent Tool Guardrails Escalation App」を使用できます。

エスカレーションとは?

エスカレーションは、エージェントの実行プロセスにユーザーを関与させるために使用されるツールです。エスカレーションは、エージェントの決定を評価または検証したり、エージェントが持っていない可能性のある入力を提供したりするために使用されます。したがって、人間はエージェントの健康と習熟度を維持する上で依然として重要な役割を担っています。次の構成により、特定のエスカレーションの条件を設定できます。

• システムまたはユーザープロンプト:エージェントの目的を定義し、特定のエスカレーションをいつ使用するかを明確にします。
• エスカレーション - エスカレーション コンポーネントで、特定の状況向けに設計されたアクション アプリを選択します。アクション アプリに一意の名前と説明を付けることで、エージェントはどのエスカレーションをいつ使用すべきか、システム プロンプトとユーザー プロンプトからの指示も理解しやすくなります。1 つのエージェントに複数のエスカレーションを追加できます。1 つのエージェントに複数のエスカレーションを割り当てて各入力に説明を追加し、エージェントがアクション アプリに適切な値を送信できるようにすることができます。これらの設定はすべて、エージェントの有効性と全体的なヘルス スコアに大きく影響します。エージェントのスコアについて詳しくは、「 エージェントのスコア」をご覧ください。

重要:

エスカレーションは非決定論的です。つまり、エージェントは提供された指示を使用して、いつ、何をエスカレーションするかを決定します。一貫性のある確定的なエスカレーションが必要な場合は、エージェントの外部でアクション アプリを使用することをお勧めします。代わりに、エージェントを終了し、その出力をアプリ アクションで使用します。ユース ケースに応じて、以下の推奨事項を検討してください。

1. アクション アプリを作成する

まず、新しいアクション アプリを作成して構成する必要があります。この手順の手順では、検索結果を承認するアプリを作成する方法を示します。これらの手順は、特定のユース ケースに適合させることができます。

注:

エージェントのエスカレーションは、アクション アプリを使用してのみ設定できます。Apps デザイナーを使用して構築するアプリでは、UiPath App Studio で作成したアクション アプリではなく、Studio Web で作成したアクション アプリを使用することをお勧めします。また、選択した IDE でコードとして構築された コード化されたアクション Apps を使用することもできます。詳しくは 、「コード化されたアクション Apps を構築してデプロイ する」をご覧ください。

アクション アプリを最初から作成する

1. [Cloud Platform] に移動し、Studio Web サービスを選択します。

2. [オートメーション] タブで [ 新しいプロジェクト] を選択し、アプリの種類として [ アプリ ] プロジェクトを選択します。

   

3. 使用するテンプレート、スタイル、目的のコントロールを選択します。このチュートリアルでは、 フォーム D テンプレートを使用します。アプリのデザインについて詳しくは、こちらをご覧ください。

4. [ アプリ名] を選択し、[ 全般 ] タブで [ アプリ名 ] を選択して式エディターを開きます。

5. 新しいアプリに「Tool Approval App」という名前を付けて保存します。

6. 左側のナビゲーション パネルから [FormWrapper ] を選択し、この例では使用しないコントロール ( FirstName、 LastName、 Email、 Phone、 Street、 State、 Zip、 Country など) を削除します。

7. ページの左上にあるプロジェクト エクスプローラー ボタンを選択し、[+ 追加] ボタンを選択して [ アクション ] オプションを選択します。

   

8. ページ左上のツールボックス ボタンから [表示 ] タブに移動し、アプリにラベルを追加します。

   

   次に、このアプリをアクションアプリに変換する必要がありますが、そうしないと、このアプリを使用してエージェントのエスカレーションを構成できません。

9. ページの左上にあるプロジェクト エクスプローラー ボタンを選択し、[+ 追加] ボタンを選択して [ アクション ] オプションを選択します。[アクションのプロパティ] ダイアログが表示されます。

10. [アクションのプロパティ] ダイアログで、[入力プロパティ] にwebSearchResultsを追加し、関連するチェックボックスをオンにして必須にします。アクション スキーマの入力プロパティは、エージェントのコンテキストから派生し、ユーザーに提示されます。これらは、エージェントの実行ごとに一意である可能性があります。[入力/出力] プロパティとは異なり、レビュー中にこれらの値を変更できないことに注意してください。[入力/出力] プロパティはエージェントのコンテキストから派生し、変更できます。エージェントは、返された変更も記録します。出力プロパティは、ユーザーが入力してエージェントに送り返すことができる追加の値です。

11. [ Approve ] と [ Deny] の 2 つの結果を作成します。

    

    結果はイベントであり、入力/出力プロパティとともにエージェントに送り返されます。意味のある結果を提供することは、エージェントの次のステップを導きます (失敗による実行の終了が含まれる場合があります)。したがって、テストは非常に重要です。

12. フォームに戻り、式エディターで以前に作成したラベルに「webSearchResults for approval is: "+ActionProperties.webSearchResults」という名前を付けます。[ 保存] を選択します。

    

13. [ 送信] ボタンと [ キャンセル] ボタンの名前を [承認 ] と [拒否] に変更します。

14. [ 承認 ] ボタンを選択し、右側の [ イベント ] タブに移動します。

15. [ オートメーションを編集 ] ボタンを選択して、「クリック時」のオートメーションを追加します。

16. [アクションを送信] アクティビティを追加します。Studio Web でのアクティビティの追加について詳しくは、こちらをご覧ください。

17. [結果] セクションで、[承認] 値を選択します。

18. [拒否] ボタンを選択し、右側の [イベント] タブに移動します。

19. [ オートメーションを編集 ] ボタンを選択して、「クリック時」のオートメーションを追加します。

20. [アクションを送信] アクティビティを追加します。Studio Web でのアクティビティの追加について詳しくは、こちらをご覧ください。

21. [結果] セクションで、[拒否] 値を選択します。

Autopilot を使用してアクション アプリを作成する

1. [Cloud Platform] に移動し、Studio Web サービスを選択します。

2. [オートメーション] タブで [ 新しいプロジェクト] を選択し、アプリの種類として [ アプリ ] プロジェクトを選択します。

   

3. [ 空のページ ] テンプレートを選択します。アクション アプリの作成で Autopilot の機能を活用できるようにするには、空のアプリを用意する必要があります。

4. [プロジェクト エクスプローラー] でアプリ プロジェクトを右クリックし、[アプリに追加] ドロップダウン リストから [アクション] を選択します。アプリ内でアクション スキーマが自動的に開きます。

5. [ Autopilot を使用 ] セクションに、Autopilot でアクション スキーマを生成する手順を入力します。たとえば、「アクション スキーマを作成し、入力引数が Age、入力/出力引数が給与、出力引数が 利率」と入力できます。

6. [ アクションを生成 ] を選択してアクション スキーマを生成します。

7. [ スキーマからページを生成 ] を選択し、以前に生成されたアクション スキーマに基づいてアプリの設定を生成します。

8. Studio Web プロジェクトを更新します。これで、アクション アプリをパブリッシュしてデプロイする準備ができました。

コード化されたアクション アプリを使用する

アプリ デザイナーでタスク インターフェイスを構築する代わりに、 コード化されたアクション アプリ (好みの IDE でコードとして開発されたカスタムの React または Angular アプリケーション) を使用できます。これにより、タスクのインターフェイスとその動作、および UiPath や外部システムとの連携を全面的に制御できます。

コード化されたアクション アプリのライフサイクルは、Studio Web のアクション アプリと同じです。

• 選択した IDE のコードで定義
• UiPath に接続済み
• Orchestrator にデプロイする
• エージェントのエスカレーション タスクのインターフェイスとして使用されます

アクション アプリをパブリッシュしてデプロイしたら、他のアクション アプリと同じように、エスカレーションを設定する際に [アプリ ] ドロップダウン リストでそのアプリを選択します。

コード化されたアクション Apps の構築とデプロイの詳しい手順については、「 コード化されたアクション Apps の構築とデプロイ 」と SDK ドキュメントの「 はじめに 」をご覧ください。

アクション アプリをパブリッシュしてデプロイする

このアクション アプリを組織で利用できるようにするには、アプリをパブリッシュしてデプロイする必要があります。

1. [パブリッシュ] を選択します。
2. "EscalationTestApp" という名前を選択し、もう一度 [ 発行] を選択します。
3. アクション アプリを作成する場所に応じて、以下のようにアプリをデプロイします。
   • アプリ プロジェクトでアプリを作成した場合は、 Orchestrator に移動してアプリをデプロイします。
   • Studio Web でソリューションの一部としてアプリを作成した場合は、Orchestrator の [ ソリューション ] タブに移動し、アプリをデプロイします。サーバーレス ランタイムで実行されることを確認してください。
4. アプリをデプロイしたら、[ プロセスの詳細を編集 ] ボタンを選択します。
5. [次へ] を選択します。
6. [Cloud ロボット - サーバーレス] セクションで、[中] オプションを選択します。これは、Web Appsで最高のパフォーマンスを得るために推奨されるオプションです。
7. [更新] を選択します。

2. エージェントを作成する

1. この エージェント構築手順に従って、新しいエージェントを作成します。

2. [システム プロンプト] フィールドに、以下を入力しますUse the web search tool to do a search on the provided search item. You must then raise an escalation to confirm that the search result is satisfactory before returning your final output, a simple one-liner from the web search.

3. [ユーザー プロンプト] フィールドに、「Do a search on term:」と入力します。

4. プロジェクトの左側で [ データ マネージャーを開く] を選択し、[ 入力 ] タブで [ プロパティを追加] を選択します。

5. [ 名前を編集 ] を選択して「 searchTerm」と入力します。[ 適用 ] を選択して変更を保存します。

6. [説明] フィールドに、「the search term provided from the user」と入力します。

7. [ 出力 ] タブで [ プロパティを追加] を選択し、[名前] を [ Output ] に、[説明] を「 natural language summary of the approved search results」に設定します。

8. このプロパティを必須にするには、[ 必須 ] を選択します。

   図 1.エージェントのユーザー プロンプトとシステム プロンプトです

   

9. ユーザー プロンプトに戻り、二重中括弧を使用して作成したプロパティを追加します{{ }}。

   この例では、二重開き中括弧 {{を入力し、[ searchTerm] を選択します。

10. [ ツール ] セクションで [ ツールを追加] を選択し、[ アクティビティ ] タブに移動します。

11. [ Web 検索 ] アクティビティを検索して選択します。

12. このアクティビティの [ プロパティ ] パネルを開き、[ UiPath GenAI アクティビティのコネクション ] ドロップダウン リストで既存のコネクションを選択します。または、[ 新規定義 ] を選択して新しいコネクションを作成するか、[ コネクションを開く ] を選択して Integration Service に移動します。

13. [ 検索エンジン ] フィールドから GoogleCustomSearch を選択します。

14. [ Search description ] セクションの [tune] メニューから [ Argument] を選択し、以前に作成した引数を選択します。この引数には、Web で検索するトピックが含まれている必要があります。エージェントは、データ マネージャーで提供された引数の説明もユーザー プロンプトの一部として使用します。

    図 2.[Web 検索] アクティビティの [プロパティ] パネル

    

15. [ エスカレーション ] セクションで、[ エスカレーションを追加] を選択します。

    1. [ アプリ ] ドロップダウン リストで、作成およびデプロイ済みのアクション アプリを選択します。この例では、[ EscalationTestApp] を選択します。

    2. [プロンプト] フィールドに、「Use this to confirm the search results is satisfactory with the assignee」と入力します。

    3. [ 入力 ] セクションを展開して、アクション アプリのフィールドを表示します。

       図 3.エージェントのエスカレーションを設定する

       

16. エージェントを実行します。

17. エージェントの [トレース ] タブで、先ほど設定した担当者に保留中のタスクの URL を選択します。

    1. 待機しているエスカレーションタスクを確認し、すべて問題がなければ承認します。

       
       注:

       エージェントは、割り当てられたユーザーが Action Center でエスカレーションを解決するまで、中断ステートになります。

18. [エージェント] ワークスペースに戻ると、エージェントがタスクを実行し、期待される出力を提供していることがわかります。