가상 에이전트 사전 구축 주제 블록

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분
  • 가상 에이전트 은 주제 작성자 또는 관리자가 봇 대화에서 특정 플랫폼 관련 기능이나 작업을 수행하는 데 사용할 수 있는 사전 구축된 주제 블록을 제공합니다. 예를 들어 특정 주제 블록을 사용하면 에이전트 가용성을 확인하거나 결과를 생성할 AI 검색 수 있습니다.

    사전 구축된 주제 블록의 개요

    사전 구축된 특정 주제 블록은 Glide 가상 에이전트 (com.glide.cs.chatbot) 플러그인 및 가상 에이전트 Lite. 를 사용하는 가상 에이전트 Lite경우 주제 블록에 대한 읽기 권한이 있지만 주제 블록을 생성하거나 호출 주제에 추가할 수는 없습니다.

    를 사용하여 가상 에이전트 디자이너사전 구축된 주제 블록을 복제하고 중복을 수정할 수 있습니다. 주제 블록 작업 및 주제 블록을 호출 주제에 추가하는 방법에 대한 자세한 내용은 및 호출 주제 또는 주제 블록에 재사용 가능한 주제 블록 추가를 참조하십시오주제 블록과 함께 코드 재사용 최대화.

    다음 섹션에서는 다양한 유형의 플랫폼 주제 블록을 호출하기 위한 입력 및 출력 매개변수에 대해 설명합니다. 주제 블록 입력 매개변수는 호출 주제에서 전달되고 출력 매개변수는 주제 블록에서 호출 주제로 반환됩니다.
    주:
    기본 주제 블록으로의 업그레이드는 중복된 주제 블록에 적용되지 않습니다.

    에이전트 가용성 주제 블록

    이 주제 블록을 사용하여 에이전트 핸드오프 대화에 사용할 관련 라이브 에이전트 정보를 가져옵니다. 이 정보에는 에이전트 가용성, 대기 시간(에이전트를 사용할 수 있게 되기까지 걸리는 시간) 및 큐 정보가 포함됩니다. 반환된 정보(예: 에이전트의 긴 대기 시간)를 사용하여 케이스 또는 고객 콜백을 시작할 수 있습니다.

    이 주제 블록에는 를 포함하는 고급 작업 할당(com.glide.interaction.awa) 플러그인이 에이전트 채팅 필요합니다.

    다음 테이블에는 이 주제 블록의 출력 매개변수가 나와 있습니다.

    표 1. 에이전트 가용성 출력 매개변수
    매개변수 설명
    agentAvailable 에이전트 가용성입니다. 이 큐에 에이전트를 사용할 수 있는 경우 이 값은 true입니다. 그렇지 않은 경우 값은 false입니다.
    지원 큐 대화와 연결된 큐의 sys_id입니다. 에이전트를 사용할 수 없거나 연결된 큐가 없는 경우 이 값은 null입니다.
    대기 시간 큐의 평균 수치 대기 시간입니다. 에이전트를 사용할 수 없는 경우 값은 null입니다.

    편향 주제 블록

    대화 주제의 가상 에이전트 편향 주제 블록을 사용하여 사용자의 해결에 도움이 되었거나 실제로 해결된 문제를 가상 에이전트 추적합니다.

    예를 들어, 사전 구축된 자동 해결 가상 에이전트 주제는 편향 주제 블록을 사용하여 편향을 추적합니다. 자세한 내용은 편향 주제 블록을 사용하여 에서 편향 추적 가상 에이전트 문서를 참조하십시오.

    다음 테이블에는 이 주제 블록에 대한 입력 매개변수가 나와 있습니다.

    표 2. 편향 입력 매개변수
    매개변수 설명
    편향 구성 편향 패턴의 그룹입니다.
    편향 패턴 선택한 편향 구성의 편향 패턴입니다.
    활동 테이블 편향 활동이 발생하는 테이블입니다. 이 테이블은 기본 활동 테이블과 연결됩니다. 자세한 내용은 편향 구성 및 패턴 생성 문서를 참조하십시오.
    활동 ID

    쉼표로 구분된 활동 시스템 ID 목록입니다. 예를 들어 인시던트 ID 또는 작업 ID입니다. 또는 컨텍스트 검색 주제 블록의 AI 검색 출력을 추가하여 편향 발생과 동일한 편향에 기여한 컨텐츠 간에 링크를 만들 수도 있습니다.

    FAQ 대화 작성기 주제 블록

    이 주제 블록을 사용하여 기존 FAQ 컨텐츠를 사용하는 봇 대화를 빌드합니다. 이 주제 블록을 사용하면 주제 작성자가 FAQ 템플릿에 게시된 기존 지식 문서를 사용하거나 스프레드시트와 같은 소스에서 임포트한 Q&A 데이터를 사용하여 간단한 대화를 작성할 수 있습니다.

    FAQ 대화 작성기 주제 블록은 상황별 검색을 사용하여 FAQ 컨텐츠에서 적절한 일치 항목을 찾습니다. FAQ 콘텐츠는 요청자 역할, 접근 권한 및 컨텍스트에 따라 접근이 통제됩니다.

    FAQ 지식 템플릿을 사용하려면 지식 관리 Advanced 플러그인을 활성화하십시오.

    주:
    대화에서 반환되는 FAQ 스니펫의 기본 길이는 400자입니다. 스니펫 길이에는 스니펫에 사용되는 HTML 태그와 링크가 포함됩니다. 스니펫 길이를 변경하려면 시스템 속성의 값을 com.glide.cs.faq.display_size 변경합니다. 시스템은 지정된 길이를 적용하는 것 외에도 단어 줄 바꿈 논리를 적용하여 스니펫의 단어와 링크가 임의로 잘리지 않도록 합니다.

    다음 테이블에는 이 주제 블록에 대한 입력 및 출력 매개변수가 나열되어 있습니다.

    표 3. FAQ 대화 작성기 입력 매개변수
    매개변수 설명
    쿼리 주제 블록에 전달되는 검색어 또는 구입니다. 입력 변수 또는 스크립트 변수를 선택합니다.
    포털 검색에 대한 컨텍스트입니다. 입력 변수 또는 스크립트 변수를 선택합니다.
    kb_knowledge 검색에 대한 지식베이스입니다. 입력 변수 또는 스크립트 변수를 선택합니다.
    표 4. FAQ 대화 작성기 출력 매개변수
    매개변수 설명
    Results_Returned 쿼리에서 결과가 반환되었는지 여부를 나타내는 부울 값입니다.
    Results_Helpful 사용자가 결과가 도움이 된다고 생각하는지 여부를 나타내는 부울 값입니다.

    양식 컨텐츠 팝업 주제 블록

    이 주제 블록을 사용하여 채팅 위젯에서 팝업 창의 양식을 엽니다. 사용자가 필요한 정보를 제출하면 기록이 채팅 창에 카드로 가상 에이전트 나타납니다. 새 기록이 생성되면 해당 기록에 대한 시스템 ID가 서버로 전송되어 주제에 해당 정보가 포함됩니다 가상 에이전트 . 링크에서 팝업 창을 만드는 방법에 대한 자세한 내용은 문서를 참조하십시오 스마트 링크 기본 설정 생성.

    표 5. 양식 컨텐츠 팝업 주제 블록 입력 매개변수
    매개변수 설명
    sysId 매개변수에 지정된 테이블에서 표시할 기록의 시스템 ID입니다 table . 특정 기록을 원하지 않으면 -1을 입력하여 새 기록을 생성합니다.
    테이블 쿼리를 수행하거나 기록을 생성할 테이블의 이름입니다.
    테이블에 대해 생성한 뷰의 이름입니다. 지정하지 않으면 기본 뷰가 사용됩니다.

    지리적 위치 주제 블록

    사용자가 동의하는 경우 이 주제 블록을 사용하여 사용자의 위치에 대한 정보를 검색합니다. 대화에서 주제 블록을 호출하기 전에 사용자에게 위치를 알릴지 묻는 메시지가 표시됩니다. 예를 들어 사용자에게 다음과 유사한 프롬프트가 표시됩니다.
    그림 1. 사용자 권한 프롬프트
    차단 및 허용 버튼이 있는 대화 상자와 사용자의 위치를 알기 위해 익명화된 웹 사이트의 메시지입니다.
    사용자는 요청을 차단하거나 위치를 알 수 있도록 선택할 수 있습니다. 사용자가 허용을 클릭하면 나중에 다음 예제와 같이 위치를 공유할 것인지 묻는 메시지가 표시됩니다.
    그림 2. 채팅에서 지리적 위치 사용
    채팅 창에서 가상 에이전트 "위치를 공유하시겠습니까?"라고 묻습니다.

    다음 테이블에는 이 주제 블록에 대한 입력 및 출력 매개변수가 나열되어 있습니다.

    표 6. 지리적 위치 입력 매개변수
    매개변수 설명
    permissionPrompt(문자열) 사용자의 위치를 사용할 수 있는 권한을 요청하는 텍스트입니다. 이 텍스트는 사용자에게 표시됩니다.
    isGeoPermissionGrantedForNextUse 대화 중에 이 요청을 두 번 이상 요청하는 경우 사용자가 위치 좌표를 검색할 수 있는 권한을 부여했는지 여부를 결정하는 부울 값입니다. 변수는 다음과 같이 설정할 수 있습니다.
    • True: 사용자가 이 장치에 대한 권한을 부여했기 때문에 권한 프롬프트를 다시 표시하지 않습니다.
    • False: 사용자가 권한을 거부했거나 좌표를 한 번만 검색할 수 있도록 허용했기 때문에 권한 프롬프트를 표시합니다.
    표 7. 지리적 위치 출력 매개변수
    매개변수 설명
    위도 위도 좌표입니다.
    경도 경도 좌표입니다.
    errormessage 오류가 있는 경우 오류와 관련된 메시지입니다.
    오류 유형 항목 블록에서 반환되는 변수입니다. 오류 유형은 다음과 같습니다.
    • PERMISSION_DENIED
    • POSITION_UNAVAILABLE
    • TIMED_OUT
    • UNKNOWN_ERROR
    상태 항목 블록에서 반환되는 변수입니다. 상태는 다음과 같습니다.
    • 확인: 위치 좌표를 검색했습니다.
    • 오류: 검색에 실패했습니다.

    주제 블록 일시 중지

    이 주제 블록을 사용하면 일시 중지를 생성하여 대화의 속도를 제어할 수 있습니다. 최종 사용자에게 이 피드백은 매끄럽게 제공되며 입력 표시기로 표시됩니다.

    예를 들어 채팅에서 지식베이스 링크 목록이 생성된 경우 대화를 계속하기 전에 지연을 추가하여 최종 사용자가 정보를 읽을 시간을 줄 수 있습니다.

    일시 중지 주제 블록은 더 쉽게 액세스할 수 있도록 팔레트의 유틸리티 섹션에 표시됩니다.

    다음 테이블에는 이 주제 블록에 대한 입력 매개변수가 나와 있습니다.

    표 8. 일시 중지 입력 매개변수
    매개변수 설명
    채팅을 계속하기 전에 대기할 시간(초)입니다. 허용되는 최대값은 60초입니다.

    입력한 값이 30초(기본값) 이하인 경우 블록은 거의 실시간으로 일시 중지됩니다. 입력한 값이 30초보다 크면 최대 대기 시간이 +30초로 일시 중지가 해제될 것으로 예상합니다. 예를 들어 값을 31초로 설정하면 일시 중지를 해제하는 데 최대 61초가 걸릴 수 있습니다(최대).

    주제 블록 실행 AI 검색

    주:
    이전 릴리스 또는 이전 릴리스에서 Rome 업그레이드하는 경우 레거시 AI 검색 주제 블록을 주제 실행 AI 검색 블록으로 바꿔야 작동합니다.

    이 주제 블록을 사용하여 대화의 결과를 생성합니다 AI 검색 . 이 블록은 의 애플리케이션에 가상 에이전트의해 AI 검색 제어되기 때문에 호출 주제의 특정 입력 매개변수가 필요하지 않습니다. 채팅 환경의 기본 가상 에이전트 검색 애플리케이션 및 EVAM 구성 세트는 대화에 결과가 표시되는 방식을 AI 검색 제어합니다.

    사용 AI 검색방법에 가상 에이전트 대한 자세한 내용은 를 참조하십시오를 통해 사용자 경험 개선 AI 검색. 채팅 경험 및 채팅 경험 구성 방법에 대한 가상 에이전트 자세한 내용은 다음 문서를 참조하십시오 가상 에이전트 채팅 경험 사용자 지정.

    주제 실행 AI 검색 블록의 특정 측면을 제어할 수 있습니다.
    • 선택적으로 사용자 AI 검색 지정 환경 - 기본 가상 에이전트 검색 애플리케이션 구성 대신 주제 블록에서 사용할 사용자 지정 검색 애플리케이션 구성을 만들어 검색 환경을 사용자 지정할 수 있습니다. 검색 애플리케이션 구성은 대화에서 반환되는 검색 결과를 정의합니다. 주제 블록에서 사용자 지정 검색 애플리케이션 구성을 사용하는 방법에 대한 자세한 내용은 을 참조하십시오 대화를 위한 가상 에이전트 사용자 지정 AI 검색 환경 만들기.

      에 대한 AI 검색기본 가상 에이전트 구성을 사용하려면 주제에 실행 주제 블록을 추가할 AI 검색 때 주제 블록 속성 시트에서 검색 애플리케이션 구성 필드를 비워 둡니다.

    • AI 검색 플로우 작업 시간 제한 값 지정 - AI 검색 주제 블록의 플로우 작업이 10초마다 자동으로 시간 초과됩니다. 시스템 속성을 추가하고 com.glide.cs.fdih.atlassearch.timeout 다음 필드를 설정하여 시간 제한 값을 변경하면 이 플로우 작업이 시간 초과되기 전의 시간을 변경할 수 있습니다.
      표 9. com.glide.cs.fdih.atlassearch.timeout에 대한 시스템 속성 필드
      필드
      이름 시스템 속성 이름: com.glide.cs.fdih.atlassearch.timeout 입력
      설명 이 속성에 대한 설명을 입력합니다. AI 검색 작업 시간 제한(초)
      유형 정수를 선택합니다.

      작업 시간이 초과되기 전 시간(초)을 AI 검색 입력합니다. 기본값은 10초입니다.

    다음 테이블에는 이 주제 블록에 대한 입력 및 출력 매개변수가 나열되어 있습니다. 출력 매개변수의 경우 주제 블록에서 반환된 변수를 비활성화할 수 있는 옵션이 있습니다.

    표 10. 입력 매개변수 실행 AI 검색
    매개변수 설명
    search_term 대화 중에 사용자가 입력한 구문입니다.
    표 11. AI 검색 실행 출력 매개변수
    매개변수 설명
    genius_results 반환된 천재 결과를 식별하는 변수입니다.
    search_results 반환된 일반 검색 결과(다중 목록 출력)를 식별하는 변수입니다.
    search_metadata 사용된 검색어, 쿼리 언어 등과 같이 대화형 분석의 클릭 메트릭에 사용되는 검색 결과 메타데이터를 식별하는 변수입니다.

    런타임 언어 탐지 주제 블록

    이 주제 블록을 사용하여 대화 중에 사용자의 언어를 탐지하고 에서 언어가 지원되는 ServiceNow AI Platform경우 대화 중에 해당 언어로 전환할 수 있습니다.

    예를 들어 게스트 사용자가 현재 대화 언어와 다른 언어로 봇과 상호작용하는 대화에서 이 주제 블록을 사용하여 그에 따라 언어를 변경할 수 있습니다. 이 주제 블록을 사용하면 봇에서 다음을 수행할 수 있습니다.
    • 지원되는 가상 에이전트 모든 채널의 대화에서 언어를 탐지합니다.
    • 언어가 에서 지원되는지 확인하고, 지원되는 ServiceNow AI Platform경우 사용자에게 검색된 언어로 전환할지 여부를 묻습니다.
    • 사용자가 전환에 동의하면 대화 중에 검색된 언어로 전환합니다.

    이 주제 블록을 사용하려면 가상 에이전트 언어 탐지 및 번역 플러그인 [com.glide.cs.runtime_language_detection_translation]을 활성화하십시오.

    다음 테이블에는 이 주제 블록에 대한 입력 매개변수가 나와 있습니다.

    표 12. 런타임 언어 탐지 입력 매개변수
    매개변수 설명
    발언(문자열) 사용자가 입력한 텍스트입니다.
    언어 변경(부울) 다음을 수행하는 메시지를 사용자에게 표시하는 옵션입니다.
    • 사용자가 다른 언어로 입력하는 것을 봇이 탐지했음을 나타냅니다.
    • 지원되는 언어로 대화를 계속할지 여부를 묻습니다. 사용자가 예라고 대답하면 대화가 지원되는 언어로 변경됩니다.