Agentforce & Flows コネクタの Salesforce 設定

このガイドでは、Integration Service の Salesforce Agentforce & Flows コネクタを使用するために必要な、Salesforce の基本的な設定について概説します。

前提条件

開始する前に、次のことを確認してください。

• API が有効化されたシステム管理者プロファイルのアクセス権を持っている。

• Salesforce のエディションは Enterprise Edition、Unlimited Edition、または Developer Edition です。

現在の Salesforce 組織を使用するか、「 Salesforce Agentforce 開発者ツール 」ページのインストール手順に従って新しい Agentforce Developer Edition を設定できます。

Salesforce Flow Agents 管理パッケージのインストールと設定

手記： この手順は、Salesforce フローとの連携に必要です。Salesforce Agentforce とインテグレーションする場合は、このステップを完全にスキップして、 直接「Salesforce での接続アプリケーションの設定」に進みます。

AppExchange リストへのアクセスとインストール

UiPath-SF-Flow-Agents-Integration 管理パッケージをインストールするには、以下の手順に従います。

1. Web ブラウザーで、 Salesforce AppExchange の Web ページにアクセスします。
   大事な： Salesforce Agentforce & Flows コネクタの現在のプレビュー バージョンでは、次の URL を使用してパッケージにアクセスします。 https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY <yourSalesforceDomain> を組織のドメインに置き換えてください。
2. 検索バーに「 UiPath-SF-Flow-Agents-Integration」と入力します。
3. アプリの一覧を選択し、[ 今すぐ入手] を選択します。
4. Salesforce の資格情報を使用してログインし、インストールを続行します。
5. インストール環境を選択します。
   1. 本番: 本稼働の Salesforce 環境用。
   2. サンドボックス: 本番環境で使用する前のテスト用。

      注: UiPath コネクタはプレビュー段階であるため、ロボット グループを選択することはできません。

6. [ 管理者向けのみインストール] を選択します。

   この選択は、システム管理者にのみパッケージへのアクセス権を付与します。または、適切な権限を持つ特定のユーザが管理パッケージを使用できるようにすることもできます。

7. Salesforce 以外のアプリケーションのインストールを確認するチェックボックスをオンにします。
8. [インストール] を選択します。
9. インストールが正常に完了したら、[ 完了] を選択します。
10. [インストール済みのパッケージ] リストで「UiPath-SF-flow-agents-integration」を確認して、インストールを確認します。
    図 1. Salesforce の [インストール済みパッケージ] ウィンドウ
    

    

    
    

権限セットを割り当てる

管理パッケージへのアクセス権を持つユーザに必要な権限を付与する手順は、以下のとおりです。

1. [ 設定 ] > [ ユーザ ] > [権限セット] に移動します。
2. [ Agentforce Default Admin] を見つけます。
3. [ 割り当てを管理] を選択します。
4. [ 割り当てを追加] を選択します。
5. 必要なユーザーを選択します。
6. [次へ]、[割り当て] の順に選択します。

Salesforce での接続アプリケーションの設定

接続アプリケーションを作成する

1. アプリ マネージャーを開き、ウィンドウの右上隅にある歯車アイコンを選択して、[設定] を選択します。
2. 左のサイドバーにある [ クイック検索 ] ボックスに と入力して、[ アプリケーションマネージャ] を選択します。

   Salesforce 組織ですでに使用可能なアプリケーションのリストが表示されます。

3. ウィンドウの右上隅にある [ 新しい接続アプリケーション ] ボタンを選択します。
   図 2. 新しい接続アプリケーションを作成する
   

   

   
   
4. [ 接続アプリケーションの作成] を選択し、[ 続行] を選択します。
   図 3. [接続アプリケーションの作成] ウィンドウ
   

   

   
   
5. 新しい接続アプリケーションの [Basic Information ] セクションに入力します。
   1. 名前を入力します。例: UiPath Salesforce Agentforce フロー コネクタ。
   2. API 名: このフィールドは、指定したアプリ名に基づいて自動入力されます。
   3. 連絡先のメールアドレスを入力する:サポートコミュニケーションのメールアドレスを入力します。
