캐러셀 사용자 입력 통제

주제에서 가상 에이전트 캐러셀 사용자 입력 컨트롤을 사용하여 프롬프트와 레이블이 지정된 이미지의 가로 계열을 표시합니다. 사용자는 캐러셀에서 단일 항목을 선택할 수 있습니다.

팁:

페이지당 나열되는 기본 항목 수를 변경하려면 시스템 속성을 수정할 수 있습니다 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 모바일 캐러셀 프롬프트

캐러셀 항목 표현식 예시

(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;

})()

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

표 1. 예제 코드 키

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

채널 지원

표 2. 캐러셀 사용자 입력 컨트롤에 대한 채널 지원

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