질문 입력

대화 정보를 입력하면 질문을 입력할 수 있는 필드가 활성화됩니다. 질문 필드에는 사용자가 문의할 것으로 예상되는 질문을 입력합니다. 대화 모델은 입력된 질문을 학습하여, 입력된 질문 외에도 유사한 질문까지 이해할 수 있게 됩니다.
질문의 개수는 많을수록 좋으며, 유사한 의도를 가진 일반 질문을 10건 이상 등록하는 것을 권장합니다. 문장의 어미만 확장하여 질문의 개수를 늘리는 것보다 다양한 발화 유형을 입력하는 것이 학습에 더 도움이 됩니다. 예를 들어 사용자가 특정 상품의 요금에 대해 질문한다면 어떻게 물어볼지 생각해보고, 아래와 같이 다양한 발화 유형을 입력합니다.

<예시>

• 00 상품 얼마야
• 얼마면 00 상품 살 수 있니
• 00 상품 비싸니
• 00 상품 가격은
• 요금표 있으면 알려줘
• 00 상품 견적 줄래?
• 00 상품 임직원 할인가 알려줘

질문 등록

질문을 등록하는 방법은 다음과 같습니다.

1. 대화 등록을 참고하여 대화 정보를 입력해 주십시오.
2. 질문 유형을 선택해 주십시오.
   • 일반 질문: 자연어로 입력된 질문
   • 정규식 질문: 정규식 문법을 활용한 질문. 정규식 질문을 입력하는 방법은 정규식 입력 방법 참조
   • 인텐트: 챗봇에 연동된 의도 분류기로부터 전달될 인텐트명 입력. 사용자의 예상 발화를 미리 입력하고 학습하여 챗봇이 의도를 직접 분류하는 것이 아니라, 챗봇과 연동된 의도 분류기에서 분류한 의도(인텐트)를 받아 대화 분석에 활용함
   • Call 이벤트: Call 이벤트를 트리거로 하여 대화를 진행시킬 수 있는 기능. Aicall 서비스에서 음성인식이 시작되는 타이밍에 전달되는 이벤트를 트리거로 하여 대화를 매칭시킴. Aicall 도메인인 경우에만 활성화되는 메뉴. 자세한 내용은 Call 이벤트 참조.
3. 질문을 입력하고 [추가] 버튼을 클릭해 주십시오.
4. 최소 10개의 질문을 입력해 주십시오.
   • 느낌표와 물음표는 대화 모델 학습에 영향을 미치지 않으므로 생략 가능합
   • 같은 대화의 어미만 늘리는 것이 아니라 다양한 대화 입력

질문 일괄 등록

대량의 질문을 엑셀 파일에 입력하여 업로드할 수 있습니다. 업로드 기능을 이용하면 질문을 일일이 입력하지 않고 한 번에 등록할 수 있어서 간편합니다. 질문을 엑셀 파일로 업로드할 경우, 지정된 파일 양식에 맞추어 작성해야 하며 적합하지 않은 양식으로 작성된 경우 업로드에 실패할 수 있습니다.

질문을 일괄 등록하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼의 콘솔에서 Services > CLOVA Chatbot > Domain 메뉴를 차례대로 클릭해 주십시오.
2. 대화를 생성할 도메인의 [빌더 실행하기] 버튼을 클릭하여 챗봇 빌더를 실행해 주십시오.
3. 챗봇 빌더에서 대화 목록 > [업로드] 버튼을 클릭해 주십시오.
4. ‘대화 업로드’ 창이 나타나면 업로드 유형별 [템플릿 다운로드] 버튼을 클릭해 주십시오.
5. 다운로드한 템플릿의 엑셀 파일의 A열에는 질문 유형(‘일반 질문’ 또는 ‘정규식 질문’ 중 선택)을 입력하고 B열에는 추가하려는 질문 내용을 입력한 후, 파일을 저장해 주십시오.
6. 챗봇 빌더의 ‘대화 업로드’ 창에서 업로드 유형을 선택한 후, 질문을 작성한 엑셀 파일을 업로드해 주십시오.
7. [전송 시작] 버튼을 클릭해 주십시오.

질문 이동

등록한 질문을 다른 대화로 이동할 수 있습니다.
질문을 이동하는 방법은 다음과 같습니다.

1. 질문 목록에서 이동할 질문을 선택하고 [이동] 버튼을 클릭해 주십시오.
   

2. 질문 이동 창이 나타나면 이동시킬 대화를 선택하고 [이동] 버튼을 클릭해 주십시오.

Call 이벤트

Call 이벤트를 트리거로 하여 대화를 진행시킬 수 있는 기능입니다. Aicall 서비스에서 음성 인식이 시작될 때 전달되는 이벤트를 트리거로 하여 대화를 매칭시킵니다. Aicall 도메인인 경우에만 지원되는 기능이며, 현재는 Call 이벤트 중 음성인식 재개 이벤트만 지원합니다.

동작 방식

Call 이벤트의 동작 방식은 다음과 같습니다.

