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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 기본 입력 및 출력 리치 컨트롤

# 사용자 지정 채팅 통합을 위한 기본 입력 및 출력 리치 컨트롤 {#ariaid-title1}

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

입력 및 출력 리치 컨트롤은 사용자 지정 어댑터 구성 \[sys_cs_custom_adapter_config\] 테이블의 사용자 지정 채팅 통합에 매핑되어야 합니다. 리치 컨트롤에 아웃바운드 변환기 구현이 없는 경우 최종 사용자에게 응답이 제공되지 않으며 해당 사용자는 불만족스러운 채팅 환경을 얻을 수 있습니다.
다음과 같은 기본 리치 컨트롤은 입력 및 출력 리치 컨트롤에 매핑됩니다. 매개변수는 uiType 에서 대화를 빌드하는 데 사용되는 주제 컨트롤을 참조합니다 가상 에이전트 디자이너.  
{#default-rich-controls-va-cccif__table_rqm_lvn_qmb__entry__2}

| 리치 컨트롤 | 설명 |
|-|-|
| ActionRichControl | 이 구성요소는 대화에서 발생하는 다양한 이벤트와 작업을 처리합니다. 일부 작업은 모든 채널에 적용되지 않을 수 있습니다. 예를 들어 StartSpinnerActionMsg는 SMS에서 무시됩니다. ServiceNow® 가상 에이전트 는 이 프레임워크를 통해 다음과 같은 유형의 작업 메시지를 생성합니다. 사용자 지정 채팅 인터페이스는 특정 작업 메시지 유형만 인식합니다. * SeparatorActionMsg \|\|actionMsg 인스턴스의 * 시스템 작업 메시지 \|\|actionMsg 인스턴스의 * TopicFinishedActionMsg \|\|actionMsg 인스턴스의 * SwitchToVirtualAgentActionMsg \|\|actionMsg 인스턴스의 * SwitchConversationActionMsg \|\|actionMsg 인스턴스의 * ChatSubHeaderActionMsg \|\|actionMsg 인스턴스의 * StartSpinnerActionMsg \|\|actionMsg instanceof EndSpinnerActionMsg * SubscribetoSupportQueue \|\|actionMsg 인스턴스의 * SubscribeToChatPresence \|\|actionMsg 인스턴스의 * SwitchToLiveAgentActionMsg \|\|actionMsg 인스턴스의 {#default-rich-controls-va-cccif__ul_odf_ykm_hmb} ActionRichControl은 이러한 메시지를 요소 내에 래핑합니다.actionMsg 따라서 ActionRichControl에 대한 단일 아웃바운드 변환기는 이러한 모든 메시지를 처리할 수 있습니다. 이 구성요소에는 인바운드 변환기가 필요하지 않습니다. |
| agentInfo 매개변수 | 라이브 에이전트에서 리치 컨트롤을 보낸 경우 속성이 agentInfo 리치 컨트롤에 추가됩니다. 예제: { uiType: "someType", group: "someGroup" agentInfo: { sentFromAgent: true }  // please note that this object may contain more info in subsequent releases. ... } |
| 기본 선택기 | [파일 선택기](https://servicenow-prod.fluidtopics.net/ib0KONE7FSeNrszHioeKuQ "주제에서 파일 선택기 사용자 입력 컨트롤을 가상 에이전트 사용하여 사용자에게 이미지 또는 파일 형식을 업로드하라는 메시지를 표시합니다. 사용자가 이미지 파일을 업로드하면 이미지가 클라이언트에 가상 에이전트 즉시 나타납니다."), 주제 선택기 및 [부울](https://servicenow-prod.fluidtopics.net/YIwj__EtAZ~jQ6rUyiKw0g "주제에서 가상 에이전트 부울 사용자 입력 컨트롤을 사용하여 사용자에게 예/아니요 프롬프트를 표시합니다.") 컨트롤에 매핑됩니다. 예제: { uiType: "Picker/TopicPicker/Boolean", group: "DefaultPicker", nluTextEnabled: true/false, promptMsg: "", // optional (needed for TopicPicker) label: "The question for the list",   // always filled itemType: "Picture/List"  // needed to user key to expect picture attached options: [ { label: "display label prompt", value: "the value required to satisfy the question", description: "a description of value_1 item" attachment: "www.foo", enabled: true/false }, ... ] } 선택적 order 매개변수를 사용하면 승격된 주제가 표시되는 순서를 지정할 수 있습니다. 예: "options": [ { label: "Check IT Ticket Status", value: "55720b465bf0201024f11fc40a81c72d", order: 100, enabled: true }, { label: "Live Agent Support", value: "ce2ee85053130010cf8cddeeff7b12bf", order: 200, enabled: true }, { label: "Open IT Ticket 2", value: "2a46cffbc7602010v088bbf603c260a7", order: 300, enabled: true } ] |
| DefaultText | [입력 텍스트](https://servicenow-prod.fluidtopics.net/HO5VBfOcH~HSdRn8L~E1iA "주제의 텍스트 사용자 입력 컨트롤은 가상 에이전트 사용자에게 텍스트 문자열을 입력하라는 메시지를 표시합니다."), [출력 텍스트](https://servicenow-prod.fluidtopics.net/T0RniUNUr4WiPYs0~CWnWA "주제에서 가상 에이전트 텍스트 봇 응답 컨트롤을 사용하여 봇 응답을 텍스트로 표시합니다. 텍스트 편집기 컨트롤을 사용하여 텍스트 봇 응답의 형식을 지정할 수 있습니다. 예를 들어 텍스트를 굵게 또는 기울임꼴로 표시하고 링크, 글머리 기호 목록 및 이모티콘을 포함할 수 있습니다.") 및 파일 업로드 통제에 매핑합니다. 예제: { uiType: "InputText/OutputText/FileUpload/Picture", group: "DefaultText", required: true/false, nluTextEnabled: true/false, itemType: "file/image/inputtext/outputtext", maskType: "SECURE/SENSITIVE/NONE"  // null except for InputText/OutputText label: "The Question?" } |
| 기본 날짜 | [날짜 및 시간](https://servicenow-prod.fluidtopics.net/A4dJBt5tvKv2m2~4Dr9XyQ "주제에서 가상 에이전트 날짜 시간 사용자 입력 컨트롤을 사용하여 사용자가 달력 날짜, 시간(시간 및 분) 또는 둘 다를 선택할 수 있도록 합니다.") 컨트롤에 매핑합니다. { uiType: "Date/DateTime/Time", group: "DefaultDate", required: true/false, nluTextEnabled: true/false, label: "The Question?" } |
| DefaultOutputLink | 응답 통제를 [링크](https://servicenow-prod.fluidtopics.net/RbcsCkbzXW85TUePeR6~WQ "주제에서 가상 에이전트 봇 응답 연결 컨트롤을 사용하여 봇 응답을 표시합니다. 응답에는 항목에 대한 단일 URL 링크 또는 최대 3개 항목에 대한 여러 URL 링크가 포함된 헤더 프롬프트가 포함됩니다.") 하는 맵입니다. 예제: { uiType: "OutputLink", group: "DefaultOutputLink", label: "link label", header: "link header", type: "link", value: { action: "www.foo", } } } |
| DefaultOutputImage | [이미지 응답](https://servicenow-prod.fluidtopics.net/Bbn88EoNg1Q5co3zLFm5~g "주제에서 이미지 봇 응답 컨트롤을 가상 에이전트 사용하여 URL 링크에서 이미지를 업로드하고 표시합니다. 이미지 종횡비는 봇 채팅 풍선에서 이미지의 크기를 결정합니다.") 컨트롤에 매핑합니다. 예제: { uiType: "OutputImage", group: "DefaultOutputImage", value: "www.foo" } |
| DefaultOutput카드 | [카드 응답](https://servicenow-prod.fluidtopics.net/iKQgt5Bx1Qk9GWcz5cFaew "주제에서 카드 봇 응답 컨트롤을 가상 에이전트 사용하여 비디오 또는 이미지와 같은 서식 있는 컨텐츠와 함께 인스턴스의 기록에서 선택한 정보를 업로드하고 표시합니다.") 통제에 대한 맵입니다. 예제: { uiType: "OutputCard", group: "DefaultOutputCard", templateName: "Card", data: "some json data string" } |
| 기본 출력 HTML | [HTML 응답](https://servicenow-prod.fluidtopics.net/Wjq56QgfTjCRz6De8JNotw "HTML 봇 응답 컨트롤을 사용하여 봇 응답에 가상 에이전트 정적 HTML 텍스트를 표시합니다.") 통제에 매핑합니다. 예제: { uiType: "OutputHtml", group: "DefaultOutputHtml", style: "inline", height: 100, width: 100, value: "<div>html</div>" } |
| DefaultOutputTable | [테이블 응답](https://servicenow-prod.fluidtopics.net/wvu8LIxMSxkyrD~TkRh0ew "주제에서 가상 에이전트 테이블 봇 응답 컨트롤을 사용하여 봇 응답을 테이블로 표시합니다.") 통제에 매핑합니다. 예제: { uiType: "OutputTable", group: "DefaultOutputTable", label: "Table Title", headers: ["Column 1", "Column 2"], navigationBtnLabel: "See next", data: [ ["foo1", "foo2"], ["bar1", "bar2"] ] } |
| DefaultGroupedPartsOutputControl | [다중 응답](https://servicenow-prod.fluidtopics.net/0LQ~IeGzl1xua8bobCVPTA "주제에서 가상 에이전트 다중 응답 봇 응답 제어를 사용하여 두 개 이상의 출력을 순차적으로 표시합니다. 출력은 텍스트, 이미지, 링크 또는 HTML일 수 있습니다. 사용자는 제공된 탐색 버튼을 통해 한 출력에서 다음 출력으로 이동할 수 있습니다.") 통제에 매핑합니다. 예제: { uiType: "GroupedPartsOutputControl", group: "DefaultGroupedPartsOutputControl" groupPartType: "Link", header: "header message", values: [ { action: "www.foo", description: "description", label: "link_1 label", context: "ITSM" }, ... ] } |
| DefaultMultiPart출력 | [다중 응답](https://servicenow-prod.fluidtopics.net/0LQ~IeGzl1xua8bobCVPTA "주제에서 가상 에이전트 다중 응답 봇 응답 제어를 사용하여 두 개 이상의 출력을 순차적으로 표시합니다. 출력은 텍스트, 이미지, 링크 또는 HTML일 수 있습니다. 사용자는 제공된 탐색 버튼을 통해 한 출력에서 다음 출력으로 이동할 수 있습니다.") 통제에 매핑합니다. 예제: { uiType: "MultiPartOutput", group: "DefaultMultiPartOutput" navigationBtnLabel: "Go next", content: { uiType: "OutputHtml", style: "inline", type: "html", height: 100, width: 100, value: "<div>html</div>" } } |
| DefaultCustomControl | [사용자 지정 컨트롤에 매핑합니다.](https://servicenow-prod.fluidtopics.net/LrOU1Ztc7bYucjqvIUcwFw "주제 또는 주제 블록의 사용자 지정 통제 유틸리티를 가상 에이전트 사용하여 사용자 지정 입력 통제 또는 사용자 지정 응답 통제를 참조합니다. 사용자 지정 컨트롤은 에서 제공하는 도우미 디자이너컨트롤을 보완합니다.") 예제: { uiType: "CustomControl", group: "DefaultCustomControl", name: "The name of the Custom Control (sys_cs_custom_control.name)", required: true/false, uxComponentDefinitionSysId: "seismicComponentId" // or null if not isInput: true/false, // whether to wait for a response value or if just output serializedControlData: "User defined JSON from generateControlData function"; } |
[표 1. 기본 입력 및 출력 리치 컨트롤]

{#default-rich-controls-va-cccif__table_rqm_lvn_qmb}