사전 빌드된 의견 구성요소는 최종 사용자로부터 정량적 및 정성적 의견을 수집합니다.
이 구성요소는 먼저 구성된 마지막 피드백 확인 웹훅을 사용하여 조회를 수행하고 특정 최종 사용자가 최근에 의견을 제공했는지 확인합니다. 최근 의견이 없는 경우 구성요소에서 사용자에게 1~5 사이의 양적 의견 점수를 제공하도록 요청합니다. 피드백이 부정적인 경우 구성요소는 선택적으로 사용자로부터 자유 형식의 정성적 의견을 수집할 수 있습니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 고객 전화번호가 CRM(고객 관계 관리) 시스템 또는 다른 서비스에서 유지된다고 가정합니다.
- 보조 전화번호를 사용하는 기존 고객은 이 구성요소에서 인증되지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
긍정적인 의견
마지막 의견 확인 웹훅의 응답은 최종 사용자가 최근에 의견을 제공하지 않았음을 나타냅니다. 에이전트가 사용자에게 의견 점수를 요청하고 사용자는 긍정적인 경험을 나타내는 점수를 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 전화해 주셔서 감사합니다. 보내주시는 의견은 저희에게 큰 힘이 됩니다. 잠시 시간을 내어 몇 가지 간단한 질문에 답해서 오늘 받은 서비스에 대한 의견을 공유해 주세요. 1~5까지의 기준에서 가장 불만족스러우면 1점, 가장 만족스러우면 5점인 경우 오늘 받은 서비스에 얼마나 만족하시나요? |
|
| 5 | |
| 좋습니다. 긍정적인 의견을 보내 주셔서 감사합니다. |
부정적인 의견
마지막 의견 확인 웹훅의 응답은 최종 사용자가 최근에 의견을 제공하지 않았음을 나타냅니다. 에이전트가 사용자에게 의견 점수를 요청하고 사용자는 부정적인 경험을 나타내는 점수를 제공합니다. 그러면 에이전트가 사용자에게 정성적 의견을 요청합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 전화해 주셔서 감사합니다. 보내주시는 의견은 저희에게 큰 힘이 됩니다. 잠시 시간을 내어 몇 가지 간단한 질문에 답해서 오늘 받은 서비스에 대한 의견을 공유해 주세요. 1~5까지의 기준에서 가장 불만족스러우면 1점, 가장 만족스러우면 5점인 경우 오늘 받은 서비스에 얼마나 만족하시나요? |
|
| 2 | |
| 이 경험을 개선할 수 있도록 의견을 보내 주세요. | |
| 일부 질문에 대한 답변을 받지 못했습니다. | |
| 의견을 보내 주셔서 감사합니다. 불편을 끼쳐 드려 죄송합니다. 다음에 더 나은 서비스를 제공하기 위해 최선을 다하겠습니다. |
최근 의견
마지막 의견 확인 웹훅의 응답은 최종 사용자가 최근에 의견을 제공했음을 나타내므로 에이전트가 사용자에게 추가 입력을 요청하지 않습니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 문의해 주셔서 감사합니다. |
입력이 잘못되었습니다.
마지막 의견 확인 웹훅의 응답은 최종 사용자가 최근에 의견을 제공하지 않았음을 나타냅니다. 에이전트가 사용자에게 의견 점수를 요청하고 사용자가 잘못된 입력을 여러 번 제공합니다. 이 구성요소는 오류와 함께 흐름을 종료합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 전화해 주셔서 감사합니다. 보내주시는 의견은 저희에게 큰 힘이 됩니다. 잠시 시간을 내어 몇 가지 간단한 질문에 답해서 오늘 받은 서비스에 대한 의견을 공유해 주세요. 1~5까지의 기준에서 가장 불만족스러우면 1점, 가장 만족스러우면 5점인 경우 오늘 받은 서비스에 얼마나 만족하시나요? |
|
| -1 | |
| 죄송하지만 잘 알아듣지 못했습니다. 1, 2, 3, 4, 5라는 의견 점수를 보내주세요. | |
| 100 | |
| 죄송하지만 잘 알아듣지 못했습니다. 1, 2, 3, 4, 5라는 의견 점수를 보내주세요. | |
| 좋습니다. | |
| 죄송합니다. 최대 재시도 횟수를 초과했습니다. 잠시 후 다시 시도해 주세요. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 의견 |
| 매개변수 | [param_name] | feedback_score |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_feedback:last_feedback_check |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자의 현지 전화번호로, API 요청에서 사용자를 식별하는 데 사용됩니다. 전화번호에는 국가 코드가 포함되어서는 안 됩니다. | 문자열 |
| $flow.minimum_feedback_score | 이 매개변수는 부정적 또는 긍정적 의견 점수로 간주되는 기준점을 나타냅니다. 낮은 점수(이 매개변수의 값보다 작거나 같음)는 부정적인 경험을 나타내고 높은 점수(이 매개변수의 값보다 큼)는 긍정적인 경험을 나타냅니다. 최종 사용자가 낮은 점수를 제공한 경우 사용자에게 정성적 의견을 요청하여 경험을 개선할 수 있는 방법을 묻습니다. 이 매개변수의 기본값은 3입니다. |
정수 |
| $flow.feedback_max_retry_count | 이 매개변수는 사용자에게 제공되는 최대 재시도 횟수를 캡처하는 구성 가능한 매개변수입니다. 이 매개변수에 할당된 값은 사용 가능한 시도 횟수보다 작아야 합니다. 기본값은 2이며 이 경우 호출자가 요청된 정보를 제공하려고 세 번 시도한다는 의미입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| feedback_score | 이 매개변수는 최종 사용자가 제공한 의견 점수를 캡처합니다. 유효한 값은 1부터 5까지의 정수입니다. | 정수 |
| feedback_comment | 이 매개변수는 최종 사용자가 제공한 정성적 의견을 캡처합니다(있는 경우). | 문자열 |
| 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_feedback:last_feedback_check 웹훅은 구성요소에서 사용자가 최근에 의견을 제공했는지 확인하는 데 사용됩니다. 이전에 제공된 의견이 최근으로 간주되는 기간은 서비스 소유자가 구성할 수 있는 이 웹훅과 통합된 외부 서비스에 의해 정의됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 정수 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| last_feedback_time_elapsed | 사용자가 최근에 의견을 제공했는지 여부를 나타냅니다. true는 사용자가 마지막으로 의견을 보낸 후 경과한 기간과 최근 의견을 찾을 수 없음을 나타냅니다. false는 최근에 의견이 제공되었고 사용자가 마지막으로 의견을 보낸 후 경과한 시간이 충분하지 않음을 나타냅니다. |
부울 |
이 구성요소에 대한 마지막 의견 확인 웹훅을 구성하려면 안내를 펼치세요.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_feedback:last_feedback_check 웹훅을 선택합니다.
- Dialogflow CX 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
의견 업데이트
prebuilt_components_feedback:update_feedback 웹훅은 구성요소에서 수집된 의견을 외부 서비스에 전송하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| feedback_score | 이 매개변수는 최종 사용자가 제공한 피드백 점수를 저장합니다. 예상 값은 1부터 5까지의 정수입니다. | 정수 |
| feedback_comment | 이 매개변수는 최종 사용자가 제공한 정성적 의견 주석을 저장합니다. | 문자열 |
이 구성요소의 의견 업데이트 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_feedback:update_feedback 웹훅을 선택합니다.
- Dialogflow CX 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.