エージェントワークスペースにサードパーティーアプリケーションを統合する

Connect Customer エージェントワークスペースは、エージェントにツールとstep-by-stepガイダンスを提供し、問題を迅速に解決し、より少ないトレーニングでより良いカスタマーエクスペリエンスを提供します。エージェントワークスペースには、Customer Profiles、Cases、エージェントアシストなどのネイティブのファーストパーティーアプリケーションが含まれます。サードパーティーのアプリケーションを統合することもできます。

注記

サードパーティーアプリケーションは、Connect Customer エージェントワークスペースでのみサポートされています。カスタムエージェントデスクトップではサポートされていません。

たとえば、独自の予約システムまたはサードパーティーのクレーム管理システムダッシュボードをエージェントワークスペースに統合できます。

サードパーティーアプリケーションの構築に関心のあるデベロッパーは、「エージェントワークスペースデベロッパーガイド」を参照してください。

内容

統合タイプ

統合は、Connect Customer の外部にあるものをインスタンスに接続します。 AWS アカウントとリージョンの統合を 1 回作成し、1 つ以上のインスタンスに関連付けて、アクセス許可を付与します。統合の追加ページで統合タイプを選択します。タイプは、設定内容と Connect Customer が統合に到達する方法を決定します。

標準アプリケーション: Connect Customer がエージェントワークスペースの iframe でレンダリングするウェブアプリケーション。エージェントは Apps ランチャーから開きます。アクセス URL、iframe アクセス許可、およびアプリケーションの更新時にが設定する問い合わせスコープを付与します。このタイプは、注文検索ツールやスケジューリングアプリなど、エージェントが作業するアプリケーションに使用します。
サービス: ビルドし、エージェントワークスペースのバックグラウンドで実行されるヘッドレスアプリケーション。サービスは、エージェントワークスペースがロードされたときに開始され、セッションの残りの間はアクティブのままになります。エージェントが開くためのインターフェイスはありません。このタイプは、接続、切断、問い合わせ作業後の問い合わせイベントへの対応、条件が満たされたときにアプリケーションを開く、セッションが開始されるとすぐに認証フローを完了するなど、単独で実行される作業に使用します。詳細については、「エージェントワークスペースデベロッパーガイド」の「サードパーティーサービスの構築」を参照してください。
MCP サーバー: Connect Customer の AI エージェントに呼び出す一連のツールを提供するモデルコンテキストプロトコルサーバー。アクセス URL の代わりに Bedrock AgentCore ゲートウェイを介して接続し、各ゲートウェイは 1 つの MCP サーバーを提供します。完全な手順については、「MCP サーバーを Connect Customer と統合する」を参照してください。

以下のステップでは、標準アプリケーションを追加する方法について説明します。

必要な IAM 許可

カスタム IAM ポリシーを使用してサードパーティーアプリケーションへのアクセスを管理する場合、ユーザーには追加の IAM アクセス許可が必要です。に加えてAmazonConnect_FullAccess、ユーザーには以下が必要です。

サードパーティーアプリケーションを追加する

注記

インスタンスに統合を追加するには、インスタンスがサービスにリンクされたロール (SLR) を使用していることを確認します。インスタンスが現在 SLR を使用していないが、統合を追加する場合は、SLR に移行する必要があります。統合は、SLR を使用しているインスタンスにのみ追加できます。詳細については、「2018 年 10 月より前に作成されたインスタンスの場合」を参照してください。

