Kore.ai 봇 플랫폼에 등록한 후, 다음 단계는 봇을 생성하는 것입니다. 봇을 생성하기 전에, 이 링크에서 봇 구축의 기본을 살펴보는 것이 좋습니다.

이 문서에 제시된 단계를 따라서 원하는 속도로 봇을 구축할 수 있습니다.

또는 단계별 봇 생성 과정의 안내 도움말을 사용할 수 있습니다 안내 도움말에 접근하려면, 다음 단계를 수행하세요.

  1. 유효한 자격 증명으로 Kore.ai 봇 플랫폼에 로그인합니다.
  2. 랜딩 페이지의 오른쪽 상단에서 도움말 아이콘을 클릭합니다.
  3. 페이지 도움말 창에서, 안내 도움말을 사용하여 ‘Hello world’ 봇 구축 옆에 있는 안내 도움말을 클릭합니다.
  4. 사용 사례 목록이 표시됩니다. 시작을 클릭하여 사용 사례를 진행합니다.
  5. 이 문서는 대화 작업 봇(항공편 상태 봇)에 도움이 됩니다.

봇 개요

이 봇은 사용자 선택에 따라 로스앤젤레스 국제공항에서 출발/도착하는 항공편 상태를 알려줍니다. 이 봇은 다음을 수행할 수 있습니다.

  • 사용자에게 도착이나 출발 정보를 알고 싶은지 묻습니다.
  • API에 서비스 호출을 수행하여 공항에 도착 및 출발하는 항공편의 세부 정보를 가져옵니다.
  • 도착 또는 출발에 관한 사용자 설정에 따라 항공편 명을 표시합니다.
  • 사용자에게 항공편 명 선택을 요청합니다.
  • 선택한 항공편의 상태 세부 정보를 표시합니다.
  • 모든 오류를 처리합니다.

봇 구축

표준 봇을 생성할 수 있습니다. 생성하려면 다음 단계를 수행하세요.

  1. Kore.ai 봇 플랫폼 계정에 로그인합니다.
  2. 봇 랜딩 페이지의 오른쪽 상단에서 새 봇을 클릭하고 처음부터 시작 옵션을 선택합니다.
  3. 새 봇 생성 창에서 봇 세부 정보를 입력합니다.
    • 봇 이름 – 봇에 이름을 지정합니다. 예시, 공항 봇. 봇 이름이 이미 사용 중인 경우 다른 이름을 시도합니다.
    • 기본 봇 언어 드롭다운 목록에서 영어를 선택하고 봇 유형 드롭다운 목록에서 표준 봇을 선택합니다.
  4. 생성을 클릭합니다.

대화 작업 생성

봇 생성 후, 봇 요약 페이지로 이동합니다. 첫 번째 단계는 의도 대화를 추가하는 것입니다. 의도 대화는 사용자-봇 대화 흐름의 첫 번째 단계입니다.

  1. 작업 위젯에서 + 새 작업을 클릭하고 대화 작업을 선택합니다.
  2. 대화 페이지에서 다음 세부 정보를 입력합니다.
    • 의도 이름 – 의도 이름을 입력합니다. 대화를 실행하는 구문입니다. 의도 이름은 단순해야 하며 3~4단어를 넘지 않아야 합니다. 예시, 항공편 상태 가져오기.
    •  추가 옵션에서, 설명 및 기타 대화 관련 세부 정보를 추가할 수 있습니다. 기본 설정을 유지합시다.
  3. 진행을 클릭합니다.
  4. 대화 기반 대화 빌더로 업그레이드하라는 메시지가 표시되면, 업그레이드를 선택합니다. 이전 대화 빌더의 지시 사항은 여기를 참조하세요
  5. 사용자 의도 창에는, 기본적으로, 대화 빌더 패널이 표시됩니다.
  6. 대화 빌더 창을 닫습니다. 대화 빌더를 직접 사용하여 대화 작업을 구축합니다.

사용자 기본 설정 엔티티 노드 생성

엔티티 노드는 사용자에게 정보를 수집하는 데 일반적으로 사용됩니다. 도착이나 출발 세부 정보의 사용자 기본 설정을 캡처하는 데 사용합시다.

  1. 사용자 의도 노드 옆에 있는 + 아이콘을 클릭합니다.
  2. 엔티티 > + 새 엔티티를 선택합니다.
  3. 왼쪽 노드 패널에서 엔티티를 끌어서 놓을 수도 있습니다.
  4. 새로 추가된 엔티티 노드를 클릭하여 엔티티 창을 엽니다.
  5. 기본적으로, 구성 요소 속성 탭이 선택되어 있습니다.
    1. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
      • 이름: 기본 설정
      • 표시 이름: 기본 설정 
      • 유형: 드롭다운 목록에서 열거된 항목의 리스트를 선택합니다. 사용자가 선택할 수 있는 값 목록을 제공할 수 있습니다. 값 목록을 추가하려면,
        • 필드 옆에 있는 설정 아이콘을 클릭합니다.
        • 정적 목록 옵션을 선택합니다.
        • 사용할 키 및 값 섹션에서, 디스플레이 이름을 도착출발로 별도 행에 입력합니다. 동의어 열은 자동으로 채워지므로 그대로 둡니다.
        • 저장을 클릭합니다.
        • 엔티티 창으로 돌아갑니다.
    2. 사용자 프롬프트 섹션에서, 다음 텍스트를 입력합니다.
      Hello {{context.session.UserContext.firstName}}! Welcome to *Los Angeles International Airport*. I can help you with flight Arrival/Departure information. Please select your preference.
      참고: 컨텍스트 변수는 사용자의 이름을 검색합니다. 또한 공항 이름이 굵게 표시되도록 마크다운을 사용합니다.
    3. 값 목록 표시 섹션에서, 네, 기본 메시지의 채널별 표준 형식 지정을 사용하고 사용 가능한 값 목록을 최종 사용자에게 표시합니다 옵션을 선택합니다. 이렇게 하면, 지원하는 채널에서 버튼 템플릿으로서 값 목록이 표시됩니다.
  6. 엔티티 창을 닫습니다.