• call 이벤트로 음성인식 재개 이벤트가 발생한 경우, 챗봇 빌더의 대화 중에서 음성인식 재개 이벤트가 등록된 대화를 찾습니다.
• 컨텍스트 또는 조건에 부합하는 답변이 있는 경우에는 해당 대화의 답변을 사용자에게 응답하고, 컨텍스트 또는 조건에 부합하는 답변이 없는 경우에는 해당 call 이벤트를 처리하지 않습니다.
• 음성인식 재개 이벤트는 Aicall 서비스에서 음성 인식을 할 때마다 발생하기 때문에 응답할 답변이 존재하지 않는 경우, 해당 이벤트는 처리하지 않습니다.
• 질문 유형이 일반 질문/정규식 질문/인텐트인 경우에 컨텍스트 또는 조건에 부합하는 답변이 없을 때 실패 메시지를 응답하는 것과 동작이 다르므로 주의해 주십시오.

사용 예시

Call 이벤트 기능은 음성 인식이 다시 시작되는 시점에, 챗봇이 먼저 사용자에게 발화를 유도하는 답변을 응답할 때 사용할 수 있습니다. 예를 들어, Aicall 시나리오를 진행하는 중에 음성이 아닌 앱 화면을 통하여 정보를 입력받는 것이 시나리오상 적합한 경우 또는 보안상의 이유로 그러한 시나리오를 수행해야 하는 경우 다음과 같이 설계할 수 있습니다.

택배 수령 주소 변경 시 음성으로 관련 정보를 받지 않고 앱이나 웹으로 정보를 받고자 하는 경우를 예시로 설명합니다.

1. 택배 수령 위치 변경에 대한 대화를 생성해 주십시오.
   • 답변에는 액션메소드 $2{택배수령위치변경앱화면}을 삽입합니다.
   • Output 컨텍스트는 '주소입력앱화면'을 추가합니다.
   • 유지시간은 '30분'으로 설정합니다. 앱이나 웹 화면에서 긴 시간 동안 사용자가 머물 경우에도 컨텍스트를 유지하기 위함입니다.
     
2. $2{택배수령위치변경앱화면}액션메소드의 API에서는 다음의 작업을 수행해 주십시오.
   • 앱이나 웹 화면을 사용자의 휴대전화에 띄워주는 동작을 처리합니다.
   • 사용자가 정보를 입력하는 동안에는 음성 인식을 멈추도록 aicall 서버에 요청합니다.
3. 사용자가 앱이나 웹 하면에 정보 입력을 완료한 경우, 다음의 동작을 수행해 주십시오.
   • 입력된 정보를 내부 서버에서 처리합니다.
   • call로 다시 돌아가기 위해서 음성 인식을 재개하도록 aicall 서버에 요청합니다.
4. 앱이나 웹에서 입력이 끝났으면, call 환경에서 이후 시나리오를 수행하도록 대화를 등록해 주십시오.
   • 음성 인식 재개 이벤트를 트리거로 등록합니다.
   • Input 컨텍스트에는 '주소입력앱화면'을 추가하여 '택배 수령 위치 변경' 대화에서 컨텍스트가 이어지도록 설정합니다.
   • 답변에는 "주소 입력이 완료되었습니다"와 같이 시나리오에 적합한 답변을 입력합니다.
     

음성 인식 중지 요청

Aicall 서버로 음성 인식을 멈추는 요청을 하기 위해서 다음을 참고해 주십시오.

Request 양식

• Http Method : PUT
• Path : /recognition/{sessionId}/control/pause
• parameter
  | Parameter Type | Parameter name | Data Type | Description | Required |
  | --- | --- | --- | --- | --- |
  | Path Parameters | sessionId | String | session id | Required |
  | Query Parameters | contactCenterId | Long | Contact Center id | Required |

요청 예시

curl --location --request PUT 'https://ac86e44bd82542c39b6bfbc2fb6f488a.test-apigw.ntruss.com/write/v1/recogni- tion/8a9c75f8-1ed1-4925-8bed-7d741baf3abe/control/pause?contactCenterId=1' \
--header 'X-CLOVA-AICALL-API-KEY: 90d97f24-6f0b-4d9a-bbf9-ed391b44c6ea' \
--header 'X-CLOVA-AICALL-API-VERSION: 2' \
--header 'X-CLOVA-AICALL-TRACE-ID: caab126fedf14575b66b554f21b84a57'

Response 양식

• Http Status : 204
• Response body는 없습니다.

음성 인식 재개 요청

Aicall 서버로 음성 인식을 다시 시작하는 요청을 하기 위해서는 다음을 참고해 주십시오.

Request 양식

• Http Method : PUT
• Path : /recognition/{sessionId}/control/resume
• parameter

요청 예시

curl --location --request PUT 'https://ac86e44bd82542c39b6bfbc2fb6f488a.test-apigw.ntruss.com/write/v1/recogni- tion/8a9c75f8-1ed1-4925-8bed-7d741baf3abe/control/resume?contactCenterId=1' \
--header 'X-CLOVA-AICALL-API-KEY: 90d97f24-6f0b-4d9a-bbf9-ed391b44c6ea' \
--header 'X-CLOVA-AICALL-API-VERSION: 2' \
--header 'X-CLOVA-AICALL-TRACE-ID: caab126fedf14575b66b554f21b84a57'

Response 양식

• Http Status : 204
• Response body는 없습니다.