Connect Customer コンソール (https://console.aws.amazon.com/connect/) を開きます。
ナビゲーションペインで、[統合] を選択します。このメニューが表示されない場合、リージョンでは 3P アプリを使用できません AWS 。3P アプリが利用可能な場所を確認するには、「」を参照してくださいリージョン別の Connect Customer 機能の可用性。
統合ページで、統合の追加を選択します。
統合の追加ページで、統合情報フィールドに入力します。
- 表示名: 3P アプリのわかりやすい名前。名前は、セキュリティプロファイルとエージェントワークスペースのタブに表示されます。後で変更できます。
- 説明 (オプション): 3P アプリの説明。エージェントには説明が表示されません。
- 統合タイプ: 統合が標準ウェブアプリケーション (3P アプリケーション）、サービス (3P サービス）、または MCP サーバーであるかどうかを示します。タイプは、エージェントが統合とやり取りする方法を決定します。
- 統合識別子: タイプの標準アプリケーションまたはサービスの統合の一意の名前。アクセス URL ごとにアプリケーションが 1 つだけの場合は、アクセス URL のオリジンを使用することをお勧めします。この名前を変更することはできません。
統合の詳細フィールドに入力します。
- 問い合わせ範囲: ウェブアプリケーションが問い合わせごとに更新されるか、新しいブラウザセッションごとにのみ更新されるかを示します。この設定は、アプリケーションがデータを更新する頻度に影響します。
- 初期化タイムアウト: ワークスペースとの接続を確立するためのミリ秒単位の最大時間。この設定は、接続の問題を管理し、アプリケーションのタイムリーな起動を確保するのに役立ちます。
アクセスフィールドに入力します。
- アクセス URL: アプリケーションがホストされている URL。URL は、ローカルホストでない限りhttps、で始まる必要があります。すべての URL に iframe を設定できるとは限りません。詳細については、「URL を iframed できるかどうかの確認」を参照してください。
- 承認されたオリジン (オプション): アクセス URLs と異なる場合に許可する追加の URL。ローカルホストでない限りhttps、各 URL はで始まる必要があります。
イベントとリクエストにアクセス許可を追加し、Iframe 設定を設定します。どちらもオプションです。

インスタンスの関連付けで、アプリケーションを使用できるインスタンスを選択します。
- この AWS アカウントとリージョンの任意のインスタンスにアプリケーションへのアクセスを許可できます。
- 統合とインスタンスの関連付けはオプションですが、これを行うまでアプリケーションを使用することはできません。
  
  注記
  MCP サーバーでは、選択したゲートウェイの検出 URL で設定されたインスタンスのみを選択できます。
[Add integration] (統合の追加) を選択します。
統合が正常に作成されると、統合の詳細ページに成功バナーが表示されます。

表示名、アクセス URL、アクセス許可など、既存の統合の一部の属性を編集できます。

統合の作成中またはインスタンスとの関連付け中にエラーが発生した場合は、エラーメッセージが表示されます。メッセージに従って問題を修正します。

URL を iframed できるかどうかの確認

すべての URL に iframe を設定できるとは限りません。URL を iframed できるかどうかをチェックするには、次の 2 つの方法があります。

サードパーティーのツールである Iframe Tester を使用して、URL を iframed できるかどうかをチェックします。
- URL を iframed できる場合、ページはプレビューをレンダリングします。
- URL を iframed できない場合、ページにはプレビューにエラーが表示されます。ウェブサイトには、エージェントワークスペースでアプリをiframedしてもエラーが表示される場合があります。アプリ開発者は、エージェントワークスペースにのみ埋め込むことができるようにアプリを制限できます。アプリ開発者からアプリを受け取った場合でも、エージェントワークスペースに統合してみてください。
技術ユーザーの場合: 統合するアプリケーションのセキュリティポリシーの内容を確認します。
- Firefox: ハンバーガーメニューを開き、その他のツール、ウェブ開発者ツール、ネットワークを選択します。
- Chrome: 3 つのドットのメニューを開き、その他のツール、開発者ツール、ネットワークを選択します。
- その他のブラウザ: デベロッパーツールでネットワーク設定を見つけます。
Content-Security-Policy frame-ancestors ディレクティブはである必要がありますhttps://your-instance.my.connect.aws。ディレクティブが same originまたはの場合deny、Connect Customer は URL を iframe できません。

アプリをイフレーミングできない場合にできることは次のとおりです。

アプリまたは URL を制御する場合は、アプリのコンテンツセキュリティポリシーを更新します。ガイダンスについては、「エージェントワークスペースデベロッパーガイド」の「推奨事項とベストプラクティス」を参照してください。
アプリまたは URL を制御しない場合は、アプリ開発者にアプリのコンテンツセキュリティポリシーの更新を依頼してください。