서비스 노드 생성

서비스 봇 조치 노드를 사용하면 백엔드 API를 호출할 수 있습니다. 여기서 서비스 노드는 API를 호출하여 LAX 공항의 출발 및 도착 항공편 정보를 얻는 데 사용됩니다. 이 튜토리얼에서는 더미 API 설정이 사용됩니다.

  1. 기본 설정 엔티티 노드 옆에 있는 + 아이콘을 클릭합니다.
  2. 봇 조치 > + 새 봇 조치를 선택합니다.
  3. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: FlightDetails
    • 표시 이름: Flight Details
  4. 봇 조치 노드 옆에 있는 +를 클릭하여 봇 조치를 확장합니다.
  5. 봇 조치 노드 내에서 +를 클릭합니다
  6. 서비스 > + 새 서비스를 선택합니다.
    • 서비스 노드는 백엔드 API를 호출하여 LAX 공항의 출발 도착 항공편 정보를 얻는 데 사용합니다.
  7. 서비스 노드를 클릭하여 서비스 창을 엽니다. 기본적으로, 구성 요소 속성 탭이 선택되어 있습니다.
  8. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: Fetchflightdetails
    • 표시 이름: Fetch Flight Details
    • 서비스 유형: 맞춤형 서비스
    • 유형: Webservice
    • 하위 유형: REST
    • 요청 정의 섹션에서, 요청 정의를 클릭합니다.
    • 요청 정의 페이지에서, 다음 세부 정보를 입력합니다.
      • 요청 유형GET
      • 요청 URLhttp://5e85a56644467600161c6579.mockapi.io/FlightDetails
        이 API는 인증 또는 헤더 매개 변수가 필요하지 않습니다.
      • 요청 테스트 탭을 클릭합니다.
        • 오른쪽 상단의 테스트를 클릭합니다.
        • 테스트 완료를 기다리면 상태 코드 200을 받습니다.
        • 샘플 응답으로 저장을 클릭합니다.
        • 저장을 클릭합니다.

    • 대화 빌더로 돌아갑니다
  9. 연결 섹션에서 기본 연결 규칙을 봇 조치의 끝으로 설정합니다
  10. 서비스 창을 닫습니다.
  11. 봇 조치 노드를 축소합니다.

항공편 선택 엔티티 노드 생성

이 엔티티 노드는 사용자가 상태 세부 정보를 원하는 항공편 명을 캡처하기 위한 것입니다.

  1. Flight Details 봇 조치 노드 옆에 있는 + 아이콘을 클릭합니다.
  2. 엔티티 > 새 엔티티 노드 +를 선택합니다.
    • 엔티티 노드는 사용자가 선택한 항공편 명을 캡처하는 데 필요합니다.
  3. 엔티티 창에서, 기본적으로, 구성 요소 속성 탭이 선택되어 있습니다.
  4. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: SelectFlight
    • 표시 이름: Select Flight 
    • 유형: 문자열(사용자는 사용자 정의 스크립트를 작성하여 다음 단계를 거쳐 API 문자열 출력을 값 목록으로 변환할 수 있습니다. 이는 사용된 더미 API의 요건입니다)
  5. 사용자 프롬프트 섹션에서, 다음 텍스트를 입력합니다.
    Please provide the flight number.

    • 관리: 사용자는 웹 SDK 채널에 특정 프롬프트를 정의할 수 있습니다.
    • 관리를 클릭합니다.
    • 프롬프트 메시지 추가를 클릭합니다.
    • 새 프로프트 메시지 창의 채널 드롭다운 목록에서 웹/모바일 클라이언트를 선택합니다.
    • 메시지 섹션에서, JavaScript 탭을 클릭합니다.
    • 다음 JavaScript를 입력합니다. JavaScript는 API 호출의 문자열 출력에서 사용자 기본 설정과 일치하는 항공편 명을 추출하여 빠른 응답 형식으로 표시합니다.
      var data = context.Fetchflightdetails.response.body.details;
      context.flights = [];
      context.info;
      var msg;
      for (var i = 0; i < data.length; i++)
      {
          if (context.entities.Preference == data[i].Type)
          {
              var details = {
                  "Airlines" : data[i].Airlines,
                  "FlightNo" : data[i].FlightNo,
                  "Airport" : data[i].Airport,
                  "AirportName" : data[i].AirportName,
                  "Time" : data[i].Time
              };
              context.flights.push(details);
          }
      }
      var message = {
          "type" : "template",
          "payload" : {
             "template_type" : "quick_replies",
             "text" : "Here are the flights " + context.entities.Preference + " details for Los Angeles International Airport today. Please select the flight number to see details",
             "quick_replies" : []
          }
      };
      for (i=0; i < context.flights.length; i++)
      {
         var replies = {
              "content_type":"text",
              "title" : context.flights[i].FlightNo,
              "payload" : context.flights[i].FlightNo
          };
      message.payload.quick_replies.push(replies);
      }
      return JSON.stringify(message);
  6. 저장을 클릭합니다.
  7. 대화 빌더로 돌아가서 엔티티 창을 닫습니다.

