---
sourceDocument: Xanadu 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 정적 선택 사용자 입력 통제

# 정적 선택 사용자 입력 통제 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 9분

주제에서 가상 에이전트 정적 선택 사용자 입력 컨트롤을 사용하여 사용자가 사용할 수 있는 미리 정의된 선택 항목을 나열할 수 있습니다. 선택 목록에서 하나의 항목만 선택할 수 있습니다.

## 선택 사항 표시 {#va-static-choicelist__section_uw1_hcz_zpb}

선택 목록에는 페이지당 최대 10개의 항목이 포함됩니다. 10개 이상의 항목이 있는 경우 추가 항목을 표시하고 검색 결과를 필터링할 수 있습니다. 선택 목록 프롬프트에는 사용자가 결과를 필터링하기 위해 선택할 수 있는 검색 아이콘 ![]() 이 포함되어 있습니다.  
정적 선택 컨트롤은 선택 목록 위에 표시되는 헤더 카드를 추가하는 옵션을 제공합니다. 헤더 카드는 웹 및 모바일 채널에서 지원됩니다.

* 헤더 카드에는 설명 텍스트와 함께 크거나 작은 이미지 또는 YouTube 동영상 카드가 포함될 수 있습니다. 선택 목록에는 기본적으로 최대 5개의 항목이 포함되지만 검색 기능은 표시되지 않습니다. 5개 이상의 항목이 있는 경우 사용자는 추가 항목을 표시하도록 선택할 수 있습니다.

* 헤더 카드 아래에 표시되는 항목 수를 제어하려면 시스템 속성을 추가합니다 com.glide.cs.web_header_picker_page_limit . 값을 사용하여 선택 목록에 표시되는 항목 수를 지정합니다. 시스템 속성 만들기에 대한 자세한 내용은 [시스템 속성 추가를](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=xanadu&pubname=xanadu-platform-administration&section=t_AddAPropertyUsingSysPropsList&ft:locale=en-US) 참조하십시오.

