계정 잔액 사전 빌드된 구성요소는 고객의 인증 레벨을 확인한 후 인증된 고객에게 계정 잔액 정보를 제공합니다. 고객이 여러 계정을 갖고 있는 경우 구성요소는 고객이 계정 잔액을 검색하려는 특정 계정을 확인합니다. 이 구성요소는 인증 사전 빌드된 구성요소를 사용해서 사용자를 인증합니다.
제한사항
사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
단일 계정
최종 사용자에게 단일 계정이 있고 계정 잔액이 제공됩니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 계정 세부정보를 가져오는 동안 잠시 기다려 주세요. 끝 번호가 4567인 계정의 잔액은 $50.00입니다. |
복수 계정
최종 사용자에게 계정이 여러 개 있고 에이전트가 계정 번호의 마지막 네 자리 숫자를 요청 및 확인하고 해당 계정의 계정 잔액을 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 계좌 세부정보를 가져오는 동안 잠시 기다려 주세요. 귀하의 번호에 연결된 계좌가 2개 있는 것으로 확인되었습니다. 말씀하시는 계좌의 마지막 4자리 숫자를 알려주세요. |
|
| 2002 | |
| 계좌 번호의 마지막 네 자리 숫자는 2002입니다. 맞나요? | |
| 예 | |
| 끝 번호가 2002인 계정 번호의 잔액은 $5,000입니다. |
컨텍스트가 포함된 복수 계정
최종 사용자에게 여러 계정이 있고, 참조된 계정 번호가 이전 인텐트에서 유지되고, 계정 잔액과 함께 제공됩니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 계정 세부정보를 가져오는 동안 잠시 기다려 주세요. 귀하의 번호에 연결된 계정이 3개 있는 것으로 확인되었습니다. 끝 번호가 4567인 계정 번호를 찾고 계신가요? |
|
| 예 | |
| 끝 번호가 4567인 계정 번호의 잔액은 $50입니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 계정 잔액 |
| 구성요소 특정 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.auth_level | (선택사항) 호출자의 인증 레벨을 나타냅니다. | 정수 |
| $session.params.auth_level_req | 사용자가 자신의 계정 잔액에 액세스하기 전에 필요한 인증 레벨을 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 1입니다. |
정수 |
| $session.params.account_auth_enabled | 인증 유형에 설명된 대로 사용자를 계좌 소유자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 true입니다. |
부울 |
| $session.params.card_auth_enabled | 인증 유형에 설명된 대로 사용자를 카드 소지자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 false입니다. |
부울 |
| $session.params.phone_number | (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. | 문자열 |
| $session.params.account_count | (선택사항) 인증된 사용자와 연결된 계좌 수입니다. | 정수 |
| $session.params.last_four_digit_of_account_number | (선택사항) 잔액을 제공해야 하는 고객 계좌 번호의 마지막 4자리 숫자입니다. 고객에게 단일 계좌가 있으면 이 정보는 인증 후에 자동으로 검색됩니다. 고객에게 계좌가 여러 개 있는 경우 고객에게서 특정 계좌 번호가 수집됩니다. | 문자열 |
| $flow.max_retry_acc_number | 최종 사용자의 계좌 번호의 마지막 네 자리 숫자를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| auth_level | 호출자의 인증 레벨을 나타냅니다. | 정수 |
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| account_count | 등록된 전화번호와 연결된 계좌의 개수입니다. 이러한 계좌에는 자체 계좌 및 사용자에게 위임장이 있는 계좌가 포함됩니다. | 정수 |
| last_four_digit_of_account_number | 사용자에게 단일 계정이 있는 경우 계좌 번호의 마지막 네 자리 숫자가 반환됩니다. 사용자에게 두 개 이상의 계좌가 있는 경우 이 매개변수의 값은 사용자가 계정 잔액 정보를 수신하도록 선택한 계좌 번호의 마지막 네 자리 숫자입니다. | 문자열 |
| transfer_reason | 이 매개변수는 성공하지 않은 경우 흐름이 종료된 이유를 나타냅니다. 반환된 값은 다음 중 하나입니다.agent: 최종 사용자가 대화 중 특정 시점에서 에이전트를 요청했습니다.denial_of_information: 최종 사용자가 구성 요소에서 요청한 정보 공유를 거부했습니다.max_no_input: 대화가 입력되지 않은 이벤트에 대한 최대 재시도 횟수에 도달했습니다. no-input 기본 제공 이벤트를 참조하세요.max_no_match: 대화가 일치하지 않는 이벤트의 최대 재시도 횟수에 도달했습니다. no-match 기본 제공 이벤트를 참조하세요.webhook_error: 웹훅 오류가 발생했습니다. webhook.error 기본 제공 이벤트를 참조하세요. webhook_not_found: 웹훅 URL에 연결할 수 없습니다. webhook.error.not-found 기본 제공 이벤트를 참조하세요. |
문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
인증
인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 인증 웹훅 설정을 참조하세요.
계정 검증
prebuilt_components_account_services:validate_account 웹훅은 구성요소에서 사용자의 등록된 전화번호 및 제공된 계좌 번호의 마지막 4자리를 기준으로 계좌가 존재하는지 확인하는 데 사용됩니다.
계좌가 존재하는 경우 웹훅에서 계좌 잔액도 반환합니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_account_number | 사용자가 계정 잔액 정보를 수신하도록 선택하고 확인한 계좌 번호의 마지막 네 자리 숫자입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| account_found | 사용자의 등록된 계좌에 제공된 마지막 4자리 숫자가 포함된 계좌가 있는지 여부를 나타냅니다. | 부울 |
| 잔액 | 계좌의 현재 잔액(존재하는 경우)입니다. | 숫자 |
이 구성요소에 계정 검증 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_account_services:validate_account 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.