스크립트 노드 생성

스크립트 노드는 대화 작업에서 사용자 정의 JavaScript를 작성하는 데 사용합니다. 여기서, 사용자는 스크립트를 사용하여 선택한 항공편 세부 정보를 추출할 수 있습니다. 이후 사용자는 이 스크립트에 더 많은 기능을 추가할 수 있습니다.

  1. Select Flight 엔티티 노드 옆에 있는 + 아이콘을 클릭합니다.
  2. 봇 조치 + 새 봇 조치를 선택합니다.
  3. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: Flight Validation
    • 표시 이름: Flight Validation 
  4. 봇 조치 노드 옆에 있는 +를 클릭하여 봇 조치를 확장합니다.
  5. 봇 조치 노드 내에서 +를 클릭합니다
  6. 스크립트 > 새 스크립트 노드 +를 선택합니다.
  7. 스크립트 창에서 기본적으로 구성 요소 속성 탭이 선택되어 있습니다.
  8. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: ValidateFlight
    • 표시 이름: Validate Flight 
  9. 스크립트 정의 섹션에서 스크립트 정의하기를 클릭합니다.
  10. 스크립트 추가 대화 상자에서 다음 JavaScript를 복사합니다. 이 코드는 선택한 항공편 명의 세부 정보를 추출합니다.
    context.details;
    var x = context.flights.length;
    for (var l = 0; l < x; l++)
    {
        if (context.entities.SelectFlight == context.flights[l].FlightNo)
        {
             context.details = {
                "Airlines" : context.flights[l].Airlines,
                "FlightNo" : context.flights[l].FlightNo,
                "Airport" : context.flights[l].Airport,
                "AirportName" : context.flights[l].AirportName,
                "Time" :context.flights[l].Time
            };
            break;
        }
    }
  11. 저장을 클릭합니다.
  12. 연결 섹션에서 기본 연결 규칙을 봇 조치의 끝으로 설정합니다
  13. 스크립트 창을 닫습니다.
  14. 봇 조치 노드를 축소합니다.

메시지 노드 생성

메시지 노드는 봇이 사용자에게 보내는 메시지를 표시하는 데 사용됩니다. 여기서, 사용자는 메시지 노드를 사용하여 사용자 기본 설정에 따라 적절한 항공편 세부 정보를 표시할 수 있습니다.

  1. 항공편 검증 스크립트 노드 옆에 있는 + 아이콘을 클릭합니다.
  2. 메시지 > 새 메시지 노드 +를 선택합니다.
  3. 메시지 창에서 기본적으로 구성 요소 속성 탭이 선택되어 있습니다.
  4. 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
    • 이름: FlightDetails
    • 표시 이름: Flight Details 
  5. 봇 응답 섹션에서, 다음 텍스트를 입력합니다.
    Here are your flight details.
  6. Enter를 클릭하여 저장합니다.
  7. 프롬프트 관리: 사용자는 웹 SDK 채널에 특정 프롬프트를 정의할 수 있습니다.
  8. 관리를 클릭합니다.
    1. 봇 응답 관리 페이지에서 봇 응답 추가를 클릭합니다.
    2. 채널 드롭다운 목록에서 웹/모바일 클라이언트를 선택합니다.
  9. 메시지 섹션에서, JavaScript 탭을 클릭합니다.
  10. 다음 JavaScript를 복사합니다. 이 JavaScript는 형식으로 항공편 세부 정보를 표시하기 위해 작성되었습니다.
    var message = {
     "type": "template",
     "payload": {
     "template_type": "mini_table",
     "layout": "horizontal",
     "text":"Flight " + context.entities.Preference + " Information" ,
     "elements": [
     {
     "primary":[["Flight No"], [context.details.FlightNo, "right"]],
     "additional":[["Airlines", context.details.Airlines],["From",context.details.Airport],["Time",context.details.Time],["Remarks","On Time"]]
     }
     ]
    }
    };
    print(JSON.stringify(message));
  11. 저장을 클릭합니다.
  12. 메시지 창으로 돌아갑니다.
  13. 메시지 창에서, 연결 탭을 클릭합니다.
    • 드롭다운 목록에서, 연결되지 않음에서 대화의 끝으로 기본 연결을 변경합니다.
    • 저장을 클릭합니다.
  14. 메시지 창을 닫습니다.

봇 테스트

대화 작업 테스트를 위해, 오른쪽 하단의 봇과 대화 옵션을 사용할 수 있습니다.

  1. 발화(의도 이름) 항공편 상태를 알려주세요를 입력합니다.
  2. 봇 지시 사항을 따릅니다.
    • 도착/출발 선택
    • 항공편 명 선택
    • 표 형식으로 표시된 항공편 세부 정보를 확인합니다.

이벤트 추가