{#va-static-choicelist__ul_ygv_gxx_zpb}

## 정적 선택 LLM 주제 검색에 대한 사용자 입력 통제 속성 {#va-static-choicelist__section_l5f_q1q_11c}

{#va-static-choicelist__table_zjt_pz3_h1c__entry__2}

| 속성 | 설명 |
|-|-|
| 이름 | 주제 플로우에서 이 정적 선택 사용자 통제 노드를 식별하는 이름입니다. |
| 상세 정보 설명 | 사용자로부터 필요한 단일 정보입니다. (예: <kbd class="ph userinput">사용자에게 필요한 서비스 카탈로그 항목</kbd> 물어보기) |
| 선택 ||
| 표시 이름 | 각 선택 항목에서 해당 선택 항목에 대해 사용자에게 표시되는 텍스트입니다. 선택 목록에 짧은 문구를 사용합니다. * Slack에서는 선택 목록 레이블을 30자로 제한합니다. * Workplace의 선택 목록 레이블은 20자 제한이 있습니다. {#va-static-choicelist__ul_e5l_1zw_bqb} |
| 값 | 각 선택 항목에 대해 해당 선택 항목이 선택될 때 변수에 저장되는 문자열입니다. |
| 고급 ||
| 헤더 카드 | 이미지 또는 YouTube 동영상을 포함할 수 있는 카드를 추가할 필드를 열려면 전환합니다. 자세한 내용은 [정적 선택 또는 동적 선택 컨트롤에 헤더 카드 삽입](https://servicenow-prod.fluidtopics.net/LPD_2NTIOs5VS_arb8cA~Q "주제를 만들 가상 에이전트 때 정적 선택 및 동적 선택 사용자 입력 컨트롤에 이미지 및 YouTube 비디오를 포함할 수 있습니다.") 문서를 참조하십시오. |
| 사용자 프롬프트 적용 | 대규모 언어 모델(LLM)에서 생성된 메시지 대신 사용자에게 표시되는 사용자 지정 메시지에 대한 필드를 열려면 전환합니다. 일반 언어로 사용자 지정 메시지를 생성하거나, 스크립트를 입력하거나, 데이터 알약 선택기를 사용하여 조건을 정의할 수 있습니다. |
| 확인 | 사용자 입력의 유효성을 검사하는 스크립트를 추가합니다. 예를 들어 사용자가 유효한 이메일 주소를 입력했는지 확인합니다. |
| LLM에 대한 추가 지침 | 사용자 응답에 대한 데이터 형식, 제한 또는 기본값 추가와 같은 LLM에 대한 추가 지침입니다. 데이터 알약 선택기를 사용하여 일반 언어로 추가 지침을 생성하거나, 스크립트를 입력하거나, 조건을 정의할 수 있습니다. |
| 이 노드 숨기기 또는 건너뛰기 ||
| 다음과 같은 경우 이 노드를 조건부로 사용 | 대화에 이 노드를 표시하기 위한 조건을 지정하는 노코드 조건문 또는 로우코드 스크립트입니다. 조건은 true로 평가되어야 합니다. |
| 다음과 같은 경우 사용자가 이 노드를 건너뛸 수 있도록 허용 | 사용자가 대화에서 이 노드를 건너뛸 수 있도록 허용하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 조건은 true로 평가되어야 합니다. 조건 작성기 또는 스크립트를 사용하여 이 필드를 설정할 수 있습니다. |
[ ]

{#va-static-choicelist__table_zjt_pz3_h1c}

## LLM 주제 검색을 위한 정적 선택 사용자 입력 통제의 예 {#va-static-choicelist__section_ezv_lbq_11c}

주:  
가상 에이전트 디자이너 컨트롤은 다른 채널에서 다르게 표시되고 작동할 수 있습니다.  
{#va-static-choicelist__table_rc5_cp5_zzb__entry__2}

| 입력 속성 | 프롬프트 나열 |
|-|-|
|   | 그림 1. 웹 UI 정적 선택 목록 프롬프트 그림 2. 10개 이상의 항목이 있는 웹 UI 정적 선택 목록 프롬프트 선택 목록에는 페이지당 10개의 항목이 표시됩니다. 10개 이상의 결과가 반환되면 다음이 발생합니다. * 목록 끝에는 더 많은 결과를 표시할 수 있는 링크가 포함되어 있습니다. * 검색 결과를 필터링하기 위한 프롬프트에 검색 아이콘이 표시됩니다. 아이콘을 선택하여 검색 상자를 열고 필터를 입력합니다. {#va-static-choicelist__ul_aqz_d4v_zzb} |
[ ]

{#va-static-choicelist__table_rc5_cp5_zzb}

## 정적 선택 NLU 주제 검색을 위한 사용자 입력 통제 속성 {#va-static-choicelist__section_qlf_mvw_bqb}

{#va-static-choicelist__table_nff_y1b_3db__entry__2}

| 속성 | 설명 |
|-|-|
| 노드 이름 | 주제 플로우에서 이 정적 선택 사용자 통제 노드를 식별하는 이름입니다. |
| 상세 정보 설명 | 사용자로부터 필요한 단일 정보입니다. (예: <kbd class="ph userinput">사용자에게 필요한 서비스 카탈로그 항목</kbd> 물어보기) |
| 변수 이름 | 이 프롬프트에 대한 사용자 응답을 저장하는 변수의 이름입니다. 변수 이름은 노드 이름 속성에서 자동으로 생성됩니다. |
| 프롬프트 | 사용자에 대한 프롬프트 또는 질문입니다. 프롬프트는 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 이 값은 기본값이 지정되지 않은 경우에만 사용됩니다. 예: 이름이 무엇입니까? 서식 있는 텍스트를 생성하여 프롬프트의 스타일을 변경할 수 있습니다. * 기울임꼴 텍스트에는 단일 별표 또는 밑줄을 사용합니다. 예를 들어 <kbd class="ph userinput">*text*</kbd> 또는 <kbd class="ph userinput">_text_입니다</kbd>. * 굵은 텍스트에는 이중 별표 또는 밑줄을 사용합니다. 예를 <kbd class="ph userinput">들어 **text**</kbd> 또는 <kbd class="ph userinput">__text__</kbd>. * 기울임꼴 및 굵은 텍스트에는 세 개의 별표 또는 밑줄을 사용합니다. 예를 들어 <kbd class="ph userinput">text***</kbd> 또는 <kbd class="ph userinput">___text___</kbd>입니다. * 공백 하이픈을 사용하여 줄에 글머리 기호를 추가합니다. 예: <kbd class="ph userinput">텍스트</kbd>. * 간격이 있는 오른쪽 꺾쇠 괄호를 사용하여 블록 따옴표를 만듭니다. 예를 들어, <kbd class="ph userinput">&gt; 텍스트</kbd>입니다. * 1개에서 6개 사이의 해시 표시를 사용하여 머리글을 만듭니다. 예: <kbd class="ph userinput">#text#</kbd> 또는 <kbd class="ph userinput">######text######</kbd> * 대괄호와 괄호를 사용하여 하이퍼링크를 만듭니다. 예를 들면 <kbd class="ph userinput">[링크 텍스트](https://servicenow-prod.fluidtopics.net/url)</kbd>입니다. 하이퍼링크에 느낌표를 추가하여 이미지를 표시합니다. 예를 들어, <kbd class="ph userinput">![ 대체 텍스트](https://servicenow-prod.fluidtopics.net/이미지 URL)</kbd> {#va-static-choicelist__ul_cqy_pqh_qbc} |
| NLU 엔터티 | 엔터티를 NLU 노드와 연결하는 옵션입니다. NLU 엔터티가 이 노드 가상 에이전트 의 입력 변수와 연결된 경우 사용자의 발언에 따라 지정된 값을 슬롯으로 채울 수 있습니다. 주제 의도와 연결된 엔터티 목록에서 엔터티를 선택합니다. 노드에 대한 엔터티를 지정하면 사용자에게 인식된 엔터티 토글 스위치를 확인하도록 묻지 않음이 표시됩니다. 사용하도록 설정하면 추출된 엔터티를 확인하라는 메시지가 표시되지 않습니다. 이 필드는 인스턴스에서 검색이 활성화된 경우에만 NLU 사용할 수 있습니다. |
| 선택 ||
| 표시 이름 | 각 선택 항목에서 해당 선택 항목에 대해 사용자에게 표시되는 텍스트입니다. 선택 목록에 짧은 문구를 사용합니다. * Slack에서는 선택 목록 레이블을 30자로 제한합니다. * Workplace의 선택 목록 레이블은 20자 제한이 있습니다. {#va-static-choicelist__d19664e200} |
| 값 | 각 선택 항목에 대해 해당 선택 항목이 선택될 때 변수에 저장되는 문자열입니다. |
| 고급 ||
| 헤더 카드 | 이미지 또는 YouTube 동영상을 포함할 수 있는 카드를 추가할 필드를 열려면 전환합니다. 자세한 내용은 [정적 선택 또는 동적 선택 컨트롤에 헤더 카드 삽입](https://servicenow-prod.fluidtopics.net/LPD_2NTIOs5VS_arb8cA~Q "주제를 만들 가상 에이전트 때 정적 선택 및 동적 선택 사용자 입력 컨트롤에 이미지 및 YouTube 비디오를 포함할 수 있습니다.") 문서를 참조하십시오. |
| 기본값 ||
| 기본값 | 질문 또는 프롬프트에 대한 사용자 응답의 미리 정의된 값입니다. 기본값 확인 필드에 정의된 응답은 사용자에게 기본값을 확인하도록 요청합니다. 사용자가 <kbd class="ph userinput">no</kbd>로 응답하면 값이 null이 됩니다. 기본값은 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 예를 들어 닷워킹을 사용하는 경우 기본값은 스크립트 변수 \> 마지막 사용자 이름일 수 있습니다. 또는 스크립트를 사용하는 경우 기본값은 {{vaScripts.lastUsername}}일 수 있습니다. |
| 확인 메시지 ||
| 입력 완료 확인 | 노드 상호작용이 완료되면 사용자에게 표시되는 봇 응답입니다. 메시지는 텍스트 문자열 또는 텍스트를 반환하는 스크립트일 수 있습니다. 예를 들어 닷워킹을 사용하는 경우: 감사합니다(입력 변수 \> 사용자 이름)! 또는 스크립트를 사용하는 경우 {{ vaInputs.username}} 감사합니다! |
| 기본값 확인 | 기본값 필드의 값이 올바른지 사용자에게 확인하도록 요청하는 메시지입니다. 이 메시지는 프롬프트 필드의 값 대신 사용됩니다. 텍스트 문자열 또는 텍스트를 반환하는 스크립트를 포함할 수 있습니다. 예를 들어 닷워킹을 사용하는 경우: 사용자(입력 변수 \> 사용자 이름)입니까? 또는 스크립트를 사용하는 경우 확인 메시지는 {{vaScripts.lastUsername}}입니까?일 수 있습니다. |
| 대화 전환 ||
| 이 섹션은 인스턴스에서 검색이 활성화된 경우에만 NLU 사용할 수 있습니다. ||
| 사용자가 제목을 변경할 수 있도록 켜기 | 이 노드에 대한 예측을 활성화 NLU 하는 옵션입니다. 사용하도록 설정하면 사용자는 사용 중인 입력 컨트롤의 유형에 관계없이 텍스트를 입력하여 질문에 답할 수 있습니다. 가상 에이전트 을 사용하여 다른 기존 의도와 일치시키므로 사용자가 주제를 전환할 수 있습니다. |
| 이 노드 숨기기 또는 건너뛰기 ||
| 다음과 같은 경우 이 노드를 조건부로 표시합니다. | 대화에 이 노드를 표시하기 위한 조건을 지정하는 노코드 조건문 또는 로우코드 스크립트입니다. 조건은 true로 평가되어야 합니다. |
| 다음과 같은 경우 사용자가 이 노드를 건너뛸 수 있도록 허용 | 사용자가 대화에서 이 노드를 건너뛸 수 있도록 허용하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 조건은 true로 평가되어야 합니다. 조건 작성기 또는 스크립트를 사용하여 이 필드를 설정할 수 있습니다. |
| 다음과 같은 경우 재요청을 건너뜁니다. | 사용자가 대화에서 다시 요청을 건너뛸 수 있도록 하는 조건을 지정하는 코드 없는 조건문 또는 로우 코드 스크립트입니다. 주제 루프백 또는 대화 상자 법칙을 통해 이전 노드로 다시 돌아가면 가상 에이전트가 이 노드를 무시하고 원래 값을 자동으로 유지합니다. |
[ ]

{#va-static-choicelist__table_nff_y1b_3db}

## NLU 주제 검색을 위한 정적 선택 사용자 입력 통제의 예 {#va-static-choicelist__section_ytw_3h1_vdb}

주:  
가상 에이전트 디자이너 컨트롤은 다른 채널에서 다르게 표시되고 작동할 수 있습니다.  
{#va-static-choicelist__table_f1f_v2p_xdb__entry__2}

| 입력 속성 | 프롬프트 나열 |
|-|-|
| 그림 3. 정적 선택 입력 통제 기본 속성 그림 4. 카드 추가 대화 상자(헤더 카드 고급 옵션) | 그림 5. 웹 UI 정적 선택 목록 프롬프트 그림 6. 10개 이상의 항목이 있는 웹 UI 정적 선택 목록 프롬프트 선택 목록에는 페이지당 10개의 항목이 표시됩니다. 10개 이상의 결과가 반환되면 다음이 발생합니다. * 목록 끝에는 더 많은 결과를 표시할 수 있는 링크가 포함되어 있습니다. * 검색 결과를 필터링하기 위한 프롬프트에 검색 아이콘이 표시됩니다. 아이콘을 선택하여 검색 상자를 열고 필터를 입력합니다. {#va-static-choicelist__ul_cgp_xpp_klb} |
| 그림 3. 정적 선택 입력 통제 기본 속성 그림 4. 카드 추가 대화 상자(헤더 카드 고급 옵션) | 그림 7. 헤더 카드가 있는 웹 UI 정적 선택 목록 선택 목록에는 페이지당 5개의 항목이 포함되어 있습니다. 5개 이상의 결과가 반환되면 목록에 더 많은 결과를 표시하는 옵션이 제공됩니다. 주: 헤더 카드를 사용하면 검색 기능이 억제됩니다. |
[ ]

{#va-static-choicelist__table_f1f_v2p_xdb}

## 채널 지원 {#va-static-choicelist__section_q1z_cj3_rsb}

{#va-static-choicelist__table_iw1_2j3_rsb__entry__3}

| 채널 | 지원 | 제약 조건 |
|-|-|-|
| 웹 UI | 지원됨 | 없음 |
| 모바일 UI | 지원됨 | 없음 |
| Now Assist 패널 | 지원됨 | 없음 |
| Microsoft Teams | 지원됨 | 없음 |
| Slack | 지원됨 | 헤더 카드는 지원되지 않습니다. 선택 목록의 선택 항목이 3개 이하인 경우 Slack은 목록을 버튼으로 표시합니다. |
| Workplace | 지원됨 | 헤더 카드는 지원되지 않습니다. |
| Facebook Messenger | 지원됨 | 빠른 회신에서 레이블의 최대 문자 제한은 20자입니다. 빠른 답장은 한 번에 13개만 볼 수 있습니다. 빠른 회신이 13개를 초과하는 경우 페이지 매김 형식을 사용하여 추가 옵션을 봅니다. 페이지에 대한 최대 회신 수의 기본값은 시스템 속성에서 sn_va_fb_messenger.max_quick_replies 설정됩니다. 이 속성은 시스템 속성 \[sys_properties\] 테이블에 있습니다. |
| 문자 메시지 Twilio | 지원됨 | 헤더 카드는 지원되지 않습니다. |
| LINE | 지원됨 | 빠른 답장에서 레이블의 최대 한도는 20자입니다. 빠른 답장은 한 번에 13개만 볼 수 있습니다. 빠른 회신이 13개를 초과하는 경우 페이지 매김 형식을 사용하여 추가 옵션을 봅니다. 페이지에 대한 최대 회신 수의 기본값은 시스템 속성에서 sn_va_line.max.picker.choices 설정됩니다. 속성은 시스템 속성 \[sys_properties\] 테이블에 있습니다. |
| WhatsApp | 지원됨 | 없음 |
| Apple Messages for Business | 지원됨 | 없음 |
| Alexa (음성) | 지원됨 | 화면 장치의 경우 터치 스크롤을 사용합니다. 화면이 표시되지 않는 장치의 경우 음성 페이지 매김을 사용합니다. |
[표 1. 정적 선택 사용자 입력 컨트롤에 대한 채널 지원]

{#va-static-choicelist__table_iw1_2j3_rsb}