Skill Builder::개요::블록별 추가 기능

페이지 이동경로

BOT RESPONSE 블록

BOT RESPONSE 블록을 사용하여 다음의 기능을 수행할 수 있습니다.

카드 동적 생성 및 페이지네이션

응답 중 텍스트형과 카드형, 바로 연결에 대해 카드 동적 생성 및 페이지네이션 기능을 적용할 수 있습니다. 이 기능은 앞 블록의 데이터 중 리스트 타입의 데이터에 대해 각 원소의 값을 활용하여 카드를 만들 때 사용하며, 사용 방법은 다음과 같습니다.

  1. 봇 응답 형식 설정에서 텍스트를 선택합니다. 봇 응답형식 선택 그림봇 응답형식 선택

  2. 전송타입에서 [리스트] 버튼을 클릭합니다. 전송타입 선택 그림전송타입 > 리스트 선택

  3. [기준 데이터 설정] 버튼을 클릭합니다.

    기준 데이터 설정 클릭 그림기준 데이터 설정 클릭

  4. 기준 데이터 설정 창이 팝업되면, 기준 데이터페이지 사이즈 항목을 입력합니다.

    텍스트 입력 그림기준 데이터 설정

    기준 데이터 설정
    항목 설명
    기준 데이터 카드를 생성할 때 사용할 리스트 데이터의 이름
    ex) http_1={action:[{id=1}, {id=2}, {id=3}, {id=4}]} 일 때, 기준 데이터는 http_1.action으로 입력하며, 이때 중괄호({ })로 감싸지 않음
    페이지 사이즈 1 이상으로 입력할 경우, 페이지네이션 기능 적용
    - 페이지네이션 기능을 적용하지 않을 경우, 목록에서 처음 3개의 값을 활용하여 카드를 생성

    기준데이터의 특정 값 사용 시 item.id와 같이 사용합니다. 이때 기준데이터는 item이라는 이름의 객체로 치환됩니다.

    • 예를 들어 텍스트형에서 텍스트 입력란에 http_1.action.id를 사용하고자 할 경우에는 {item.id}로 입력합니다.

버튼 동적 생성 및 페이지네이션

응답 중 텍스트형과 카드형의 버튼에 동적 생성 및 페이지네이션 기능을 적용할 수 있습니다.

  1. [+버튼 추가] 버튼을 클릭 후, [더보기] 버튼 말풍선에서 [버튼 설정] 버튼을 클릭합니다.

    버튼 설정 클릭 그림버튼 설정 클릭

  2. 버튼 설정 창이 팝업되면, 버튼 기능 항목에 리스트 데이터의 경로를 입력합니다.

    데이터 경로 입력 그림데이터 경로 입력

  3. [엑스트라 데이터 설정] 버튼을 클릭합니다.

    엑스트라 데이터 설정 클릭 그림엑스트라 데이터 설정 클릭

  4. Button Extra Data 설정 창이 팝업되면, 다음 페이지를 요청할 때 필요한 버튼 정보를 입력합니다.

    버튼 정보 입력 시, 다음의 데이터 형식, 데이터 명, 데이터 값에 다음 항목을 반드시 포함해야 합니다.

    • 데이터 타입: String
    • 데이터 명: startIndex
    • 데이터 값: {start.action.clientExtra.startIndex}

    버튼 정보 입력 그림버튼 정보 입력

운영체제(OS)별 링크 설정

버튼 기능 드롭박스 항목의 OS별 링크를 클릭하여, Mobile 또는 Desktop OS에 따라 다른 URL로 이동할 수 있도록 설정할 수 있습니다.

운영체제(OS)별 링크 설정 그림운영체제(OS)별 링크 설정

JSON 블록

JSON 블록은 출력 데이터에 대해 고정값 적용과 BEAN 적용 기능을 지원합니다. 기능별 설정 방법은 다음과 같습니다.

고정값 적용

  1. JSON 블록 일반 탭으로 이동 후, 출력 데이터 영역에서 각 항목의 [설정] 아이콘을 클릭합니다.

    JSON 블록 그림JSON 블록

  2. 출력값 설정 창이 팝업하면 설정 타입고정값 적용으로 선택하고, 고정값에 적용하고자 하는 값을 입력합니다.

    출력값 설정 팝업 그림출력값 설정 입력

  3. [적용하기] 버튼을 클릭합니다.

    적용하기 버튼 그림출력값 설정 적용

  4. 출력 데이터 영역에서 해당 항목에 고정값 적용중 텍스트가 표시되는지 확인합니다.

    고정값 적용 표시 그림고정값 적용중 표시

BEAN 적용

  1. JSON 블록 일반 탭으로 이동 후, 출력 데이터 영역에서 각 항목의 [설정] 아이콘을 클릭합니다.

    출력값 설정 팝업 그림출력값 설정 팝업

  2. 출력값 설정 창이 팝업하면 설정 타입BEAN 적용으로 선택하고, Bean 이름, Method 이름, 매개변수 설정에 Bean 정보를 입력합니다.

    안내

    • BEAN은 JSON 블록의 전역 BAEN에 한해 적용할 수 있습니다. Skill 내부의 BEAN 블록에서 생성된 BEAN을 적용하는 기능은 지원 예정입니다.

    BEAN 정보 입력 그림BEAN 정보 입력

  3. [적용하기] 버튼을 클릭합니다.

    적용하기 버튼 그림입력한 BEAN 정보 적용

  4. 출력 데이터 영역에서 해당 항목에 BEAN 적용중 텍스트가 표시되는지 확인합니다.

    BEAN 적용 표시 그림BEAN 적용중 표시

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.