캐러셀 사용자 입력 통제

팁:

페이지당 나열되는 기본 항목 수를 변경하려면 시스템 속성을 수정할 com.glide.cs.picker_page_limit 수 있습니다. 기본값은 10입니다.

LLM 주제 검색을 위한 캐러셀 입력 제어 속성


속성	설명
노드 이름	주제 플로우에서 이 캐러셀 사용자 입력 제어 노드를 식별하는 이름입니다.
캐러셀 항목 정의	스크립트를 사용하여 캐러셀에서 선택할 항목을 생성합니다. 스크립트는 하나 이상의 항목을 포함하는 배열을 반환해야 합니다. 이 항목의 캐러셀 항목 표현식 예제 섹션을 참조하십시오.
고급(선택 사항)
사용자 프롬프트 적용
사용자 프롬프트 적용	전환하여 사용자 프롬프트 필드를 엽니다. 사용자 프롬프트 필드의 값은 LLM에서 생성된 메시지 대신 사용자에게 표시됩니다. 일반 언어, 스크립트를 사용하여 사용자 지정 메시지를 만들거나 데이터 알약 선택기로 조건을 정의할 수 있습니다.
확인	사용자 입력의 유효성을 검사하는 스크립트를 추가합니다. 예를 들어 사용자가 유효한 이메일 주소를 입력했는지 확인합니다.
LLM에 대한 추가 지침	사용자 응답에 대한 데이터 형식, 제한 또는 기본값 추가와 같은 LLM에 대한 추가 지침입니다. 데이터 알약 선택기를 사용하여 일반 언어로 추가 지침을 생성하거나, 스크립트를 입력하거나, 조건을 정의할 수 있습니다.
이 노드 숨기기 또는 건너뛰기
다음과 같은 경우 이 노드를 조건부로 표시합니다.	대화에 이 노드를 표시하기 위한 조건을 지정하는 노코드 조건문 또는 로우코드 스크립트입니다. 조건은 true로 평가되어야 합니다. 이 필드는 캐러셀 노드가 입력 수집기 노드 내에서 사용되는 경우에는 적용되지 않습니다.
다음과 같은 경우 사용자가 이 노드를 건너뛸 수 있도록 허용	사용자가 대화에서 이 노드를 건너뛸 수 있도록 허용하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 조건은 true로 평가되어야 합니다. 조건 작성기 또는 스크립트를 사용하여 이 필드를 설정할 수 있습니다.

LLM 주제 검색을 위한 캐러셀 입력 제어 예


캐러셀 속성	캐러셀 프롬프트
	그림 1. 웹 UI 캐러셀 프롬프트

NLU 주제 검색을 위한 캐러셀 입력 통제 속성


