本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Connect Customer：外部工具中的流程區塊
本主題定義從外部應用程式直接從流程叫用工具的流程區塊。
注意
外部工具區塊僅適用於 Amazon Connect Customer 執行個體，且僅適用於特定區域。如需區域清單，請參閱 外部工具。
說明
-
從外部應用程式叫用工具，例如 Salesforce 或 ServiceNow，透過 Amazon Bedrock AgentCore 閘道與您的 Connect Customer 執行個體整合。您的流程可以將資料傳送至第三方應用程式並從中讀取資料，而無需維護自訂 Lambda 函數。
-
同步執行工具，其中流程會暫停，直到工具傳回流程繼續的位置，或非同步執行。對於非同步調用，將第二個外部工具區塊集新增至載入工具結果以擷取結果。
-
將結果存放在
$.ExternalTool命名空間中。
支援的頻道
下表列出此區塊如何轉接使用指定頻道的聯絡人。
| Channel | 支援？ |
|---|---|
語音 |
是 |
聊天 |
是 |
任務 |
是 |
是 |
流程類型
您可以在下列流程類型中使用此區塊：
-
所有流程
先決條件和相依性
您必須先將外部應用程式與 Connect Customer 執行個體整合為 MCP 伺服器，才能使用此區塊。若要設定整合：
-
開啟 Connect Customer 主控台。
-
新增整合，然後選取 MCP 伺服器做為整合類型。
-
選取要與您的執行個體連線的 Bedrock AgentCore 閘道。如果沒有閘道，請先在 Bedrock AgentCore 中建立一個。
-
在閘道的傳入身分組態中，將閘道 ID 新增至允許對象欄位。需要閘道 ID 才能成功叫用工具。
-
透過選取使用閘道探索 URL 設定的執行個體，將 Connect Customer 執行個體與整合建立關聯。
整合完成後，應用程式會出現在外部工具區塊中，並可以依名稱選取。
Properties
區塊支援下列動作。使用選取動作來選取動作。預設為叫用工具。
叫用工具
下圖顯示外部工具區塊屬性中的叫用工具動作組態。
-
應用程式名稱 （必要）：要呼叫的外部應用程式。您可以手動或動態設定。只有與您的執行個體相關聯的應用程式才會出現。
-
工具名稱 （必要）：要在應用程式中叫用的工具。您可以手動或動態設定此項目；手動清單會依應用程式更新。輸入欄位是從工具結構描述產生，而工具輸入可以手動、動態或以原始 JSON 的形式提供。
-
執行模式：
-
同步：只有在外部工具調用完成後，聯絡人才會路由到下一個區塊。
-
非同步：聯絡人會路由到下一個區塊，而無需等待外部工具叫用完成。您可以設定等候區塊，以等待在非同步執行模式下調用的外部工具。
-
-
逾時：外部工具呼叫逾時前的等待時間。同步模式的上限為 8 秒，非同步模式的上限為 60 秒。
-
如果外部工具調用受到調節，或發生一般服務失敗 (500 錯誤），則會重試請求。
-
當外部工具呼叫傳回錯誤時，Connect Customer 會重試最多三次，直到指定的逾時為止。此時，會將聯絡案例向下轉接到錯誤分支。
-
-
分支：成功和錯誤。
載入工具結果
下圖顯示外部工具區塊屬性中的載入工具結果動作組態。
-
外部工具叫用 ID：在非同步模式下執行之外部工具的叫用 ID。
$.ExternalTool.InvocationId包含最近非同步執行外部工具的叫用 ID。 -
對於載入工具結果動作，設定命名空間 =
ExternalTool和金鑰 = 調用 ID。 -
分支：成功、進行中和錯誤。
命名空間
外部工具區塊會將結果寫入下列命名空間路徑：
-
$.ExternalTool.InvocationId– 目前的調用 ID。 -
$.ExternalTool.ResultData– 工具結果 （最多 32 KB)。
每個新的調用都會覆寫先前的$.ExternalTool結果。若要保留結果，請先將其複製到聯絡屬性 ($.Attributes.*) 或流程屬性 ($.FlowAttribute.*)，再叫用其他工具。
組態提示
-
應用程式名稱和工具名稱可以動態設定，也可以手動設定。
-
同步結果上限為 32 KB。較大的回應需要錯誤分支。
範例
對外行銷活動會根據每位客戶的支出方案量身打造其訊息。在整合 Amazon Bedrock AgentCore 和公開每個帳戶支出層的第三方整合之後，流程會使用外部工具區塊從第三方應用程式讀取層，然後分支到相符訊息。
Configured
設定區塊後，會顯示成功和錯誤分支。對於載入工具結果動作，它也會顯示進行中分支。