현재, 봇은 사용자 입력을 기다리고 있습니다. 또한 봇은 대화 시작 시 사용자를 안내할 수 있습니다. 따라서, 웹/모바일 SDK에서 새 연결이 설정될 때마다 이 작업을 시작하는 이벤트 처리기를 추가할 수 있습니다.

  1. 대화 빌더를 닫고 봇 작업 페이지로 이동합니다.
  2. 왼쪽 탐색 창에서, 인텔리전스 > 이벤트를 선택합니다.
  3. 이벤트 목록에서, On Connect 이벤트에 대한 설정을 클릭합니다.
  4. On Connect 창에서, 기본적으로 작업 시작 옵션이 선택되어 있으므로 그대로 유지합니다.
  5. 드롭다운 목록에서 항공편 상태 가져오기 작업을 선택합니다.
  6. 저장 및 활성화를 클릭합니다.

봇 테스트

대화 작업 테스트를 위해, 오른쪽 하단의 봇과 대화 옵션을 사용할 수 있습니다. onConnect 이벤트가 설정되었으므로, 대화가 자동으로 시작됩니다. 봇 지시 사항을 따릅니다.

  1. 도착/출발 선택
  2. 항공편 명을 선택하는 대신에 목록에 없는 편명을 수동으로 입력합니다.
  3. 죄송합니다. 문제가 발생하여 작업을 삭제했습니다와 같은 일반적인 메시지를 볼 수 있습니다. 다시 시도해주세요”.

다음 단계에서, 이 문제를 해결하는 방법을 확인할 수 있습니다.

스크립트 노드 수정

문자열 유형이 항공편 선택 엔티티에서 사용되므로, 사용자가 목록에서 선택하지 않고, 잘못된 항공편 명을 수동으로 입력한 시나리오를 처리할 수 있습니다. 이 작업은 연결을 기반으로 적절한 메시지를 표시하여 수행할 수 있습니다. 이 단계에서는, 이전에 저장한 스크립트를 수정하여 사용자 항목의 검증을 추가할 수 있습니다.

  1. 대화 빌더 페이지를 엽니다. 두 가지 방법으로 가능합니다
  2. 왼쪽 탐색 창에서 대화형 스킬 -> 대화 작업을 클릭하고 항공편 상태 가져오기 작업을 선택합니다.
  3. 왼쪽 탐색 창에서 요약을 클릭하고 항공편 상태 가져오기 작업을 선택합니다.
  4. 항공편 검증 스크립트 노드를 선택합니다.
  5. 항공편 검증 스크립트 창의 스크립트 정의 섹션에서 스크립트 편집을 클릭합니다.
  6. 스크립트 추가 대화 상자에서 다음 JavaScript를 복사하고 기존 코드를 대체합니다. 사용자가 입력한 항공편 명이 API 서비스 호출에서 반환된 항목과 일치할 때 설정할 유효 태그를 추가할 수 있습니다.
    context.valid = false;
    context.details;
    var x = context.flights.length;
    for (var l = 0; l < x; l++)
    {
        if (context.entities.SelectFlight == context.flights[l].FlightNo)
        {
             context.valid = true;
             context.details = {
                "Airlines" : context.flights[l].Airlines,
                "FlightNo" : context.flights[l].FlightNo,
                "Airport" : context.flights[l].Airport,
                "AirportName" : context.flights[l].AirportName,
                "Time" :context.flights[l].Time
            };
            break;
        }
    }
    if (context.valid === false)
    {
        delete context.entities.SelectFlight;
    }
  7. 항공편 검증 스크립트 창을 닫습니다.

조건부 흐름 생성

다음은 항공편 검증 스크립트 노드에서 조건부 흐름을 추가하는 단계입니다. 이 스크립트 노드에서 새 메시지 노드로 가는 새로운 연결이 형성됩니다. 이것은 봇의 오류 메시지를 사용자에게 표시하고 리디렉션하여 항공편 명을 다시 선택하기 위함입니다.

오류 메시지 생성

  1. 항공편 검증 봇 조치 노드와 항공편 세부 정보 메시지 노드 사이의 연결 위로 마우스를 이동합니다.
  2. 노드 추가 버튼이 나타나면, 클릭합니다.
  3. 새 봇 메시지 노드를 생성합니다.
    • 메시지새 메시지 노드 +를 선택합니다.
    • 메시지 창에는, 기본적으로, 구성 요소 속성 탭이 선택되어 있습니다.
    • 일반 설정 섹션에서, 다음 세부 정보를 입력합니다.
      • 이름: ErrorMessage
      • 표시 이름: Error Message 
    • 봇 응답 섹션에서, 다음 텍스트를 입력합니다.
      The Flight number entered is incorrect. Let us start again.

      • Enter를 클릭하여 저장합니다.
    • 연결 탭을 클릭합니다.
    • 드롭다운 목록에서 연결되지 않음에서 SelectFlight로 기본 연결을 변경합니다.
    • 저장을 클릭합니다.
    • 오류 메시지 창을 닫습니다.

ValidateFlight 스크립트 연결

  1. 항공편 검증 봇 조치 노드를 클릭합니다.
  2. 항공편 검증 봇 조치 창에서 연결 탭을 클릭합니다.
    • + IF 추가를 클릭합니다.
    • IF 섹션에서,
      • 컨텍스트를 선택합니다
      • If 조건의 경우, 유효한 것으로서 텍스트를 입력합니다.
      • 연산자를 equals로 선택합니다.
      • 값을 true로 선택합니다.
      • 이 조건이 참이면, 대화는 FlightDetails로 이동합니다.
      • ELSE 섹션에서,
      • 이 조건이 거짓이면 대화는 ErrorMessage로 이동합니다.
      • 저장을 클릭합니다.
      • 항공편 검증 스크립트 창을 닫습니다.

