翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Connect Customer: External Tool のフローブロック
このトピックでは、フローから直接外部アプリケーションからツールを呼び出すためのフローブロックを定義します。
注記
外部ツールブロックは、Amazon Connect Customer インスタンスでのみ使用でき、特定のリージョンでのみ使用できます。リージョンのリストについては、「」を参照してください外部ツール。
説明
-
Amazon Bedrock AgentCore ゲートウェイを介して Connect Customer インスタンスと統合された Salesforce や ServiceNow などの外部アプリケーションからツールを呼び出します。フローは、カスタム Lambda 関数を維持せずに、サードパーティーアプリケーションとの間でデータを送受信できます。
-
ツールが戻るまでフローが一時停止するツールを同期的に実行するか、フローが続く非同期的に実行します。非同期呼び出しの場合は、2 番目の外部ツールブロックセットをロードツールの結果に追加して結果を取得します。
-
結果を
$.ExternalTool名前空間に保存します。
サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| チャネル | サポート対象? |
|---|---|
音声 |
はい |
Chat |
はい |
タスク |
はい |
E メール |
はい |
フロータイプ
このブロックは、次のフロータイプで使用できます。
-
すべてのフロー
前提条件と依存関係
このブロックを使用する前に、外部アプリケーションと Connect Customer インスタンスを MCP サーバーとして統合する必要があります。統合を設定するには:
-
Connect Customer コンソールを開きます。
-
新しい統合を追加し、統合タイプとして MCP サーバーを選択します。
-
Bedrock AgentCore ゲートウェイを選択して、インスタンスに接続します。ゲートウェイが存在しない場合は、まず Bedrock AgentCore でゲートウェイを作成します。
-
ゲートウェイのインバウンド ID 設定で、ゲートウェイ ID を許可された対象者フィールドに追加します。ツールの呼び出しを成功させるには、ゲートウェイ ID が必要です。
-
ゲートウェイの検出 URL で設定されたインスタンスを選択して、Connect Customer インスタンスを統合に関連付けます。
統合が完了すると、アプリケーションは外部ツールブロックに表示され、名前で選択できます。
プロパティ
ブロックは、次のアクションをサポートしています。アクションの選択を使用してアクションを選択します。デフォルトは Invoke ツールです。
呼び出しツール
次の図は、外部ツールブロックプロパティの呼び出しツールアクション設定を示しています。
-
アプリケーション名 (必須): 呼び出す外部アプリケーション。これは、手動または動的に設定できます。インスタンスに関連付けられたアプリケーションのみが表示されます。
-
ツール名 (必須): アプリケーション内で呼び出すツール。これは手動または動的に設定できます。手動リストはアプリケーションごとに更新されます。入力フィールドはツールスキーマから生成され、ツール入力は手動、動的、または raw JSON として提供できます。
-
実行モード:
-
同期: コンタクトは、外部ツールの呼び出しが完了した後にのみ次のブロックにルーティングされます。
-
非同期: 問い合わせは、外部ツールの呼び出しが完了するまで待たずに次のブロックにルーティングされます。非同期実行モードで呼び出される外部ツールを待機するように待機ブロックを設定できます。
-
-
タイムアウト: 外部ツールの呼び出しがタイムアウトするまでの待機時間。最大は、同期モードでは 8 秒、非同期モードでは 60 秒です。
-
外部ツールの呼び出しがスロットリングされた場合、または一般的なサービス障害 (500 エラー) が発生した場合、リクエストは再試行されます。
-
外部ツール呼び出しがエラーを返すと、Connect Customer は指定されたタイムアウトまで最大 3 回再試行します。その時点で、問い合わせは [Error (エラー)] ブランチにルーティングされます。
-
-
ブランチ: Success と Error。
ロードツールの結果
次の図は、外部ツールブロックプロパティのロードツールの結果アクション設定を示しています。
-
外部ツール呼び出し ID: 非同期モードで実行された外部ツールの呼び出し ID。 には、最後に非同期的に実行された外部ツールの呼び出し ID
$.ExternalTool.InvocationIdが含まれています。 -
ロードツールの結果アクションには、名前空間 =
ExternalToolとキー = 呼び出し ID を設定します。 -
ブランチ: Success、In progress、Error。
Namespace
External Tool ブロックは、次の名前空間パスに結果を書き込みます。
-
$.ExternalTool.InvocationId– 現在の呼び出し ID。 -
$.ExternalTool.ResultData– ツールの結果 (最大 32 KB)。
新しい呼び出しごとに、前の$.ExternalTool結果が上書きされます。結果を保持するには、別のツールを呼び出す前に、問い合わせ属性 ($.Attributes.*) またはフロー属性 ($.FlowAttribute.*) にコピーします。
設定のヒント
-
アプリケーション名とツール名は、動的にも手動でも設定できます。
-
同期結果の上限は 32 KB です。レスポンスが大きいほど、エラーブランチが作成されます。
例
アウトバウンドキャンペーンは、各顧客の支出階層に合わせてメッセージを調整します。Amazon Bedrock AgentCore と各アカウントの支出階層を公開するサードパーティー統合を統合すると、フローは外部ツールブロックを使用してサードパーティーアプリケーションから階層を読み取り、一致するメッセージに分岐します。
Configured
ブロックを設定すると、成功ブランチとエラーブランチが表示されます。ロードツールの結果アクションの場合、進行中のブランチも表示されます。
