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 のデフォルト管理者を見つけます。
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 (OAuth 設定を有効化)] セクションまでスクロールします。

   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 Flows Connector) を見つけ、右側のドロップダウン矢印を選択して [ 表示] を選択します。

   図 5.アプリの詳細を表示する

   

3. [ Manage Consumer Details] を選択します。

4. プロンプトが表示されたら、セキュリティ検証手順を実行します。Salesforceは、登録されたメールアドレスに送信された確認コードを要求する場合があります。続行を求められたら、コードを入力します。

5. 次の資格情報が表示されます。

   • コンシューマー キー – クライアント ID を表します。
   • コンシューマー シークレット – クライアント シークレットを表します。重要: 両方の値をコピーして安全に保存してください。これらの資格情報は、Integration Service のコネクタを構成するために必要です。

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

1. [ 設定 ] > [ 接続アプリを管理] に移動します。
2. 接続アプリケーションを見つけて選択します (UiPath Salesforce Agentforce フロー コネクタ)。
3. [ ポリシーを編集] を選択します。
   1. [ クライアント資格情報フロー] で、[ 別のユーザーとして実行 ] フィールドを設定します。コネクタはこのユーザーを偽装して、フローとエージェントの API を呼び出します。注: これはコネクタのサービス アカウントです。必要な権限を持つユーザーを選択してください (API のみ、アクセス、または API が有効化されている)。
   2. [JWT ベースのアクセス トークン設定] で、次のように指定します。

      • [JSON Web トークン (JWT) ベースのアクセス トークンを発行する] チェックボックスをオンにします。

      • [トークンのタイムアウト] の値を 30 分に設定します。

        図 6.名前付きユーザーのJWTベースのアクセストークン設定

        

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

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

注:

この手順は、AgentForce (デフォルト) エージェントでは不要です。

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

1. [セットアップ] に移動して「agent」を検索します。

2. [ Agentforce Agents] を選択します。

3. [ ユーザーに Agentforce (デフォルト) エージェントへのアクセス権を付与する ] セクションで、カスタム エージェントの名前 (例: My Agentforce Service Agent) を選択します。

   図 7.ユーザーに Agentforce エージェントへのアクセス権を付与する

   

4. [ コネクション ] タブを選択し、[ 追加] を選択します。

   図 8.カスタム Agentforce エージェントの接続を設定する

   

5. [ コネクションを追加 ] ウィンドウで、以下の手順を実行します。

   1. [接続] フィールドを [API] に設定します。

   2. 連携名を指定します (例: UiPath Connector)。

   3. [ 接続アプリケーション] で、以前に作成した接続アプリケーション (UiPath Salesforce AgentForce Flows Connector) を選択します。

      図 9.UiPath Salesforce AgentForce フロー コネクタ

      

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

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

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

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

次に、Integration Service で Salesforce AgentForce & Flows コネクタを設定します。Salesforce Agentforce & Flowsの認証に移動して、コネクションを作成します。

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

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

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

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

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

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

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

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

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

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

1. アプリケーションランチャー (左上隅のグリッドアイコン) に移動します。

2. 検索バーで 「フローの実行 」を検索します。

3. 検索結果に表示される フロー実行 タブまたはオブジェクト名を選択します。このアクションにより、フロー実行レコードのリストビューが開きます。UiPathコネクタを介してトリガーされるフローごとに新しいレコードが作成されます。

   図 10.フロー実行記録

   

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

   図 11.フロー実行の詳細