봇 테스트

대화 작업 테스트를 위해, 오른쪽 하단의 봇과 대화 옵션을 사용할 수 있습니다. onConnect 이벤트가 설정되었으므로, 대화가 자동으로 시작됩니다. 대안으로, 다음 발화(의도 이름) 항공편 상태를 알려주세요를 언제든지 시도할 수 있습니다. 봇 지시 사항을 따릅니다.

  1. 도착/출발 선택
  2. 유효하지 않은 항공편 명을 입력합니다.
  3. 적절한 오류 메시지가 확인되고 항공편 명을 다시 입력하라는 메시지가 표시됩니다.
  4. 항공편 명을 선택합니다.
  5. 표 형식으로 항공편 세부 정보를 확인할 수 있습니다.

성공적으로 첫 번째 봇을 생성하고 테스트했습니다. 다음 단계는 다음과 같습니다.

  • 항공편 상태를 알고 싶습니다, QR040의 상태는 어떠합니까?와 같은 다양한 사용자 발화에 응답하도록 봇을 학습시킵니다 봇 학습시키기를 통해 이를 달성할 수 있습니다.
  • 사용자가 접근하도록 채널을 활성화하고 봇을 게시합니다. 자세한 내용은 여기를 확인하세요.

Kore.aiボットプラットフォームにサインアップしたら、次のステップはボットを作成することです。ボットを作成する前に、このリンクからボット構築の基本を確認することをお勧めします。このドキュメントに記載されているステップに従って、自分のペースでボットを構築するか、ガイド付きヘルプを使用して段階的にボット作成プロセスを実行できます。ガイド付きヘルプにアクセスするには、次のステップに従います:

  1. 有効な資格情報を使用してKore.aiボットのプラットフォームにログインします。
  2. ランディングページで、右上のヘルプアイコンをクリックします。
  3. 「ページヘルプ」ウィンドウで、ガイド付きヘルプを使用して「Hello world」ボットを構築する」の横にあるガイド付きヘルプをクリックします。
  4. ユースケースのリストが表示されます。開始をクリックして、ユースケースを続行します。
  5. このドキュメントは、ダイアログタスクボット(フライトステータスボット)であなたを支援します。

ボットの概要

このボットは、ユーザーの選択に応じて、ロサンゼルス国際空港に到着/出発するフライトステータスを提供します。このボットは次のことができます:

  • ユーザーに到着または出発について知りたいかどうかを尋ねます。
  • APIにサービスコールをして、空港を発着するフライトの詳細を取得します。
  • 到着または出発のユーザー設定に基づいてフライトナンバーを表示します。
  • ユーザーにフライトナンバーを選択するように要求します。
  • 選択されたフライトステータスの詳細を表示します。
  • エラーがあれば処理します。

ボットを構築する

標準ボットを作成できます。作成するには、次の手順に従います。

  1. あなたのKore.aiボットプラットフォームアカウントにログインします。
  2. ボットのランディングページで、右上の新しいボットをクリックし、最初から開始オプションを選択します。
  3. [新しいボットの作成]ウィンドウで、ボットの詳細を入力します
    • ボット名-あなたのボットに名前を付けます。たとえば、エアポートボット。名前がすでに使用されている場合は、何か別の名前を試してください。
    • デフォルトのボット言語ドロップダウンリストから「Japanese」を、ボットタイプドロップダウンリストから標準ボットを選択します。
  4. 作成をクリックします

ダイアログタスクを作成

ボットの作成後、ボットの概要ページに移動します。最初のステップは、インテントダイアログを追加することです。インテントダイアログは、ユーザーとボットの会話フローの最初のステップです。

  1. タスクウィジェットで、新しいタスクを追加をクリックし、ダイアログタスクを選択します。
  2. [ダイアログの作成]ページで、次の情報を入力します。
    • インテント名-インテント名を入力します。これは、ダイアログをトリガーするフレーズです。インテント名は単純で、10〜15文字以内である必要があります。たとえば、「フライトステータスの取得」です。
    •  その他のオプションで、説明やその他のダイアログ関連の詳細を追加できます。デフォルト設定のままにしておきましょう。
  3. 続行をクリックします。
  4. 会話駆動型ダイアログビルダーにアップグレードするように求められますので、アップグレードを選択します。古いダイアログビルダーの手順については、こちらを参照ください
  5. [ユーザーインテント]ウィンドウには、デフォルトで会話ビルダーパネルが表示されます。
  6. 会話ビルダーウィンドウを閉じます。ダイアログビルダーを直接使用して、ダイアログタスクを構築します。

ユーザー設定エンティティノードを作成

