사전 빌드된 주소 수집 구성요소

주소 컬렉션 사전 빌드된 구성요소는 최종 사용자로부터 주소를 수집하고 Google Address Validation API를 사용하여 주소를 검증합니다.

제한사항

사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.

추가 기능

이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.

샘플 대화상자

다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.

전체 유효 주소

최종 사용자가 전체 주소를 제공하고 주소 수집 구성요소에서 이를 확인합니다.

사용자 입력 에이전트 응답
시작하려면 전체 주소를 알려주세요.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
최종 주소를 수집했습니다. 도로 번호는 1600, 경로는 Amphitheatre Parkway, 도시는 Mountain View, 행정 구역은 CA, 우편번호는 94043, 국가는 미국입니다. 맞나요? 예 또는 아니요로 알려주세요.
예
좋습니다. 주소를 수집했습니다.

추론된 요소가 포함된 부분적으로 유효한 주소

최종 사용자가 부분 주소를 제공합니다. 에이전트는 누락된 부분을 추측하고 최종 사용자 확인 후 이를 확인합니다.

사용자 입력 에이전트 응답
시작하려면 전체 주소를 알려주세요.
1600 Amphitheatre Parkway
주소의 일부를 추정했습니다. 도시는 Mountain View, 우편번호는 94043, 행정 구역은 CA, 국가는 미국입니다.

최종 주소를 수집했습니다. 도로 번호는 1600, 경로는 Amphitheatre Parkway, 도시는 Mountain View, 행정 구역은 CA, 우편번호는 94043, 국가는 미국입니다. 맞나요? 예 또는 아니요로 알려주세요.
예
좋습니다. 주소를 수집했습니다.

사용자가 제공한 요소가 포함된 부분적으로 유효한 주소

최종 사용자가 부분 주소를 제공합니다. 에이전트가 누락된 부분을 추측하지만 최종 사용자가 '아니요'라고 말한 후 자신의 입력을 제공하고 에이전트는 성공적으로 주소를 수락합니다.

사용자 입력 에이전트 응답
시작하려면 전체 주소를 알려주세요.
1600 Amphitheatre Parkway
주소의 일부를 추정했습니다. 도시는 Mountain View, 우편번호는 94043, 행정 구역은 CA, 국가는 미국입니다.

최종 주소를 수집했습니다. 도로 번호는 1600, 경로는 Amphitheatre Parkway, 도시는 Mountain View, 행정 구역은 CA, 우편번호는 94043, 국가는 미국입니다. 맞나요? 예 또는 아니요로 알려주세요.
아니요
알겠습니다. 주소를 변경해야 하는 부분을 알려주세요.
우편번호
우편번호를 알려주시겠어요?
94044
업데이트가 완료되었습니다. 변경할 사항이 또 있나요? 예 또는 아니요로 알려주세요.
아니요
검사 후 우편번호를 94043으로 대체했습니다.

최종 주소를 수집했습니다. 도로 번호는 1600, 경로는 Amphitheatre Parkway, 도시는 Mountain View, 행정 구역은 CA, 우편번호는 94043, 국가는 미국입니다. 맞나요? 예 또는 아니요로 알려주세요.
예
좋습니다. 주소를 수집했습니다.

인식할 수 없는 입력

최종 사용자가 인식되지 않는 입력을 세 번 제공하면 구성요소에서 흐름을 종료합니다.

사용자 입력 에이전트 응답
시작하려면 전체 주소를 알려주세요.
좋습니다.
죄송합니다. 인식하지 못했습니다. 시작하려면 전체 주소를 알려주세요.
좋아요
아직도 이해하지 못했습니다. 시작하려면 전체 주소를 알려주세요.
매우 좋음
죄송합니다. 고객님의 답변을 이해하기 어렵습니다.

지원되지 않는 주소

최종 사용자가 현재 Address Validation API에서 지원되지 않는 주소를 제공하면 구성요소에서 흐름을 종료합니다.

사용자 입력 에이전트 응답
시작하려면 전체 주소를 알려주세요.
인도
죄송하지만 현재 해당 지역의 주소를 확인할 수 없습니다.

주소 검증

주소 수집 구성요소가 주소를 검증하는 방법을 이해하려면 Address Validation API 개요를 참조하세요.

주소 수집 구성요소는 @sys.address 시스템 항목을 사용하여 최종 사용자 입력을 캡처하고 캡처된 주소를 Address Validation API에 전송하여 추가 처리를 위해 주소 요소를 추출합니다.

다음 주소 요소는 Address Validation API에서 반환되며 구성요소에서 전체 주소를 수집하고 검증하기 위해 사용됩니다.

  • administrative_area_level_1
  • 군도
  • country
  • 지역
  • postal_code
  • 경로
  • street_number

