AIエージェントのインポート用にSalesforce.comを構成する

Salesforce.comからAIエージェントをインポートするには、Salesforce.comテナントとOktaで、いくつかの構成タスクを実行する必要があります。

このタスクについて

AIエージェントのインポート用にSalesforce.comを構成するには、2つのシステムでセットアップが必要です。Salesforceでは、専用統合ユーザーを作成し、必要な権限セットを割り当てて、OAuthアプリを構成します。Oktaでは、Salesforce.comアプリ統合にログインURL（Login URL）を設定します。

始める前に

  • Salesforce orgではAgentforceが有効になっています。
  • Salesforce orgには、エージェントプラットフォームビルダーのライセンスがあります（これにはAgentPlatformBuilder権限セットに必要）。
  • 少なくとも1つのAgentforceエージェントがセットアップ（Setup） > エージェント（Agents）にリストされています。
  • Salesforceのシステム管理者（System Administrator）アクセスがあります。
  • Okta orgのOINカタログからSalesforce.comアプリが追加されています。
  • Salesforce orgの自分のドメインのURL（My Domain URL）を把握します。これは、Salesforceにログインしたときにブラウザーで表示されるURLです（例：https://yourorg.my.salesforce.comまたはhttps://yourorg.develop.my.salesforce.com）。
  • 専用統合ユーザーを作成する
    1. Salesforceで、設定（Setup） > ユーザー（Users） > ユーザー（Users）に移動して、新規ユーザー（New User）をクリックします。
    2. 名（First Name）をOktaに、姓（Last Name）をAgentImportに設定します。
    3. 管理者のメールアドレスをメール（Email）フィールドに入力します。
    4. ユーザー名をokta.ai.import@yourdomain.comのフォーマットで入力します。
      ユーザー名は、すべてのSalesforce orgでグローバルに一意でなければなりません。
    5. ユーザーライセンス（User License）をSaleforceに設定します。
    6. プロファイル（Profile）を最小アクセス - Salesforce（Minimum Access - Salesforce）に設定します。
    7. 保存（Save）をクリックします。
  • AgentPlatformBuilder権限セットを割り当てる
    1. Salesforceで、設定（Setup） > ユーザー（Users） > 権限セット（Permission Sets）に移動します。
    2. エージェントプラットフォームビルダー（Agent Platform Builder）を検索してクリックします。
    3. 割り当ての管理（Manage Assignments）をクリックします。
    4. 割り当てを追加（Add Assignments）をクリックします。
    5. Okta AgentImportユーザーを選択して、次へ（Next）をクリックします。
    6. 割り当て（Assign）をクリックします。
    7. 権限セット（Permission Sets） > エージェントプラットフォームビルダー（Agent Platform Builder） > 割り当ての管理（Manage Assignments）に戻り、Okta AgentImportユーザーのステータスが有効（Active）であることを確認します。
      この確認は続行前に求められます。ユーザーが有効と表示されない場合、Oktaではno permissionエラーでインポートが失敗します。
  • APIログインを有効にする
    1. OktaでAPI資格情報をテスト（Test API Credentials）が失敗した場合は、Salesforceで設定（Setup） > セキュリティ（Security） > セッションの設定（Session Settings）に移動して、IP制限なしでのAPIログインを許可（Allow API login without IP restriction）を有効にします。
      この設定が表示されない場合は、orgでAPIログインがすでに有効になっています。この手順は、Oktaでの最初の資格情報チェックにのみ必要です。
  • 外部クライアントアプリを作成する
    1. Salesforceのセットアップで、外部クライアントアプリケーションマネージャー（External Client App Manager）を開き、新規外部クライアントアプリケーション（New External Client App）をクリックします。
    2. 外部クライアントアプリケーション名（External Client App Name）フィールドにOkta AI Agent Importと入力します。
    3. 連絡先Eメール（Contact Email）に管理者のメールアドレスを入力し、配信状態（Distribution State）をローカル（Local）に設定します。
    4. OAuthを有効化（Enable OAuth）を選択します。
    5. コールバックURLをhttps://localhostと入力します。
    6. APIを使用してユーザーデータを管理（api）（Manage user data via APIs (api)）をOAuthスコープに追加します。
    7. 保存（Save）をクリックします。
    8. アプリを再度開き、編集（Edit）をクリックします。
      フローの有効化設定は、アプリを保存しないと利用可能になりません。
    9. フローの有効化（Flow Enablement）で、クライアント資格情報フローを有効化（Enable Client Credentials Flow）を選択します。
    10. 代理実行（ユーザー名）（Run As (Username)）フィールドにokta.ai.import@yourdomain.comと入力します。
    11. OAuthポリシー（OAuth Policies）で、IPの緩和（IP Relaxation）をIP制限を緩和（Relax IP restrictions）に設定します。
    12. 許可されているユーザー（Permitted Users）をすべてのユーザーが自己承認可能（All users may self-authorize）に設定します。
    13. 保存（Save）をクリックします。
      アプリが有効になるまで最大5分かかる場合があります。
  • コンシューマーキーとコンシューマーシークレットを取得する
    1. Salesforceのセットアップで、外部クライアントアプリケーションマネージャー（External Client App Manager）に移動します。
    2. Okta AIエージェントインポート（Okta AI Agent Import）アプリを見つけて、ドロップダウンの矢印をクリックし、OAuth設定を表示（View OAuth Settings）を選択します。
    3. コンシューマーキー（Consumer Key）とコンシューマーシークレット（Consumer Secret）をコピーします。両方の値を安全な場所に保管します。
      これらの値は、OktaでAIエージェントのインポートを構成する際に必要になります。
  • OktaでログインURLを設定する
    1. Admin Consoleで、アプリケーション（Applications） > アプリケーション（Applications）に移動します。
    2. Salesforce.comアプリインスタンスを選択します。
    3. 一般（General）タブで、編集（Edit）をクリックします。
    4. ログインURL（Login URL）フィールドに、ブラウザーから正確にコピーしたorgの自分のドメインのURL（My Domain URL）を入力します。
    5. 保存（Save）をクリックします。

    これらの構成が完了したら、「アプリのAIエージェントのインポートを有効にする」を参照してください。