기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
고객 연결의 흐름 블록: 외부 도구
이 주제에서는 흐름에서 직접 외부 애플리케이션에서 도구를 호출하기 위한 흐름 블록을 정의합니다.
참고
외부 도구 블록은 Amazon Connect 고객 인스턴스와 특정 리전에서만 사용할 수 있습니다. 리전 목록은 섹션을 참조하세요외부 도구.
설명
-
Amazon Bedrock AgentCore 게이트웨이를 통해 Connect Customer 인스턴스와 통합된 Salesforce 또는 ServiceNow와 같은 외부 애플리케이션에서 도구를 호출합니다. 흐름은 사용자 지정 Lambda 함수를 유지 관리하지 않고도 타사 애플리케이션으로 데이터를 보내고 읽을 수 있습니다.
-
도구가 반환될 때까지 흐름이 일시 중지되는 도구를 동기식으로 실행하거나 흐름이 계속되는 비동기식으로 실행합니다. 비동기 호출의 경우 도구 결과 로드에 설정된 두 번째 외부 도구 블록을 추가하여 결과를 검색합니다.
-
결과를
$.ExternalTool네임스페이스에 저장합니다.
지원 채널
다음 표에는 이 블록이 지정된 채널을 사용하는 고객 응대를 라우팅하는 방법이 나와 있습니다.
| 채널 | 지원 여부 |
|---|---|
Voice |
예 |
Chat |
예 |
Task |
예 |
이메일 |
예 |
흐름 유형
다음 흐름 유형에서 이 블록을 사용할 수 있습니다.
-
모든 플로우
사전 조건 및 종속성
이 블록을 사용하려면 먼저 외부 애플리케이션을 Connect Customer 인스턴스와 MCP 서버로 통합해야 합니다. 통합을 설정하려면:
-
Connect Customer 콘솔을 엽니다.
-
새 통합을 추가하고 통합 유형으로 MCP 서버를 선택합니다.
-
Bedrock AgentCore 게이트웨이를 선택하여 인스턴스에 연결합니다. 게이트웨이가 없는 경우 먼저 Bedrock AgentCore에서 게이트웨이를 생성합니다.
-
게이트웨이의 인바운드 자격 증명 구성에서 허용된 대상 필드에 게이트웨이 ID를 추가합니다. 도구 호출이 성공하려면 게이트웨이 ID가 필요합니다.
-
게이트웨이의 검색 URL로 구성된 인스턴스를 선택하여 Connect Customer 인스턴스를 통합과 연결합니다.
통합이 완료되면 애플리케이션이 외부 도구 블록에 나타나고 이름으로 선택할 수 있습니다.
속성
블록은 다음 작업을 지원합니다. 작업 선택을 사용하여 작업을 선택합니다. 기본값은 호출 도구입니다.
도구 호출
다음 이미지는 외부 도구 블록 속성의 도구 호출 작업 구성을 보여줍니다.
-
애플리케이션 이름(필수): 호출할 외부 애플리케이션입니다. 수동 또는 동적으로 설정할 수 있습니다. 인스턴스와 연결된 애플리케이션만 나타납니다.
-
도구 이름(필수): 애플리케이션 내에서 호출할 도구입니다. 수동 또는 동적으로 설정할 수 있습니다. 수동 목록은 애플리케이션별로 업데이트됩니다. 입력 필드는 도구 스키마에서 생성되며 도구 입력은 수동, 동적 또는 원시 JSON으로 제공될 수 있습니다.
-
실행 모드:
-
동기: 외부 도구 호출이 완료된 후에만 고객 응대가 다음 블록으로 라우팅됩니다.
-
비동기식: 외부 도구 호출이 완료될 때까지 기다리지 않고 고객 응대가 다음 블록으로 라우팅됩니다. 비동기 실행 모드에서 호출되는 외부 도구를 기다리도록 대기 블록을 구성할 수 있습니다.
-
-
제한 시간: 외부 도구 호출이 제한 시간 초과되기까지 기다리는 시간입니다. 최대값은 동기식 모드의 경우 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와 각 계정의 지출 계층을 노출하는 타사 통합을 통합한 후 흐름은 외부 도구 블록을 사용하여 타사 애플리케이션에서 계층을 읽은 다음 일치하는 메시지로 분기합니다.
구성됨
블록을 구성하면 성공 및 오류 브랜치가 표시됩니다. 도구 결과 로드 작업의 경우 진행 중 브랜치도 표시됩니다.
