기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 고객 연결의 흐름 블록: 외부 도구
이 주제에서는 흐름에서 직접 외부 애플리케이션에서 도구를 호출하기 위한 흐름 블록을 정의합니다.
**참고**
**외부 도구** 블록은 [Amazon Connect 고객](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) 인스턴스와 특정 리전에서만 사용할 수 있습니다. 리전 목록은 섹션을 참조하세요[외부 도구](regions.md#externaltool_region).
## 설명
+ Amazon Bedrock AgentCore 게이트웨이를 통해 Connect Customer 인스턴스와 통합된 Salesforce 또는 ServiceNow와 같은 외부 애플리케이션에서 도구를 호출합니다. 흐름은 사용자 지정 Lambda 함수를 유지 관리하지 않고도 타사 애플리케이션으로 데이터를 보내고 읽을 수 있습니다.
+ 도구가 반환될 때까지 흐름이 일시 중지되는 도구를 동기식으로 실행하거나 흐름이 계속되는 비동기식으로 실행합니다. 비동기 호출의 경우 도구 **결과 로드**에 설정된 두 번째 **외부** 도구 블록을 추가하여 결과를 검색합니다.
+ 결과를 `$.ExternalTool` 네임스페이스에 저장합니다.
## 지원 채널
다음 표에는 이 블록이 지정된 채널을 사용하는 고객 응대를 라우팅하는 방법이 나와 있습니다.
| 채널 | 지원 여부 |
| --- | --- |
| Voice | 예 |
| Chat | 예 |
| Task | 예 |
| 이메일 | 예 |
## 흐름 유형
다음 [흐름 유형](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가 필요합니다.
1. 게이트웨이의 검색 URL로 구성된 인스턴스를 선택하여 Connect Customer 인스턴스를 통합과 연결합니다.
통합이 완료되면 애플리케이션이 **외부 도구** 블록에 나타나고 이름으로 선택할 수 있습니다.
## 속성
블록은 다음 작업을 지원합니다. 작업 선택을 사용하여 **작업을 선택합니다**. 기본값은 **호출 도구**입니다.
### 도구 호출
다음 이미지는 외부 도구 블록 속성의 도구 호출 작업 구성을 보여줍니다.
+ **애플리케이션 이름**(필수): 호출할 외부 애플리케이션입니다. 수동 또는 동적으로 설정할 수 있습니다. 인스턴스와 연결된 애플리케이션만 나타납니다.
+ **도구 이름**(필수): 애플리케이션 내에서 호출할 도구입니다. 수동 또는 동적으로 설정할 수 있습니다. 수동 목록은 애플리케이션별로 업데이트됩니다. 입력 필드는 도구 스키마에서 생성되며 도구 입력은 수동, 동적 또는 원시 JSON으로 제공될 수 있습니다.
+ **실행 모드**:
+ **동기**: 외부 도구 호출이 완료된 후에만 고객 응대가 다음 블록으로 라우팅됩니다.
+ **비동기식**: 외부 도구 호출이 완료될 때까지 기다리지 않고 고객 응대가 다음 블록으로 라우팅됩니다. 비동기 실행 모드에서 호출되는 외부 도구를 기다리도록 [대기](wait.md) 블록을 구성할 수 있습니다.
+ **제한 시간**: 외부 도구 호출이 제한 시간 초과되기까지 기다리는 시간입니다. 최대값은 **동기**식 모드의 경우 8초, **비동기식** 모드의 경우 60초입니다.
+ 외부 도구 호출이 제한되거나 일반적인 서비스 장애(500 오류)가 발생하면 요청이 재시도됩니다.
+ 외부 도구 호출에서 오류가 반환되면 Connect Customer는 지정된 제한 시간까지 최대 3회 재시도합니다. 이때 해당 고객 응대는 **오류** 분기로 라우팅됩니다.
+ 브랜치: **성공** 및 **오류**.
### 도구 결과 로드
다음 이미지는 외부 도구 블록 속성의 도구 로드 결과 작업 구성을 보여줍니다.
+ **외부 도구 호출 ID**: **비동기** 모드에서 실행된 외부 도구의 호출 ID입니다. 에는 가장 최근에 비동기적으로 실행된 외부 도구의 호출 ID가 `$.ExternalTool.InvocationId` 포함되어 있습니다.
+ **도구 결과 로드** 작업의 경우 **네임스페이스** = `ExternalTool` 및 **키** = **호출 ID**를 설정합니다.
+ 브랜치: **성공**, **진행 중** 및 **오류**.
## 네임스페이스
**외부 도구** 블록은 다음 네임스페이스 경로에 결과를 씁니다.
+ `$.ExternalTool.InvocationId` - 현재 호출 ID입니다.
+ `$.ExternalTool.ResultData` - 도구 결과(최대 32KB).
각각의 새 호출은 이전 `$.ExternalTool` 결과를 덮어씁니다. 결과를 유지하려면 다른 도구를 호출하기 전에 결과를 고객 응대 속성(`$.Attributes.*`) 또는 흐름 속성(`$.FlowAttribute.*`)에 복사합니다.
## 구성 팁
+ **애플리케이션 이름과** **도구 이름은** 동적으로 설정하거나 수동으로 설정할 수 있습니다.
+ 동기식 결과는 32KB로 제한됩니다. 응답이 클수록 **오류** 브랜치가 사용됩니다.
## 예제
아웃바운드 캠페인은 메시지를 각 고객의 지출 계층에 맞게 조정합니다. Amazon Bedrock AgentCore와 각 계정의 지출 계층을 노출하는 타사 통합을 통합한 후 흐름은 **외부 도구** 블록을 사용하여 타사 애플리케이션에서 계층을 읽은 다음 일치하는 메시지로 분기합니다.
## 구성됨
블록을 구성하면 **성공** 및 **오류** 브랜치가 표시됩니다. **도구 결과 로드** 작업의 경우 **진행 중** 브랜치도 표시됩니다.
