---
sourceDocument: Xanadu Now Platform 기능
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/servicenow-platform

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu Now Platform 기능

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# 서비스 카탈로그 의 주제 블록 가상 에이전트 제공자 NLU

# 서비스 카탈로그 의 주제 블록 가상 에이전트 제공자 NLU {#ariaid-title1}

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

요청 제출 작업을 수행하기 위해 재사용 가능한 주제 블록을 포함하여 powered by 자연어 이해 (NLU)에서 주제 대화를 가상 에이전트 디자인할 수 있습니다.

## 카탈로그 항목 검색 {#request-topic-blocks-va__section_g5n_2g1_3mb}

이 주제 블록을 사용하여 검색 기준에 따라 카탈로그 항목을 검색할 수 있습니다. 검색 결과가 여러 개 있는 경우 캐러셀 뷰에서 검색 결과 하나를 선택할 수 있습니다.{#request-topic-blocks-va__table_inb_mg1_3mb__entry__2}

| 매개변수 | 설명 |
|-|-|
| query_term | 카탈로그 항목을 검색하는 키워드입니다. 카탈로그 항목의 키워드 검색 구성에 대한 자세한 내용은 [카탈로그 항목에 대한 키워드 검색 구성](https://servicenow-prod.fluidtopics.net/d~j8_ywRNgruxrxA7CriEQ "서비스 카탈로그에서 키워드로 카탈로그 항목을 검색하는 경우 카탈로그 테이블의 몇 가지 필드를 고려하여 검색 결과가 표시됩니다. 키워드와 정확히 일치하는 항목이 없으면 가장 가까운 일치 항목이 다음 항목을 찾으려고 했습니까 추천 항목으로 표시됩니다. 이 검색 기능은 서비스 포털에서도 적용할 수 있습니다.") 문서를 참조하십시오. |
| catalogs | 카탈로그 항목을 검색해야 하는 쉼표로 구분된 카탈로그 목록입니다. |
| result_limit | 표시해야 하는 검색 결과의 수입니다. 기본적으로 이 숫자는 5로 설정됩니다. |
[표 1. 입력 매개변수]

{#request-topic-blocks-va__table_inb_mg1_3mb} {#request-topic-blocks-va__table_pks_mg1_3mb__entry__2}

| 매개변수 | 설명 |
|-|-|
| catalog_item_id | 카탈로그 항목을 선택하는 경우 항목의 sys_id가 반환됩니다. 카탈로그 항목을 선택하지 않은 경우, 즉 다음 중 없음 옵션을 선택하는 경우 -1이 반환됩니다. |
| item_type | 사용자가 선택한 카탈로그 항목의 sys_class_name입니다. |
| is_conversational | 의 대화 모드에서 가상 에이전트카탈로그 항목을 요청할 수 있는지 여부를 지정합니다. |
[표 2. 출력 매개변수]

{#request-topic-blocks-va__table_pks_mg1_3mb}

## 카탈로그 항목 요청 {#request-topic-blocks-va__section_fmt_fg1_3mb}

이 주제 블록을 사용하여 카탈로그 항목을 요청할 수 있습니다.
{#request-topic-blocks-va__table_kkf_4g1_3mb__entry__2}

| 매개변수 | 설명 |
|-|-|
| catalog_item_id | 요청해야 하는 카탈로그 항목의 sys_id입니다. |
| execute_contextual_search | 구성에 따라 기록 생성자에 대해 Contextual Search를 실행해야 하는지 지정하는 옵션입니다. 기록 생성자에 대한 문맥 검색을 정의하는 방법에 대한 자세한 내용은 [기록 생성자에 대한 문맥 검색 정의를](https://www.servicenow.com/docs/access?context=t_CntxtSearchRP&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 참조하십시오. |
| confirm_catalog_item | 다음 단계를 계속하기 전에 사용자가 카탈로그 항목을 확인해야 하는지 여부를 지정하는 옵션입니다. 이 항목이 <kbd class="ph userinput">false</kbd>로 설정되면 사용자는 확인을 건너뛰고 카탈로그 항목 질문에 답변할 수 있습니다. |
| show_end_state_card | 생성된 기록에 대한 종료 상태 카드 정보를 사용자에게 표시하는 옵션입니다. |
[표 3. 입력 매개변수]

{#request-topic-blocks-va__table_kkf_4g1_3mb} {#request-topic-blocks-va__table_gbq_4g1_3mb__entry__2}

| 매개변수 | 설명 |
|-|-|
| record_id | 항목 제출 후 생성된 기록의 sys_id입니다. 카탈로그 항목이 대화 모드에서 지원되지 않거나 사용자가 항목에 접근할 수 없는 경우 -1이 반환됩니다. |
| record_table | 기록이 생성되는 테이블의 이름입니다. |
| variables | 카탈로그 항목과 관련된 질문입니다. |
[표 4. 출력 매개변수]

{#request-topic-blocks-va__table_gbq_4g1_3mb}

## 가상 에이전트 렌더 유형 {#request-topic-blocks-va__section_vnx_mpw_b5b}

카탈로그 항목은 대화, 창, 팝업 또는 인라인으로 렌더링 가상 에이전트 할 수 있습니다.

## 대화 렌더링 유형을 사용하는 카탈로그 항목 요청 {#request-topic-blocks-va__section_x5d_d32_3mb}

사용자는 라인의 질문에 응답하여 대화 모드에서 요청을 제출할 수 있습니다.   

사용자가 에서 제공하는 NLU대화 모드에서 가상 에이전트 카탈로그 항목을 요청할 때 다음 조건을 충족해야 합니다.

* 카탈로그 항목은 glide.sc.conversational.request.question.limit 속성에 지정된 질문 수보다 많을 수 없습니다. 기본적으로 이 숫자는 10으로 설정됩니다. 이 속성에 대한 자세한 내용은 [서비스 카탈로그 속성](https://servicenow-prod.fluidtopics.net/dg2twSJUtPj~oot63UBaoQ "서비스 카탈로그 애플리케이션에는 애플리케이션의 다양한 설정을 구성하는 데 사용되는 속성이 포함되어 있습니다.") 문서를 참조하십시오.
* 카탈로그 항목에는 스크립팅되지 않은 카탈로그 UI 정책이 있을 수 있습니다. 이러한 UI 정책은 변수가 순차적으로 영향을 받을 때, 즉 순서가 낮은 변수만 순서가 높은 변수에 영향을 주게 되도록 정의해야 합니다.
* 카탈로그 항목에는 Now Mobile 또는 Service Portal에 대해 정의된 카탈로그 클라이언트 스크립트가 있을 수 없습니다.
* 다음 변수만 지원됩니다.
  * 첨부 파일
  * 확인란(확인란 변수 그룹은 지원되지 않음)
  * 날짜
  * 날짜/시간
  * 이메일
  * IP 주소
  * 레이블
  * 복수 선택 조회(가격 책정 암시 및 고급 참조 한정자 없음)
  * 선택 상자 조회(가격 책정 암시 및 고급 참조 한정자 없음)
  * 다중 선택(가격 책정 암시 없음)
  * 여러 줄 텍스트
  * 소수 자릿수(가격 책정 암시 없음)
  * 참조(가격 책정 암시 및 고급 참조 한정자 없음)  
    주:  
    7,000개가 넘는 기록이 있는 테이블에 해당하는 참조 유형 변수는 지원되지 않습니다. glide.sc.va.reference_question_choices.limit 속성에 기록 수의 상한을 지정할 수 있습니다. 기본적으로 7,000으로 설정됩니다.
  * 요청 대상(가격 책정 암시 및 고급 참조 한정자 없음)
  * 서식 있는 텍스트 레이블
  * 선택 상자(가격 책정 암시 없음)
  * 1줄 텍스트
  * URL
  * 넓은 1줄 텍스트
  * 예/아니요
  * 컨테이너 변수
  {#request-topic-blocks-va__ul_lj4_nv4_g3b}
* 다음 변수 속성이 지원됩니다.
  * ref_ac_order_by
  * allowed_extensions
  * max_file_size

  {#request-topic-blocks-va__ul_f23_nd1_3mb}  
  주:  
  다른 모든 변수 속성은 에서 무시됩니다 가상 에이전트.
* 카탈로그 항목에는 단일 행 변수 세트가 있을 수 있지만 복수 행 변수 세트는 있을 수 없습니다.
* 카탈로그 항목에 질문에 대해 구성된 기본값이 있는 경우 기본값이 에 표시 가상 에이전트되므로 사용자는 수동으로 선택하지 않고도 기본값을 계속 진행할 수 있습니다. 사용자는 기본값 이외의 다른 값을 선택할 수도 있습니다.
* 카탈로그 항목에 질문에 대해 구성된 데이터 조회가 있는 경우 setter 값이 에 표시 가상 에이전트되므로 사용자가 setter 값을 계속 진행하거나 다른 값을 선택할 수 있습니다. 데이터 조회가 있는 카탈로그 항목은 정합기 질문 앞에 설정기 질문이 있는 경우 대화형 항목으로 지원되지 않습니다.
* 사용자는 카탈로그 항목에 대해 다음과 같은 유형의 질문을 건너뛸 수 없습니다.
  * 복수 선택 조회
  * 선택 상자
  * 선택 상자 조회
  * 예/아니요
  * 숫자 척도(첫 번째 항목 선택 금지 구성을 선택하지 않는 경우)
  * 복수 선택(첫 번째 항목 선택 금지 구성을 선택하지 않았거나 선택 사항 없음 포함 구성이 선택된 경우)
  {#request-topic-blocks-va__ul_t3n_4qb_c5b}
* 사용자가 다음과 같이 Microsoft Teams지원되는 다른 공동 작업 도구에서 사용하는 가상 에이전트 경우:
  * 필드의 선택 유형에서 검색 아이콘을 사용하여 값을 검색하는 것은 지원되지 않습니다.그림 1. 의 선택 유형 필드 Microsoft Teams 그림 2. 의 선택 유형 필드 가상 에이전트
  * 필드의 참조 유형 내 값 검색은 질문 형태로 수행됩니다.그림 3. 의 참조 유형 필드 Microsoft Teams 그림 4. 의 참조 유형 필드 가상 에이전트   

  {#request-topic-blocks-va__ul_yxq_qrs_f5b}
{#request-topic-blocks-va__ul_oln_svz_hmb} 카탈로그 항목이 비대화형인 경우 요청 양식은 다음 렌더링 유형 중 하나로 나타날 수 있습니다.

* 인라인
* 팝업(Pop-up)
* 기간
{#request-topic-blocks-va__ul_a5g_bbj_dcc}  
조건에 따라 비대화형 카탈로그 항목에 대한 카탈로그 항목 양식이 인라인, 팝업 또는 창으로 표시될지 여부가 결정됩니다.  
주:  
질문 glide.sc.va.inline_render.question.limit 수에 따라 속성은 카탈로그 항목 양식이 인라인으로 표시되는지 팝업으로 표시되는지를 결정합니다. 기본적으로 속성 값은 20입니다.
{#request-topic-blocks-va__table_nv2_hbj_dcc__entry__2}

| 카탈로그 항목 양식은 다음과 같이 나타납니다. | 조건 |
|-|-|
| 인라인 | * 카탈로그 항목에 사용자 지정 또는 UI 페이지 변수가 포함되어 있지 않습니다. * 카탈로그 항목에 포함된 질문이 20개 이하인 경우 항목 양식이 인라인으로 표시됩니다. 속성의 glide.sc.va.inline_render.question.limit 기본값은 20입니다. * 카탈로그 항목에 MRVS(다중 행 변수 세트)가 포함되어 있지 않습니다. {#request-topic-blocks-va__ul_n1c_kbj_dcc} |
| 팝업(Pop-up) | * 카탈로그 항목에 사용자 지정 또는 UI 페이지 변수가 포함되어 있지 않습니다. * 카탈로그 항목에 20개가 넘는 질문이 포함되어 있으면 항목 폼이 팝업으로 나타납니다. 속성의 glide.sc.va.inline_render.question.limit 기본값은 20입니다. {#request-topic-blocks-va__ul_t32_4bj_dcc} |
| 기간 | * 카탈로그 항목에는 사용자 지정 또는 UI 페이지 변수가 포함되어 있습니다. * 속성이 glide.sc.va.render_type.legacy true로 설정됩니다. {#request-topic-blocks-va__ul_em2_frw_dcc} |
[ ]

{#request-topic-blocks-va__table_nv2_hbj_dcc}

## 인라인 렌더링 유형을 사용하는 카탈로그 항목 요청 {#request-topic-blocks-va__section_wjt_srq_bcc}

카탈로그 항목 요청자는 양식을 NLU인라인 가상 에이전트 으로 작성하여 카탈로그 항목을 제출할 수 있습니다. 인라인 렌더링 유형으로 표시된 카탈로그 항목을 요청하는 동안 요청자는 대화 내에서 가상 에이전트 항목과 해당 옵션을 채울 수 있습니다.  
예를 들어 요청자는 대화에서 가상 에이전트 양식을 인라인으로 채우고 항목을 제출할 수 있습니다.그림 5. 카탈로그 항목의 인라인 요청   

<br />

<br />

<br />

<br />

## 팝업 렌더링 유형을 사용한 카탈로그 항목 요청 {#request-topic-blocks-va__section_k5s_4n1_25b}

사용자는 항목에 대한 팝업으로 카탈로그 항목 요청을 제출할 수 있으며, 이는 대화형이 아닙니다. 팝업 가상 에이전트 에서 사용자가 새 탭으로 이동하지 않고 팝업에서 요청을 제출할 수 있는 링크를 제공합니다. 비대화 카탈로그 항목은 사용자 지정, 레이블이 있는 사용자 지정 또는 UI 페이지 변수가 없는 경우에만 팝업으로 렌더링할 수 있습니다.  
주:  
대화를 팝업으로 렌더링 가상 에이전트 하지 않으려면 속성을 true로 설정하여 glide.sc.va.render_type.legacy 구성된 포털의 모든 비대화형 카탈로그 항목을 새 탭으로 렌더링합니다.

## 창 렌더링 유형을 사용하는 카탈로그 항목 요청 {#request-topic-blocks-va__section_mlk_xn1_25b}

사용자는 창에서 카탈로그 항목 요청을 제출할 수 있습니다. 창의 경우 Virtual Agent는 sn_itsm_va.com.snc.itsm.virtualagent.portal_url 속성에 정의된 Service Portal에서 사용자가 요청을 제출할 수 있는 링크를 제공합니다. 비대화 항목은 사용자 지정, 레이블이 있는 사용자 지정 또는 UI 페이지 변수가 있는 경우 창으로 렌더링됩니다.  
카탈로그 항목은 다음 유형의 경우 창으로 렌더링됩니다.

* 컨텐츠 항목
* 주문 가이드
* 마법사 시작 관리자
* 표준 변경 템플릿
{#request-topic-blocks-va__ul_t5v_zqs_f5b}
* **[요청 주제 대화 제출](https://servicenow-prod.fluidtopics.net/d2HvXaGEyWf9SDiBkvlnOA)**   
  사용자는 대화에서 가상 에이전트 요청을 제출할 수 있습니다.

**관련 개념**   

* [카탈로그 작성기 미리 보기 주제 대화](https://servicenow-prod.fluidtopics.net/N942oU_izN28FZY8s0HMUg "카탈로그 작성기를 통해 사용자는 대화의 가상 에이전트 카탈로그 항목을 미리 볼 수 있습니다.")