翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Connect Customer: External Tool のフローブロック
このトピックでは、フローから直接外部アプリケーションからツールを呼び出すためのフローブロックを定義します。
**注記**
**外部ツール**ブロックは、[Amazon Connect Customer](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) インスタンスでのみ使用でき、特定のリージョンでのみ使用できます。リージョンのリストについては、「」を参照してください[外部ツール](regions.md#externaltool_region)。
## 説明
+ Amazon Bedrock AgentCore ゲートウェイを介して Connect Customer インスタンスと統合された Salesforce や ServiceNow などの外部アプリケーションからツールを呼び出します。フローは、カスタム Lambda 関数を維持せずに、サードパーティーアプリケーションとの間でデータを送受信できます。
+ ツールが戻るまでフローが一時停止するツールを同期的に実行するか、フローが続く非同期的に実行します。非同期呼び出しの場合は、2 番目の**外部ツール**ブロックセットを**ロードツールの結果**に追加して結果を取得します。
+ 結果を `$.ExternalTool`名前空間に保存します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| チャネル | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## 前提条件と依存関係
このブロックを使用する前に、[外部アプリケーションと Connect Customer インスタンスを MCP サーバーとして統合](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate)する必要があります。統合を設定するには:
1. Connect Customer コンソールを開きます。
1. 新しい統合を追加し、統合タイプとして **MCP サーバー**を選択します。
1. Bedrock AgentCore ゲートウェイを選択して、インスタンスに接続します。ゲートウェイが存在しない場合は、まず [Bedrock AgentCore でゲートウェイを作成します](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate)。
1. ゲートウェイのインバウンド ID 設定で、ゲートウェイ ID **を許可された対象者**フィールドに追加します。ツールの呼び出しを成功させるには、ゲートウェイ ID が必要です。
1. ゲートウェイの検出 URL で設定されたインスタンスを選択して、Connect Customer インスタンスを統合に関連付けます。
統合が完了すると、アプリケーションは**外部ツール**ブロックに表示され、名前で選択できます。
## プロパティ
ブロックは、次のアクションをサポートしています。アクションの選択を使用して**アクションを選択します**。デフォルトは **Invoke ツール**です。
### 呼び出しツール
次の図は、外部ツールブロックプロパティの呼び出しツールアクション設定を示しています。
+ **アプリケーション名** (必須): 呼び出す外部アプリケーション。これは、手動または動的に設定できます。インスタンスに関連付けられたアプリケーションのみが表示されます。
+ **ツール名** (必須): アプリケーション内で呼び出すツール。これは手動または動的に設定できます。手動リストはアプリケーションごとに更新されます。入力フィールドはツールスキーマから生成され、ツール入力は手動、動的、または raw JSON として提供できます。
+ **実行モード**:
+ **同期**: コンタクトは、外部ツールの呼び出しが完了した後にのみ次のブロックにルーティングされます。
+ **非同期**: 問い合わせは、外部ツールの呼び出しが完了するまで待たずに次のブロックにルーティングされます。非同期実行モードで呼び出される外部ツールを待機するように[待機](wait.md)ブロックを設定できます。
+ **タイムアウト**: 外部ツールの呼び出しがタイムアウトするまでの待機時間。最大は**、同期**モードでは 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
ブロックを設定すると、**成功**ブランチと**エラー**ブランチが表示されます。**ロードツールの結果**アクションの場合、**進行中の**ブランチも表示されます。