속성	설명
노드 이름	주제 플로우에서 이 캐러셀 사용자 입력 제어 노드를 식별하는 이름입니다.
변수 이름	사용자가 선택한 항목을 저장하는 변수의 이름입니다. 변수 이름은 노드 이름 속성에서 자동으로 생성됩니다.
프롬프트	사용자에 대한 프롬프트 또는 질문입니다. 프롬프트는 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 이 값은 기본값이 지정되지 않은 경우에만 사용됩니다. 예: `이름이 무엇입니까?`
NLU 엔터티	엔터티를 NLU 노드와 연결하는 옵션입니다. NLU 엔터티가 이 노드 가상 에이전트 의 입력 변수와 연결된 경우 사용자의 발언에 따라 지정된 값을 슬롯으로 채울 수 있습니다. 주제 의도와 연결된 엔터티 목록에서 엔터티를 선택합니다. 노드에 대한 엔터티를 지정하면 사용자에게 인식된 엔터티 토글 스위치를 확인하도록 묻지 않음이 표시됩니다. 사용하도록 설정하면 추출된 엔터티를 확인하라는 메시지가 표시되지 않습니다. 이 필드는 인스턴스에서 검색이 활성화된 경우에만 NLU 사용할 수 있습니다.
캐러셀 항목 정의	스크립트를 사용하여 캐러셀에서 선택할 항목을 생성합니다. 스크립트는 하나 이상의 항목을 포함하는 배열을 반환해야 합니다. 이 항목의 캐러셀 항목 표현식 예제 섹션을 참조하십시오.
기록 응답 메시지가 없습니다.	기록을 찾을 수 없음을 사용자에게 알리는 메시지입니다. 메시지는 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다.
고급
기본값
기본값	질문 또는 프롬프트에 대한 사용자 응답의 미리 정의된 값입니다. 기본값 확인 필드에 정의된 응답은 사용자에게 기본값을 확인하도록 요청합니다. 사용자가 `no`로 응답하면 값이 null이 됩니다. 기본값은 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 예를 들어 닷워킹을 사용하는 경우 기본값은 `스크립트 변수 > 마지막 사용자 이름`일 수 있습니다. 또는 스크립트를 사용하는 경우 기본값은 `{{vaScripts.lastUsername}}`일 수 있습니다.
확인 메시지
입력 완료 확인	노드 상호작용이 완료되면 사용자에게 표시되는 봇 응답입니다. 메시지는 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 예를 들어 닷워킹을 사용하는 경우: `감사합니다(입력 변수 > 사용자 이름)!` 또는 스크립트를 사용하는 경우 승인은 다음과 같을 수 있습니다: `감사합니다, {{vaInputs.username}}!`.
기본값 확인	기본값 필드의 값이 올바른지 사용자에게 확인하도록 요청하는 메시지입니다. 이 메시지는 프롬프트 필드의 값 대신 사용됩니다. 텍스트 문자열 또는 텍스트를 반환하는 스크립트를 포함할 수 있습니다. 예를 들어 닷워킹을 사용하는 경우: `사용자(입력 변수 > 사용자 이름)입니까?` 또는 스크립트를 사용하는 경우 확인 메시지는 `{{vaScripts.lastUsername}}입니까?`일 수 있습니다.
대화 전환
이 섹션은 인스턴스에서 검색이 활성화된 경우에만 NLU 사용할 수 있습니다.
사용자가 제목을 변경할 수 있도록 켜기	이 노드에 대한 예측을 활성화 NLU 하는 옵션입니다. 사용하도록 설정하면 사용자는 사용 중인 입력 컨트롤의 유형에 관계없이 텍스트를 입력하여 질문에 답할 수 있습니다. 가상 에이전트 을 사용하여 다른 기존 의도와 일치시키므로 사용자가 주제를 전환할 수 있습니다.
이 노드 숨기기 또는 건너뛰기
다음과 같은 경우 이 노드를 조건부로 표시합니다.	대화에 이 노드를 표시하기 위한 조건을 지정하는 노코드 조건문 또는 로우코드 스크립트입니다. 조건은 true로 평가되어야 합니다.
다음과 같은 경우 사용자가 이 노드를 건너뛸 수 있도록 허용	사용자가 대화에서 이 노드를 건너뛸 수 있도록 허용하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 조건은 true로 평가되어야 합니다. 조건 작성기 또는 스크립트를 사용하여 이 필드를 설정할 수 있습니다.
다음과 같은 경우 재요청을 건너뜁니다.	사용자가 대화에서 다시 요청을 건너뛸 수 있도록 하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 주제 루프백 또는 대화 상자 법칙을 통해 이전 노드로 다시 돌아가면 가상 에이전트가 이 노드를 무시하고 원래 값을 자동으로 유지합니다.

NLU 주제 검색을 위한 캐러셀 입력 통제 예

주:

가상 에이전트 디자이너 컨트롤은 다른 채널에서 다르게 표시되고 작동할 수 있습니다.


캐러셀 속성	캐러셀 프롬프트
	그림 2. 웹 UI 캐러셀 프롬프트
	그림 3. ServiceNow Mobile 캐러셀 프롬프트

캐러셀 항목 표현식 예시