지원되는 리전의 모든 주소로 Google 주소 검증 데모를 사용해 볼 수 있습니다.

이름 지정 규칙

이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.

기능 형식 예
흐름 [구성요소 이름] 주소 수집
구성요소별 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_address_collection_locality
매개변수 [param_name] user_provided_address
웹훅 prebuilt_components_[component_name]:[webhook_action] prebuilt_components_address_collection:address_validation

입력 매개변수

입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.

흐름 시작 페이지에서 파라미터 사전 설정을 수정하여 이 구성요소에 필요한 주소 요소를 구성할 수 있습니다.

이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.

매개변수 이름 설명 입력 형식
$flow.zip_code 우편번호 주소 요소가 필요하면 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.city 도시 주소 요소가 필요한 경우 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.admin_area 행정 구역 주소 요소가 필요한 경우 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.street_number 도로 번호 주소 요소가 필요한 경우 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.route 경로 주소 요소가 필요하면 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.country 국가 주소 요소가 필요하면 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.island 섬 주소 요소가 필요하면 true로 설정하고 그렇지 않으면 false로 설정합니다. 부울
$flow.retry_num Maps Address Validation API 웹훅 호출의 최대 재시도 한도를 설정합니다. 정수

이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 빌드 탭을 선택합니다.
  5. 흐름 섹션에서 가져온 구성요소를 클릭합니다.
  6. 페이지 섹션에서 시작 페이지를 클릭합니다.
  7. 시작 페이지에서 true 경로를 클릭합니다.
  8. 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
  9. 저장을 클릭합니다.

출력 매개변수

출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.

매개변수 이름 설명 출력 형식
address_collection_address 이 파라미터는 구성요소에서 주소를 캡처한 경우 주소 객체를 반환합니다. 
{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}
address_collection_status 이 매개변수는 수집된 주소의 상태를 반환합니다. 반환된 값은 다음 중 하나입니다.

VALID_ADDRESS: Address Validation API에서 주소를 수집하고 검증했습니다.

INVALID_ADDRESS: 최종 사용자가 주소를 확인했지만 하나 이상의 요소가 검증되지 않았거나 Address Validation API에 의해 UNCONFIRMED_BUT_PLAUSIBLE로 표시되었습니다.

MAPS_API_ERROR: Address Validation API 오류로 인해 주소가 수집되지 않았습니다.

COUNTRY_NOT_SUPPORTED: Address Validation API가 해당 리전을 지원하지 않기 때문에 주소가 수집되지 않았습니다.

NO_USER_CONFIRMATION: 최종 사용자가 주소를 확인하지 않았으므로 주소가 확인되지 않았습니다.		 
string

기본 설정

이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.

  1. 사전 빌드된 구성요소를 가져옵니다.
  2. Address Validation API를 사용 설정합니다.
  3. 제공된 가변형 웹훅을 지도 API 키로 구성합니다. 아래 웹훅 설정을 참조하세요.

웹훅 설정

Address Validation API를 사용하여 주소를 검증하려면 제공된 유연한 웹훅에 올바른 사용자 인증 정보를 구성해야 합니다.

주소 검증 웹훅

이 웹훅은 다음 작업을 실행합니다.

  1. 캡처된 대화형 에이전트(Dialogflow CX) 파라미터를 처리하고 요청을 작성하며 Address Validation API를 사용하여 주소를 확인합니다.
  2. Google Address Validation API 응답에서 확인되거나 확인되지 않은 주소, 누락되거나 추론된 주소 요소를 추출합니다.

이 구성요소의 웹훅을 구성하려면 웹훅 설정을 지도 API 키로 업데이트해야 합니다.

  1. API 키를 검색하려면 Google Cloud Platform 콘솔 > API 및 서비스 > 사용자 인증 정보로 이동하여 지도 API 키를 선택하고 API 키 필드를 복사합니다.

웹훅을 구성하려면 다음 안내를 따르세요.

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 관리 탭을 선택합니다.
  5. 웹훅을 클릭합니다.
  6. 사전 prebuilt_components_address_collection:address_validation 웹훅을 선택합니다.
  7. 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 지도 API 키가 포함된 URL(https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY)로 바꿉니다.
  8. 인증 설정에서 사용자 이름을 key로 구성하고 비밀번호를 지도 API 키로 설정합니다.
  9. 저장을 클릭합니다.

완료

에이전트와 웹훅이 설정되었습니다. 이제 테스트를 진행할 수 있습니다.

이전
계정 명세서
다음
영숫자 컬렉션