본문 바로가기


챗봇 관리자센터

챗봇 관리자센터 메뉴

카카오 고객센터 본문

봇 생성하기

봇 생성하기 카테고리

봇 생성하기 본문

  1. 파라미터 검증 API는 외부와 연결된 스킬서버를 호출하기 전 파라미터 값을 사전검증 혹은 변환하기 위한 목적의 API 입니다.

    이 API를 통해 검증 로직이 들어있는 다른 서버단을 거쳐서 이 파라미터가 유효한지 성공/실패 값을 받아오는 등 사전 테스트를 진행해볼 수 있습니다. 예를 들어, 분식집 주문 챗봇에서 ‘매운 오뎅’ 엔티티가 들어왔고, 현재 매운 오뎅이 품절 상태라면 주문 블록이 유효하지 않음을 판단할 수 있는 것과 같습니다.
    API를 검증하기 위해서는 호출할 API URL과 검증 실패시 노출할 에러메시지를 등록해야 합니다.

    API는 HTTP URL 방식으로 호출하며, 정해진 형태의 결과값을 반환해주어야 정상적으로 동작합니다. 이외의 경우에는, 오류로 처리되며 ‘value’가 채워지지 않은 것과 같은 의미로 해석이 되어 현재 수행중이던 파라미터에 대해서 슬롯필링 과정을 다시 수행되게 됩니다.

  2. 사용자 발화가 입력되면 발화 의도에 맞는 블록이 매칭됩니다. 일반/필수 파라미터로 지정한 엔티티가 발화에 포함이 되어 있다면

    해당 파라미터 값을 자동으로 채웁니다. 이 때, 필수 파라미터의 경우는 아직 값이 채워지지 않은 상태라면 추가로 슬롯필링 과정을 수행합니다.

    필수 파라미터에 설정한 '파라미터 검증 API'가 있다면 API를 호출하여 검증 결과가 Success인지 확인합니다.

    모든 과정이 완료되면 전체 발화 및 일반/필수 파라미터 정보를 모두 payload로 담아 블록에 연결된 스킬을 호출합니다.

  3. 파라미터 설정 메뉴안에 엔티티와, 파라미터가 동시에 존재하고 있으나 이 둘은 상호 간에 정의 및 목적이 크게 다릅니다.

    엔티티는 사용자의 발화 안에서 봇이 인식해야할 중요 정보를 발췌하기 위한 주요 키워드, 낱맡들이라고 보시면 됩니다. 패턴발화를 구성하기 위한 기본 재료로 쓰인다고 볼수 있습니다. 파라미터는 패턴발화안에서 엔티티로 발췌된 '정보'를 제3자 외부 스킬서버 등 어디론가 전송이 필요할 때, 그것을 담기 위한 하나의 또 다른 매체로 이해하시면 됩니다. 그것이 '파라미터명'이 되고, 파라미터명이 가리키는 특정값이 '파라미터값'이 됩니다.


    예를 들어, '제주도 날씨 알려줘' 라는 패턴 발화구문에서 '제주도'는 @sys.location이라는 엔티티로 인식이 되고, 제주도라는 정보값은 'travel_place'라는 파라미터명으로 정의하여 외부와 연결된 스킬서버에 전송하게 할 수 있습니다. 여기에 '$' 기호를 붙이면, 스킬서버에서 필요로 하는 파라미터값($travel_place)으로 활용할 수 있습니다.

  4. 시나리오 상 반드시 필요한 파라미터값이 있을 수 있고, 이를 위해 '필수 파라미터'로 지정하여 구분합니다. 필수 파라미터는 값을 채워 호출할 수 있도록 슬롯필링 과정을 제공하는데, 이 때 파라미터 값을 사용자로부터 잘 받아올 수 있도록 '되묻기 질문'을 설정하는 것입니다.

  5. 필수 파라미터를 되묻기 상황에서 모두 채우지 못한다면 폴백메시지가 출력되고 대화는 종료됩니다. 필수 파라미터를 제대로 채울 수 있도록 되묻기 질문을 명확하게 가이드 하시고, 되묻기 횟수를 적절하게 제공하는 것을 추천합니다.

  6. 봇 테스트 창에서는 버튼에 관한 기능은 지원하지 않습니다. 말풍선 버튼(바로연결 버튼)을 테스트하기 위해서는 개발채널을 연결하여 직접 모바일 기기 또는 웹을 통해 테스트 진행하시는 것을 권장합니다.

  7. 스킬을 사용한 블록도 봇테스트 창에서 테스트 하실 수 있습니다. 다만 봇테스트창에서 보이는 말풍선의 형태는 실제 사용자의 카카오톡 클라이언트의 환경에 조금 다르게 보일 수 있으니 봇테스트는 간편하게 시나리오를 검증용도로 사용하시는 하시는 것을 추천드립니다.

  8. 만약 웰컴블록이 동작하지 않는 경우 아래 내용을 체크하여 주시기 바랍니다.
    1. 웰컴블록은 ON/OFF를 설정할 수 있으며 OFF할 경우, 위 상황에 해당하는 경우에도 웰컴 블록의 메시지는 전송되지 않습니다.
    2. 웰컴블록은 최초 1회 진입시에만 확인 가능합니다.
    3. 알림톡과 함께 사용하는 채널인 경우 사용자가 채널추가를 한 경우에만 웰컴블록이 노출됩니다.

  9. 챗봇에 개발 채널을 연결하면, 변경사항을 배포하지 않아도 현재 챗봇 관리자센터상 저장된 내용을 개발 채널에서 바로 테스트할 수 있습니다. 테스트 완료 후 '배포'를 하면 실 운영 채널에도 챗봇 작업 내용이 반영됩니다.

  10. 말풍선 제작시 권장하는 이미지 사이즈는 아래와 같습니다.
    용량을 초과하지 않을 경우 비율이 상이하더라도 업로드는 가능합니다.
    - 정사각형(1:1) : 800px:800px
    - 와이드형(2:1) : 800px:400px


문의하기

원하시는 답변을 찾지못하셨다면, 고객센터로 문의해 주세요.