通常エンティティノードは、ユーザーから情報を収集するために使用されます。これを使用して、到着又は出発の詳細に関するユーザーの好みをキャプチャします。

  1. ユーザーインテントノードの横にある+アイコンをクリックします
  2. エンティティ > 新しいエンティティを追加を選択します。
  3. 左側のノードパネルからエンティティをドラッグアンドドロップすることもできます。
  4. 新しく追加されたエンティティノードをクリックして、エンティティウィンドウを開きます。
  5. デフォルトでは、コンポーネントのプロパティタブが選択されています。
    1. 一般設定セクションで、次の情報を入力します:
      • 名前好み
      • 表示名好み 
      • タイプ:ドロップダウンリストから「List of Items (enumerated)」を選択します。ユーザーが選択できる値のリストを提供できます。値のリストを追加するには、
        • フィールドの横にある設定アイコンをクリックします。
        • 静的リストオプションを選択します。
        • 使用するキーと値セクションで、表示名到着出発として別々の行に入力します同義語列は自動入力されるので、そのままにしておきます。
        • 「保存」をクリックします。
        • エンティティウィンドウに戻ります。
    2. ユーザープロンプトセクションで、次のテキストを入力します: Hello {{context.session.UserContext.firstName}}! Welcome to *Los Angeles International Airport*. I can help you with flight Arrival/Departure information. Please select your preference. メモ:コンテキスト変数は、ユーザー名を取得します。また、空港名を太字で表示するためにマークダウンが使用されます。
    3. 値の一覧の表示セクションで、[はい、デフォルトメッセージにチャネル専用の標準フォーマットを使用し、利用可能な値のリストをエンドユーザーに表示します]オプションを選択します。これにより、サポートされているチャネルでボタンテンプレートとして値のリストが表示されます。
  6. エンティティウィンドウを閉じます。

サービスノードを作成

