가상 에이전트 플랫폼 주제 블록

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

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

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

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

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

    에이전트 가용성 주제 블록

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

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

    다음 표에는 이 주제 블록의 출력 매개변수가 나열되어 있습니다.

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

    편향 주제 블록

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

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

    다음 표에는 이 주제 블록의 입력 매개변수가 나열되어 있습니다.

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

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

    FAQ 대화 작성기 주제 블록

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

    FAQ 대화 작성기 주제 블록은 Contextual Search 를 사용하여 FAQ 컨텐츠에서 적절한 일치 항목을 찾습니다. FAQ 컨텐츠는 요청자 역할, 접근 권한 및 컨텍스트에 따라 접근을 제어합니다.

    지식 관리 Advanced 플러그인을 활성화하여 FAQ 지식 템플릿을 사용합니다.

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

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

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

    양식 컨텐츠 팝업 주제 블록

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

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

    지리적 위치 주제 블록

    사용자가 동의하는 경우 이 주제 블록을 사용하여 사용자의 위치에 대한 정보를 검색합니다. 대화에서 주제 블록이 호출되기 전에 사용자는 자신의 위치를 알기를 원하는지 묻습니다. 예를 들어 사용자에게 다음과 유사한 프롬프트가 표시됩니다.
    그림 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 반환된 Genius 결과를 식별하는 변수입니다.
    search_results 반환된 일반 검색 결과(다중 목록 출력)를 식별하는 변수입니다.
    search_metadata 사용된 검색어, 쿼리 언어 등 대화형 분석에서 클릭 메트릭에 사용되는 검색 결과 메타데이터를 식별하는 변수입니다.

    런타임 언어 탐지 주제 블록

    이 주제 블록을 사용하여 대화 중에 사용자의 언어를 탐지하고 언어가 지원되는 경우 대화 중간에 해당 언어로 전환합니다 Now Platform.

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

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

    다음 표에는 이 주제 블록의 입력 매개변수가 나열되어 있습니다.

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