(function execute() {
    var options = [];
       options.push(
            {
                'Name': 'Item 1',
                'Value': 'item_1',
                'Description': 'Acme keyboard model 200',
                'Body': 'https://images.pexels.com/photos/688666/pexels-photo-688666.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 200","description":"The model 200 keyboard is a ten-key-less keyboard."}
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 300","description":"The model 300 keyboard is a full-size keyboard with a ten-key pad."}
            }
       );
       return options;

})()

Carousel Item Expression 속성의 스크립트는 캐러셀에 나타나는 항목을 포함하는 배열을 정의하고 반환합니다. 이 배열의 요소에는 이름, 값 및 본문 키가 포함되어야 합니다. 이 예제에서 스크립트는 options 라는 배열을 만들고 각각 필요한 키가 있는 두 개의 요소를 추가합니다. 여기에 있는 이미지는 예제로 하드 코딩되어 있습니다.

표 1. 예제 코드 키
키	설명
이름	캐러셀 항목의 이름입니다. 이 이름은 캐러셀의 이미지 아래에 표시됩니다.
값	항목의 값입니다. 사용자가 캐러셀 항목을 선택하면 이 값은 변수 이름 속성에 명명된 변수에 저장됩니다.
설명	캐러셀 항목을 설명하는 텍스트 문자열입니다. 설명은 이미지 이름 아래에 표시됩니다. 3개 이상의 항목이 있는 캐러셀에는 이미지를 스크롤할 수 있는 왼쪽 및 오른쪽 화살표와 각 항목 아래에 선택 버튼이 표시됩니다. 설명이 140자를 초과하면 사용자가 컨텐츠를 확장할 수 있습니다.
본문	캐러셀 항목에 사용되는 이미지입니다. 값은 이미지 파일의 URL입니다.
Card_name	캐러셀에 표시된 카드를 식별하는 텍스트 문자열 헤더입니다.
Card_data	카드에 표시할 텍스트 문자열이 포함된 배열입니다. 값에는 식별자, 헤더 및 설명이 포함됩니다.

채널 지원

표 2. 캐러셀 사용자 입력 컨트롤에 대한 채널 지원
채널	지원	제약 조건
웹 UI	지원됨	없음
모바일 UI	지원됨	없음
Now Assist 패널	지원됨	없음
Microsoft Teams	지원됨	없음. 캐러셀에 10개 이상의 항목이 포함된 경우 사용자는 다음을 선택하여 나머지 항목을 검토해야 합니다.
Slack	지원됨	없음
Workplace	지원됨	없음
Facebook Messenger	지원됨	이미지 제목은 최대 40자로 제한됩니다. 이미지 텍스트의 최대 문자 제한은 60자입니다. 사용자는 한 번에 10개의 이미지만 볼 수 있습니다. 이미지가 10개를 초과하는 경우 페이지 매김 형식을 사용하여 더 많은 옵션을 볼 수 있습니다. 페이지의 캐러셀에 있는 최대 이미지 수의 기본값은 시스템 속성에서 sn_va_fb_messenger.max_carousel_cards 설정됩니다. 이 속성은 시스템 속성 [sys_properties] 테이블에 있습니다.
문자 메시지 Twilio	지원되지 않음	해당 사항 없음
LINE	지원됨	이미지 제목은 최대 40자로 제한됩니다. 이미지 텍스트의 최대 문자 제한은 60자입니다. 사용자는 한 번에 10개의 이미지만 볼 수 있습니다. 이미지가 10개를 초과하는 경우 페이지 매김 형식을 사용하여 더 많은 옵션을 볼 수 있습니다. 페이지의 캐러셀에 있는 최대 이미지 수의 기본값은 시스템 속성에서 sn_va_line.max.carousel.cards 설정됩니다. 속성은 시스템 속성 [sys_properties] 테이블에 있습니다.
WhatsApp	지원됨	없음
Apple Messages for Business	지원됨	없음
Alexa (음성)	지원됨	화면 장치의 경우 터치 스크롤을 사용합니다. 화면이 표시되지 않는 장치의 경우 음성 페이지 매김을 사용합니다.