본 방법에서는 사용자에게 매일 선호하는 위치의 날씨 업데이트를 제공해야 하는 여행 봇 시나리오를 살펴보겠습니다. 같은 작업을 달성하기 위해 경고 작업을 사용하겠습니다. 또한 이 경고 작업에서 자동 구독을 활성화하여 스마트 상태로 만드는 방법도 확인하겠습니다. 경고 작업의 정의와 Kore.ai 봇 플랫폼에서 경고 작업이 어떻게 구현되는지에 대한 자세한 내용은 여기를 참조하세요.
문제 설명
봇의 등록된 사용자는 사전 지정된 시간 또는 지정된 시간 간격으로 알림 형태의 날씨 업데이트를 전송해야 합니다.
본 문서에서는 이러한 상황을 충족하고 적절한 조치를 취하는 데 경고 작업이 어떻게 사용될 수 있는지 설명합니다.
전제 조건
- 봇 구축 기본 지식.
- 작업 중인 봇, 뱅킹 봇을 사용합니다.
- 날씨 업데이트를 제공하는 웹 서비스에 액세스합니다. 다음에서 호스팅 되는 REST 서비스를 사용합니다: http://api.openweathermap.org. 이 서비스를 사용하려면 무료 알림 서비스에 등록해야 합니다. API 키를 사용하여 해당 API에 액세스하겠습니다.
구현
경고 작업 설정
경고 작업을 사용하여 실시간으로 또는 사용자 정의된 일정에 따라 관련 서비스를 폴링하여 엔터프라이즈 시스템에서 고객 및 직원에게 적시에 관련 있는 맞춤형 정보를 전달할 수 있습니다. 단계:
- 구축 -> 대화형 스킬에서 경고 작업을 추가합니다.
- 작업 세부 정보 페이지에서:
- 작업 이름(예: 일별 날씨 가져오기)을 입력합니다.
- 연결 유형을 선택합니다. Webservice로 선택하겠습니다.
- 연결 모드를 선택합니다. REST를 사용하겠습니다.
- 생성 및 진행 클릭
- 알림 설정 페이지로 바로 이동합니다
- 필요하다면 일반 설정을 검토하고 수정합니다. 이 활용 사례에서는 설정을 수정할 필요가 없습니다.
- API 요청 탭 선택
- 콘텐츠 유형이 JSON으로 설정되어 있는지 확인
- 활용 사례에 대해 인증 공급자를 설정할 필요가 없습니다. 사용 중인 API에 인증 요건이 있는 경우 동일하게 설정합니다.
- 매개 변수를 설정하여 사용자로부터 선호 도시를 수집합니다. 필수 필드로 설정되었는지 확인합니다. 이는 API 요건입니다.
- 활용 사례에는 초기화 요건이 필요하지 않습니다. 요청을 전송하기 전에 JavaScript를 실행해야 한다면 이 옵션을 사용합니다.
- 요청에서 API 추가를 클릭하여 호출되어야 하는 서비스 API를 추가합니다. 다음과 같은 API에서 GET 메서드를 사용하고 있습니다.
http://api.openweathermap.org/data/2.5/weather?q={cityname}&APPID=<your-app-id>- 위 URL의 APPID는 가입할 때 OpenWeather에서 사용자에게 할당됩니다. 계정에 로그인한 후 API 키 섹션에서 찾을 수 있습니다.
- 매개 변수 목록이 이전에 입력한 매개 변수로 자동으로 채워집니다.
- API를 저장합니다.
- API를 테스트하여 설정이 올바른지 확인합니다. 메시지가 표시되면 샘플 도시 이름을 입력하고 성공 메시지와 적절한 응답을 수신하는지 확인합니다.
- 응답을 저장합니다.
- 다음으로 봇 응답의 형식을 지정해야 합니다. 이 활용 사례에서는 사용자에게 보여주기 위해 API 호출이 반환하는 날씨 설명, 온도 및 습도 세부 정보를 파싱합니다. 다음과 같은 풍부한 텍스트를 사용하여 동일한 결과를 얻을 수 있습니다:
오늘 날씨 세부 정보: <%=weather[0].description%> 온도: <%=main.temp%> 습도: <%=main.humidity%>
API 호출이 반환하는 값은 변수 키 옵션에서 액세스할 수 있습니다. 변수 키를 클릭하면 요청/응답 키 창이 열립니다. 사용할 수 있는 다양한 변수가 분류되어 있습니다. 응답 키 섹션을 확장하여 API 호출의 응답에 액세스하고 표시하고자 하는 값의 키를 선택한 다음 확인을 클릭합니다. 그러면 키가 적절한 형식으로 에디터에 삽입됩니다.(예시는 다음 섹션에서 확인)<%=weather[0].description%>
- 메시지 정의를 저장합니다.
- 설정 탭을 선택하고 일정 섹션을 확장합니다. 이 섹션을 사용하여 초기 일정을 설정합니다. 이러한 옵션은 초기 설정을 위해 사용자가 선택할 수 있도록 제공됩니다. 예를 들어, 이 예에서는 스케줄을 매일 오전 10:30으로 설정한 후 4시간마다 업데이트하도록 설정했습니다. 사용자는 오전 10시 30분에 한 번만 선택하면 추가 업데이트를 받지 않습니다.
- 설정 마무리
실행
봇을 게시하고 사용자와 공유하기 전에 봇과 대화 기능에서 이를 테스트할 수 있습니다.
- 봇과 대화를 실행합니다.
- 일정 작업을 시작하고 일별 날씨 가져오기(설정한 경고 작업의 이름)를 합니다.
- 도시 이름을 입력하라는 메시지가 표시됩니다.
- 그런 다음 특정 시간을 입력하라는 메시지가 표시됩니다. 시간을 입력하거나 “매 x 분”을 입력할 수 있습니다.
- 입력한 시간이 설정한 일정 시간과 일치하지 않으면 가장 가까운 시간이 표시됩니다. 빈도 설정도 마찬가지입니다.
- 이 설정은 한 번만 가능합니다. 이 시점부터 이 봇에 대한 봇과 대화를 실행할 때마다 지정된 시간에 날씨 알림이 표시됩니다.
- 사용자는 다른 대화 작업과 마찬가지로 경고 작업 이름을 사용하여 작업을 트리거하고 알림을 수동으로 설정할 수 있습니다. 사용자가 봇 사용을 시작할 때 경험하게 되는 경험은 위에서 언급한 흐름과 비슷합니다.
스마트 알림
알림 구독 서비스 유형 서비스 노드를 추가하여 사용자에 대한 알림을 자동으로 설정할 수 있습니다.(예: 환영 대화 작업) 참고 사항: 게시된 경고 작업만 알림 구독에 사용할 수 있습니다.
- 대화에서 경고 작업에 대한 트리거 역할을 할 서비스 노드를 추가합니다.
- 서비스 유형을 알림 구독 서비스로 설정합니다.
- 요청 정의를 클릭하고 이미 설정된 경고 작업을 선택합니다. 이 경우 일별 날씨 가져오기입니다. 참고 사항: 게시된 경고 작업만 알림 구독에 사용할 수 있습니다.
- 스마트/자동 알림 창으로 이동합니다.
- 필요에 따라 알림 매개 변수를 설정합니다.
- 알림 빈도를 설정합니다.
- 알림 만료 값은 구독 기간 또는 전송된 알림 수에 따라 설정할 수 있습니다. 이러한 값은 서비스 구독이 제한된 경우에 유용합니다. 여기에서는 알림 수를 최대값으로 설정했습니다.
- 또한 경고 작업이 업데이트 및 게시될 경우 알림 업그레이드 동작을 정의할 수 있습니다.
- 저장합니다
- 환영 또는 onConnect 이벤트에서 이 작업을 트리거 하여 사용자가 선호하는 도시 및 시간을 입력할 수 있습니다.
- 설치 시 이 서비스 노드에 처음으로 접속하면 사용자 개입 없이 구독이 적용됩니다.