サービスボットアクションノードを使用すると、バックエンドAPI呼び出しを行うことができます。ここでは、APIを呼び出すてめにサービスノードを使用し、LAX空港発着のフライトのフライト情報を取得します。このチュートリアルでは、ダミーのAPIセットアップが使用されます。

  1. 設定エンティティノードの横にある+アイコンをクリックします。
  2. ボットアクション>新しいボットアクションを追加を選択します。
  3. 一般設定セクションで、次の情報を入力します:
    • 名前フライトの詳細
    • 表示名フライトの詳細
  4. ボットアクションノードの横にある+をクリックして、ボットアクションを展開します。
  5. ボットアクションノード内から[+]をクリックします
  6. サービス>[+新しいサービスを選択します。
    • サービスノードは、バックエンドAPI呼び出し、LAX空港のフライトのフライト情報を取得するために使用されます。
  7. サービスノードをクリックしてサービスウィンドウを開きます。デフォルトでは、コンポーネントのプロパティタブが選択されています。
  8. 一般設定セクションで、次の情報を入力します:
    • 名前フライトの詳細を取得
    • 表示名フライトの詳細を取得
    • サービスの種類カスタムサービス
    • タイプWebサービス
    • サブタイプレスト
    • リクエストの定義セクションで、「リクエストの定義」をクリックします。
    • リクエストの定義ページで次の詳細を入力します。
      • リクエストタイプGET
      • リクエストURLhttp://5e85a56644467600161c6579.mockapi.io/FlightDetails このAPIは認証又はヘッダーパラメーターを必要としません。
      • テストリクエストタブをクリックします
        • 右上のテストをクリックします。
        • テストが完了すると、ステータスコード200が表示されます。
        • サンプル応答として保存をクリックします。
        • 「保存」をクリックします。

    • ダイアログビルダーに戻ります
  9. 接続セクションで、デフォルトの接続ルールボットアクションの終了に設定します
  10. サービスウィンドウを閉じます。
  11. ボットアクションノードを折りたたみます。

フライト選択エンティティノードの作成

このエンティティノードは、ユーザーがステータスの詳細を必要とするフライトナンバーを取得するためのものです。

  1. フライトの詳細ボットアクションノードの横にある+アイコンをクリックします。
  2. エンティティ > 新しいエンティティノード追加を選択します。
    • エンティティノードは、ユーザーが選択したフライトナンバーを取得するために必要です。
  3. エンティティウィンドウでは、デフォルトでコンポーネントのプロパティタブが選択されています。
  4. 一般設定セクションで、次の情報を入力します:
    • 名前フライトを選択
    • 表示名フライトを選択 
    • タイプ文字列(ユーザーは、次の手順でAPI文字列出力を値のリストに変換するカスタムスクリプトを作成できます。これは、使用するダミーAPIの要件です)
  5. ユーザープロンプトセクションで、次のテキストを入力します。 Please provide the flight number.
    • 管理:ユーザーは、Web SDKチャネルの特定のプロンプトを定義できます。
    • 管理をクリックします
    • プロンプトメッセージを追加をクリックします。
    • 新しいプロンプトメッセージウィンドウで、チャネルドロップダウンリストから[Web /モバイルクライアント]を選択します。
    • メッセージセクションで、JavaScriptタブをクリックします。
    • 次のJavaScriptを入力します。JavaScriptは、API呼び出しから出力された文字列からユーザーの好みに一致するフライトナンバーを抽出し、クイック返信フォーマットで表示します。
      var data = context.Fetchflightdetails.response.body.details;
      context.flights = [];
      context.info;
      var msg;
      for (var i = 0; i < data.length; i++)
      {
          if (context.entities.Preference == data[i].Type)
          {
              var details = {
                  "Airlines" : data[i].Airlines,
                  "FlightNo" : data[i].FlightNo,
                  "Airport" : data[i].Airport,
                  "AirportName" : data[i].AirportName,
                  "Time" : data[i].Time
              };
              context.flights.push(details);
          }
      }
      var message = {
          "type" : "template",
          "payload" : {
             "template_type" : "quick_replies",
             "text" : "Here are the flights " + context.entities.Preference + " details for Los Angeles International Airport today. Please select the flight number to see details",
             "quick_replies" : []
          }
      };
      for (i=0; i < context.flights.length; i++)
      {
         var replies = {
              "content_type":"text",
              "title" : context.flights[i].FlightNo,
              "payload" : context.flights[i].FlightNo
          };
      message.payload.quick_replies.push(replies);
      }
      return JSON.stringify(message);
  6. 「保存」をクリックします。
  7. ダイアログビルダーに戻り、エンティティウィンドウを閉じます。

スクリプトノードの作成

スクリプトノードは、ダイアログタスクでカスタムJavaScriptを作成するために使用されます。ここで、ユーザーは選択したフライトの詳細を抽出するためにスクリプトを使用できます。後で、ユーザーはこのスクリプトに更に機能を追加できます。

  1. フライトエンティティの選択ノードの横にある+アイコンをクリックします。
  2. ボットアクション> 新しいボットアクションを追加を選択します。
  3. 一般設定セクションで、次の情報を入力します:
    • 名前フライトの検証
    • 表示名フライトの検証 
  4. ボットアクションノードの横にある+をクリックして、ボットアクションを展開します。
  5. ボットアクションノード内から[+]をクリックします
  6. スクリプト> 新しいスクリプトノード追加を選択します。
  7. スクリプトウィンドウでは、デフォルトでコンポーネントのプロパティタブが選択されています。
  8. 一般設定セクションで、次の情報を入力します:
    • 名前フライトの検証
    • 表示名フライトの検証 
  9. スクリプト定義セクションで、スクリプトの定義をクリックします。
  10. [スクリプトの追加]ダイアログボックスで、次のJavaScriptをコピーします。このコードは、選択したフライトナンバーの詳細を抽出します。
    context.details;
    var x = context.flights.length;
    for (var l = 0; l < x; l++)
    {
        if (context.entities.SelectFlight == context.flights[l].FlightNo)
        {
             context.details = {
                "Airlines" : context.flights[l].Airlines,
                "FlightNo" : context.flights[l].FlightNo,
                "Airport" : context.flights[l].Airport,
                "AirportName" : context.flights[l].AirportName,
                "Time" :context.flights[l].Time
            };
            break;
        }
    }
  11. 「保存」をクリックします。
  12. 接続セクションで、デフォルトの接続ルールボットアクションの終了に設定します
  13. スクリプトウィンドウを閉じます。
  14. ボットアクションノードを折りたたみます。

メッセージノードの作成

メッセージノードは、ボットからユーザーへのメッセージを表示するために使用されます。ここで、ユーザーはメッセージノードを使用して、ユーザーの好みに合わせて適切なフライトの詳細を表示できます。

  1. フライトスクリプトの検証ノードの横にある+アイコンをクリックします。
  2. メッセージ> 新しいメッセージノード追加を選択します
  3. メッセージウィンドウでは、デフォルトでコンポーネントのプロパティタブが選択されています。
  4. 一般設定セクションで、次の情報を入力します:
    • 名前フライトの詳細
    • 表示名フライトの詳細 
  5. ボットレスポンスセクションで、次のテキストを入力します: Here are your flight details.
  6. 入力をクリックして保存します
  7. プロンプトの管理:ユーザーは、Web SDKチャネルの特定のプロンプトを定義できます。
    • 管理をクリックします。
    • ボットレスポンス管理のページで、ボットレスポンの追加をクリックします。
    • チャネルドロップダウンリストからWeb/Mobile clientを選択します。
    • メッセージセクションで、JavaScriptタブをクリックします。
    • 次のJavaScriptをコピーします。JavaScriptは、フライトの詳細を形式で表示するように作成されています。
      var message = {
       "type": "template",
       "payload": {
       "template_type": "mini_table",
       "layout": "horizontal",
       "text":"Flight " + context.entities.Preference + " Information" ,
       "elements": [
       {
       "primary":[["Flight No"], [context.details.FlightNo, "right"]],
       "additional":[["Airlines", context.details.Airlines],["From",context.details.Airport],["Time",context.details.Time],["Remarks","On Time"]]
       }
       ]
      }
      };
      print(JSON.stringify(message));
    • 「保存」をクリックします。
  1. メッセージウィンドウに戻ります。
  2. メッセージウィンドウで、接続タブをクリックします。
    • ドロップダウンリストから、デフォルトの接続を[未接続]から[ダイアログの終了]に変更します。
    • 保存をクリックします。
  3. メッセージウィンドウを閉じます。

ボットのテスト

ダイアログタスクをテストするには、右下の[ボットと会話]オプションを使用できます。

  1. 発話(インテント名)を入力してくださいフライト状況を教えてください。
  2. ボットの指示に従ってください:
    • 到着/出発を選択
    • フライトナンバーを選択
    • 表形式で表示されるフライトの詳細を参照してください。

イベントを追加

現在、ボットは開始時にユーザー入力を待っています。また、ボットは会話の開始時にユーザーをガイドできます。このために、Web / モバイル SDKから新しい接続が確立されるたびに、このタスクを開始するイベントハンドラーを追加できます。

  1. ダイアログビルダーを閉じて、ボットタスクページに移動します。
  2. 左側のナビゲーションペインから、インテリジェンス> イベントを選択します。
  3. イベントリストから、接続時イベントに対して構成をクリックします。
  4. [接続時]ウィンドウでは、デフォルトでタスクの開始オプションが選択されているので、それを保持します。
  5. ドロップダウンリストから、フライトステータスの取得タスクを選択します。
  6. 保存して有効にするをクリックします。

ボットのテスト

ダイアログタスクをテストするには、右下の[ボットと会話]オプションを使用できます。接続時イベントが構成されているため、ダイアログが自動的に開始されます。ボットの指示に従ってください:

  1. 到着/出発を選択
  2. フライトナンバーを選択する代わりに、リストに存在しない番号を手動で入力します。
  3. 申し訳ありませんが、問題が発生し、タスクを破棄しなければならなかったなどの一般的なメッセージが表示されます。再試行してください。

次の手順では、これを修正する方法を確認できます。

スクリプトノードの変更

文字列タイプはフライトの選択エンティティで使用されるため、ユーザーがリストから選択する代わりに、誤ったフライト番号を手動で入力と言ったシナリオを処理できます。これを行うには、接続に基づいて適切なメッセージを表示します。このステップでは、ユーザーエントリの検証を追加するために、前に保存したスクリプトを変更する事ができます。

  1. ダイアログビルダーページを開きます。以下のどちらかを行うことができます
  2. 左側のナビゲーションペインで、会話スキル]-> [ダイアログタスクをクリックし、フライトステータスの取得タスクを選択します。
  3. 左側のナビゲーションペインで、概要をクリックし、フライトステータスの取得タスクを選択します。
  4. フライトスクリプトの検証ノードを選択します。
  5. フライトスクリプトの検証ウィンドウのスクリプト定義セクションで、スクリプトの編集をクリックします。
  6. [スクリプトの追加]ダイアログボックスで、次のJavaScriptをコピーし、既存のコードを置き換えます。ユーザーが入力したフライトナンバーがAPIサービス呼び出しによって返されたエントリと一致したときに設定される有効なタグを追加できます。
    context.valid = false;
    context.details;
    var x = context.flights.length;
    for (var l = 0; l < x; l++)
    {
        if (context.entities.SelectFlight == context.flights[l].FlightNo)
        {
             context.valid = true;
             context.details = {
                "Airlines" : context.flights[l].Airlines,
                "FlightNo" : context.flights[l].FlightNo,
                "Airport" : context.flights[l].Airport,
                "AirportName" : context.flights[l].AirportName,
                "Time" :context.flights[l].Time
            };
            break;
        }
    }
    if (context.valid === false)
    {
        delete context.entities.SelectFlight;
    }
  7. [フライトスクリプトの検証]ウィンドウを閉じます。

条件付きフローを作成

以下は、[フライトスクリプトの検証]ノードから条件付きフローを追加する手順です。このスクリプトノードから新しいメッセージノードへの接続が新たに確立されます。これは、ボットからユーザーに対しエラーメッセージを表示し、フライトナンバーを再度選択するように促すためです。

エラーメッセージの作成

  1. [フライト検証]ボットアクションノードと[フライト詳細]メッセージノードの間の接続にカーソルを合わせます。
  2. ノードの追加ボタンが表示されたら、それをクリックします。
  3. 新しいボットメッセージノードを作成します。
    • メッセージ> 新しいメッセージノード追加を選択します。
    • メッセージウィンドウでは、デフォルトでコンポーネントのプロパティタブが選択されています。
    • 一般設定セクションで、次の情報を入力します:
      • 名前エラーメッセージ
      • 表示名エラーメッセージ 
    • ボットレスポンスセクションで、次のテキストを入力します: The Flight number entered is incorrect. Let us start again.
      • 入力をクリックして保存します
    • 接続タブをクリックします。
    • ドロップダウンリストから、デフォルトの接続を[未接続]から[フライトの選択]に変更します。
    • 保存をクリックします。
    • エラーメッセージウィンドウを閉じます。

フライトスクリプト接続の検証

  1. フライトの検証ボットアクションノードをクリックします。
  2. [フライトの検証]ボットアクションウィンドウで、接続タブをクリックします。
    • + ADD IFをクリックします。
    • IFセクションの下で、
      • コンテキストを選択します
      • IF条件として、テキストを有効として入力します
      • 演算子を等しいものとして選択します
      • 値を真値として入力します
      • この条件が真の場合、ダイアログはフライトの詳細に移動します
      • ELSEセクションの下で、
      • この条件が誤の場合、ダイアログはエラーメッセージに移動します
      • 「保存」をクリックします。
      • [フライトスクリプトの検証]ウィンドウを閉じます。

ボットのテスト

ダイアログタスクをテストするには、右下の[ボットと会話]オプションを使用できます。接続時イベントが構成されているため、ダイアログが自動的に開始されます。または、次の発話(インテント名)をいつでも試すことができます。フライトステータスを取得。ボットの指示に従ってください:

  1. 到着/出発を選択
  2. 無効な便名を入力してください。
  3. 適切なエラーメッセージが表示され、フライトナンバーをもう一度入力するように求められます。
  4. フライトナンバーの選択
  5. フライトの詳細を表形式で確認できます。

これで、最初のボットが正常に作成およびテストされました。次のステップは次のとおりです:

  • フライトのステータスを知りたいQR040のステータスは何ですか?などのさまざまなユーザーの発話に対応するようにボットをトレーニングします。これは、ボットをトレーニングすることで実現できます。
  • チャネルを有効にし、ユーザーがアクセス出来る様にボットを公開します。詳細はこちらをご確認ください