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

用語:

• エージェント: 大規模言語モデル (LLM)、機械学習、従来のエンタープライズ オートメーションなどのテクノロジを活用した機能を備え、エージェントは動的で非決定論的な環境で動作するように設計されています。計画を立て、行動し、学習し、適応することができるため、判断力、柔軟性、状況認識を必要とするプロセスに最適です。

  構造化されたロジックと決まったルールに従う RPA ロボットのような決定論的なシステムとは異なり、エージェントは確率論的アプローチを用いて、パターンとリアルタイム データに基づいて決定を下します。このため、エージェントは、条件や結果が変化する、構造化されておらず例外が多いワークフローを自動化するのに非常に適しています。

• アクション アプリ: UiPath Apps で、または Studio Web で直接設計されたアプリの一種です。承認など、人間の介入が必要なタスク (Action Center のタスク) の特定のオプションを使用して、フォームや UI の操作を作成できます。アクション スキーマにアクション プロパティを追加することで、アクション アプリの入力プロパティと出力プロパティを定義できます。
  手記： 公開および展開されたアプリのみを使用して、エージェントのエスカレーションを構成できます。

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

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

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

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

エスカレーションとは?

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

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

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

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

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

手記： エージェントのエスカレーションは、アクション アプリを使用してのみ構成できます。UiPath Apps で作成したアクション アプリではなく、Studio Web で作成したアクション アプリを使用することをお勧めします。

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

1. Automation Cloud™ に移動して、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 is: "+ActionProperties.webSearchResults.[ 保存] を選択します。
    
    
    
    
13. [ 送信] ボタンと [キャンセル ] ボタンの名前を [ 承認 ] と [ 拒否] に変更します。
14. [ 承認 ] ボタンを選択して、右側の [ イベント ] タブに移動します。
15. [ オートメーションを編集 ] ボタンを選択して、「クリック時」のオートメーションを追加します。
16. [ アクションを送信] アクティビティを追加します。

    詳しくは、Studio Web でのアクティビティの追加に関する説明をご覧ください。

17. [ Outcome (結果 )] セクションで、[ Approve (承認 )] の値を選択します。
18. [ 拒否] ボタンを選択して、右側の [ イベント ] タブに移動します。
19. [ オートメーションを編集 ] ボタンを選択して、「クリック時」のオートメーションを追加します。
20. [ アクションを送信] アクティビティを追加します。

    詳しくは、Studio Web でのアクティビティの追加に関する説明をご覧ください。

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

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

1. Automation Cloud™ に移動して、Studio Web サービスを選択します。
2. [オートメーション] タブで [ 新しいプロジェクト] を選択し、プロジェクトの種類として [アプリ ] を選択します。
   
   
   
   
3. [ 空白のページ ] テンプレートを選択します。

   アクション アプリの作成で Autopilot 機能を活用するには、空のアプリが必要です。

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

   これにより、アプリ内でアクション スキーマが自動的に開きます。

5. [ Autopilot を使用 ] セクションで、Autopilot がアクション スキーマを生成するための指示を入力します。

   たとえば、「アクションスキーマを作成し、入力引数が年齢、入力/出力引数が給与、出力引数が利率である場合」と入力できます。

6. [ アクションを生成] を選択して、アクション スキーマを生成します。
7. [ スキーマからページを生成 ] を選択し、以前に生成されたアクション スキーマに基づいてアプリ構成を生成します。
8. Studio Web プロジェクトを更新します。

   これで、アクション アプリをパブリッシュしてデプロイする準備が整いました。

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

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

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. [ 検索の説明 ] セクションの 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. [エージェント] ワークスペースに戻ると、エージェントがタスクを実行し、期待される出力を提供していることがわかります。