6. 新しいアプリの OAuth 設定を有効にするには、[ API (Enable OAuth Settings)] セクションまでスクロールします。
   1. [ OAuth 設定を有効にする ] チェックボックスをオンにします。
   2. コネクタのコールバック URL ( https://cloud.uipath.com/provisioning_/callback) を入力して 、コールバック URL を指定します。
   3. 必要な OAuth スコープを追加します。
      • Salesforce フローの場合:
        • フルアクセス (full)
        • 任意のタイミングで要求を実行 (refresh_token、 offline_access)
      • Salesforce Agentforce の場合:
        • チャットボットサービスへのアクセス (chatbot_api)
        • Salesforce API プラットフォームへのアクセス (sfap_api)
        • フルアクセス (full)
        • API を使用してユーザー データを管理する (api)
        • 任意のタイミングで要求を実行 (refresh_token、 offline_access)
7. 接続アプリケーションのセキュリティ設定を管理する:
   1. 次のチェックボックスをオンにします。
      1. クライアント資格情報フロー: 有効化したら、次のポップアップウィンドウで [ OK ] を選択して、コンシューマーキーとコンシューマーシークレットを持つすべてのユーザーが、選択したユーザーの代わりに組織にアクセスできることを確認します。
      2. 指定ユーザーに対して JSON Web トークン (JWT) ベースのアクセス トークンを発行する – Integration Service コネクタでの認証に OAuth 2.0 認可コードを使用する場合は、このチェックボックスをオンにしないでください。
   2. 次のチェックボックスをオフにします。
      1. サポートされている認可フローに Code Exchange (PKCE) 拡張機能の証明キーが必要
      2. Web サーバー フローにシークレットが必要
      3. 更新トークン フローにシークレットが必要
         図4. 接続アプリケーションの API 設定
         

         

         
         
8. [ 保存 ] を選択してアプリを保存します。次のメッセージが表示されます。「変更が有効になるまでに最大 10 分かかる場合があります。親組織を削除すると、OAuth 設定が有効になっている接続アプリケーションもすべて削除されます。

クライアント ID とクライアント シークレットを取得する

1. アプリマネージャーに戻ります。
2. アプリ (UiPath Salesforce Agentforce フロー コネクタ) を見つけ、右側のドロップダウン矢印を選択して [ 表示] を選択します。
   図5. アプリの詳細を表示する
   

   

   
   
3. [ コンシューマーの詳細の管理] を選択します。
4. プロンプトが表示されたら、セキュリティ検証手順を実行します。Salesforceは、登録されたメールアドレスに送信された確認コードを要求する場合があります。続行を求められたら、コードを入力します。
5. 次の資格情報が表示されます。
   • コンシューマー キー – クライアント ID を表します。
   • コンシューマー シークレット – クライアント シークレットを表します。
   大事な： 両方の値をコピーして安全に保存します。これらの資格情報は、Integration Service コネクタを設定するために必要です。

JWT およびクライアントログイン情報フローのための接続アプリケーションの設定

1. [ 設定 ] > [ 接続済みアプリケーションを管理] に移動します。
2. 接続アプリケーションを見つけて選択します (UiPath Salesforce Agentforce フロー コネクタ)。
3. [ ポリシーの編集] を選択します。
   1. [ クライアント資格情報フロー] で、[ 他のユーザーとして実行 ] フィールドを設定します。コネクタは、このユーザーを偽装して、フローとエージェントの API を呼び出します。
      手記： これはコネクタのサービス アカウントです。必要な権限 (API のみのアクセス、または API が有効化されている) を持つユーザーを選択していることを確認します。
   2. [JWT-based Access Token Settings for Named Users] で、次の操作を行います。
      • [ Issue JSON Web Token (JWT) based access tokens] チェックボックスをオンにします 。
      • [ トークン タイムアウト ] の値を 30 分に設定します。
        図6. 指定ユーザーの JWT ベースのアクセス トークン設定
        

        

        
        
4. [保存] を選択します。

カスタム Agentforce エージェントへの UiPath コネクタ アクセスを有効化する

手記： このステップは、AgentForce(デフォルト)エージェントには必要ありません。

カスタム エージェントごとに、以下の手順に従います。

1. [設定] に移動し、「エージェント」を検索します。
2. [ Agentforce エージェント] を選択します。
3. [ ユーザーにAgentforce(デフォルト)エージェントへのアクセス権を付与する ]セクションで、カスタムエージェントの名前を選択します(たとえば、My Agentforceサービスエージェント)。
   図7. Agentforceエージェントへのアクセス権をユーザーに付与する
   

   

   
   
4. [ コネクション] タブを選択し、[ 追加] を選択します。
   図 8. カスタム Agentforce エージェントの接続を構成する
   

   

   
   
5. [ コネクションを追加] ウィンドウで、以下の操作を行います。
   1. [ 接続 ] フィールドを [API] に設定します。
   2. 連携名を指定します (例: UiPath Connector)。
   3. [ 接続アプリケーション] で、以前に作成した接続アプリケーション (UiPath Salesforce AgentForce フロー コネクタ) を選択します。
      図 9. UiPath Salesforce AgentForce フロー コネクタ
      

      

      
      
   4. コネクションを保存します。

リモート・サイト設定の構成

1. アプリ マネージャーから、ウィンドウの右上隅にある歯車アイコンを選択し、[設定] を選択します。
2. 左側のサイドバーにある [クイック検索 ] ボックスに、 リモートサイトの設定と入力します。
3. [セキュリティ] で、[ リモート サイトの設定] を選択します。
4. [ 新しいリモート サイト ] を選択して、新しいサイトを作成します。
5. 次の情報を入力して、新しいサイトを構成します。
   • [リモート サイト名(Remote Site Name)]:英数字の文字列をスペースなしで入力します (例: UiPathRemoteSite)。
   • リモート サイト URL: ベース URL を入力します (例: https://cloud.uipath.com)。
   • 説明: 説明を入力します (例: 「フロー呼び出し用の UiPath 連携ベース URL」)。このフィールドは任意です。
   • アクティブ: チェックボックスが選択されていることを確認します。
6. [ 保存 ] を選択して確定し、これらの設定をアクティブ化します。

これで、UiPath コネクタがカスタム Salesforce エージェントにアクセスできるようになります。呼び出すエージェントがアクティブ化されていることを確認します。

次に、Integration Service で Salesforce AgentForce & Flows コネクタを設定します。[Salesforce Agentforce & Flows authentication (Salesforce エージェントの強制フローの認証)] に移動して、コネクションを作成します。

一般的な問題とトラブルシューティング

次のセクションでは、Salesforce フローエージェント管理パッケージまたは接続アプリケーションを設定するときに発生する可能性のある一般的な問題とその修正方法を示します。

問題: 依存関係がないために管理パッケージのインストールが失敗する

1. 必要なすべての Salesforce 機能 (API アクセスや Einstein AI など) が有効になっていることを確認します。
2. インストール ログでパッケージの依存関係を確認します。

問題: ユーザーが特定の機能にアクセスできない

• エージェントのサービスアカウントユーザとエンドユーザに正しいプロファイルと権限セットが割り当てられていることを確認します。
• エージェントが有効化されていることを確認します。

問題: 外部システムが Salesforce に接続できない

• API 設定を確認し、接続アプリケーションに OAuth 認証が設定されていることを確認します。

UiPath コネクタを介してトリガーされる自動起動フローの実行ステータスを監視および検証する

Salesforce でカスタムフロー実行ログオブジェクトにアクセスするには、以下の手順に従います。

1. アプリケーションランチャー (左上隅のグリッドアイコン) に移動します。
2. 検索バーで 「フロー実行 」を検索します。
3. 検索結果に表示される [ フロー実行 ] タブまたはオブジェクト名を選択します。このアクションにより、フロー実行レコードのリストビューが開きます。UiPath コネクタを介してトリガーされるフローごとに、新しいレコードが作成されます。
   図 10. フロー実行レコード
   

   

   
   
4. 特定のフロー実行名を選択すると、その実行の詳細が表示されます。
   図 11. フロー実行の詳細