재사용 가능한 주제 블록 만들기

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 대화에서 가상 에이전트 작업의 특정 하위 플로우와 대화 요소를 수행하는 재사용 가능한 구성요소를 빌드합니다.

    시작하기 전에

    팁:
    개발자와 주제 작성자는 다른 애플리케이션 범위에서 생성된 주제 블록에 액세스해야 할 수 있습니다. 액세스 권한을 부여하려면 문서를 참조하십시오 주제 블록 및 사용자 지정 통제에 대한 교차 범위 접근 권한 구성.

    필요한 역할: virtual_agent_admin 또는 admin

    이 태스크 정보

    주제 블록을 사용하여 특정 기록 검색과 같은 일반적인 단계를 실행합니다.

    프로시저

    1. 다음으로 이동 모두 > 대화형 인터페이스 > 가상 에이전트 > 디자이너.
    2. 홈페이지에서 다음 중 하나를 수행합니다.
      • 주제 블록을 처음부터 만들려면 만들기를 선택합니다.
      • 미리 작성된 주제 블록을 기반으로 주제 블록을 만들려면 주제 블록을 열고 다음을 수행합니다.
        1. 헤더 막대에서 복제를 선택합니다.
        2. 새 블록의 이름을 입력하고 저장을 선택합니다.
    3. 시트의 필드에 내용을 입력합니다.
      표 1. 항목 블록 속성 시트
      필드 설명
      유형

      에서 가상 에이전트 디자이너생성할 수 있는 항목 목록입니다.

      주제 블록을 선택하고 추가 속성을 정의합니다.
      주:
      이 주제를 주제 블록으로 설정한 후에는 일반 주제로 변경할 수 없습니다.
      이름 기능적 용도를 반영하는 주제 블록의 고유한 이름입니다. 이 이름은 주제를 만들거나 업데이트할 때 주제 작성자가 선택할 수 있는 주제 블록 목록에 나타납니다.
      설명 항목 블록의 목적에 대한 간략한 설명입니다. 예를 들어 기록을 검색할 수 있습니다.
      고급 속성(선택 사항)
      이 주제에 접근할 수 있는 사람
      채널

      주제 또는 주제 블록이 실행될 채팅 클라이언트입니다.

      이러한 채널은 에서 가상 에이전트기본적으로 지원하는 기본 채널과는 다릅니다. 인스턴스에 대해 생성된 사용자 지정 채팅 통합을 위한 추가 채널이 있을 수 있습니다. 채널에 대한 자세한 내용은 다음 문서를 참조하십시오 다른 채널에 주제 배포 가상 에이전트.

      Live Agent
      라이브 에이전트 컨텍스트 변수 일반 채팅 설정에 정의된 라이브 에이전트 컨텍스트 변수입니다.

      동적 컨텍스트, 즉 채팅의 가상 에이전트 정보를 제공하는 변수를 선택합니다. 이 정보는 봇 대화에서 라이브 에이전트로 전송됩니다.

      라이브 에이전트 변수의 기본 목록에 대한 자세한 내용은 다음 문서를 참조하십시오 라이브 에이전트 채팅 컨텍스트 변수.

      에이전트 자동 파일럿에 사용 가능 라이브 에이전트가 주제 블록을 사용할 수 있는지 여부를 결정하는 토글 스위치입니다.

      활성화하면 에이전트가 주제를 검색하고 호출할 수 있습니다. 자세한 내용은 대화 자동 조종 장치를 참조하십시오.

      팔레트에서 사용 가능
      사용 플로우 탭에 있는 팔레트의 유틸리티 섹션에 주제 블록이 자체 아이콘으로 표시되는지 여부를 결정하는 토글 스위치입니다. 이렇게 하면 다른 작성자가 주제 블록에 쉽게 액세스할 수 있습니다.
      추가
      범주 이 블록이 포함된 범주입니다. 주제 블록에 대한 사용자 지정 주제 범주 를 정의할 수 있습니다.
    4. 생성을 선택합니다.
      플로우 탭이 열립니다. 캔버스에는 StartEnd 노드가 있는 플로우가 표시됩니다.
    5. 블록에 대한 입력을 정의하려면 다음을 수행합니다.
      1. 캔버스에서 시작 노드를 선택합니다.
      2. 시작 세그먼트 속성 시트에서 + 추가를 선택합니다
      3. 시트의 필드에 내용을 입력합니다.
        표 2. 입력 추가 대화 상자
        필드 설명
        이름 입력 값을 저장하는 입력 변수의 이름입니다.
        유형 항목 블록에 전달되는 데이터의 유형입니다. 예를 들어 문자열, 부울 등이 있습니다.

        선택에 따라 필드가 변경됩니다. 자세한 내용은 주제의 가상 에이전트 입력 데이터 유형 문서를 참조하십시오.

        필수 필요에 따라 매개변수를 설정하는 옵션입니다.
        힌트 호출 항목을 작성할 때 표시되는 도구 설명입니다. 다음 예를 참조하십시오.

        "테스트 힌트 문자열"을 표시하는 이 예제의 입력 변수 매핑 도구 설명.

        테이블 ServiceNow 입력을 쿼리하는 데 사용되는 테이블입니다.

        이 필드는 유형 필드에서 참조 또는 Array.Reference를 선택한 경우에만 사용할 수 있습니다.

        최대 행 수 주제 블록에서 정의할 수 있는 최대 행 수입니다.

        이 필드는 유형 필드에서 배열을 선택한 경우에만 사용할 수 있습니다.

        기본값 변수에 대한 기본값입니다. 이 값은 블록을 미리 볼 때 사용할 수 있습니다.

        배열 데이터 형식에는 중복 기본값이 허용되지 않습니다.

        예를 들어, 사전 구축된 컨텍스트 검색 주제 블록은 다음과 같은 입력 매개변수를 제공합니다.

        컨텍스트 검색 주제 블록의 입력 매개변수에는 컨텍스트, 쿼리, 포털 및 kb_knowledge_base가 포함됩니다.

      4. 저장을 선택합니다.
      호출 주제 또는 주제 블록은 입력 매개변수를 주제 블록에 전달합니다.
    6. 통제를 캔버스로 끌어옵니다 가상 에이전트 디자이너 .
      이러한 통제에는 입력, 봇 응답 및 유틸리티가 포함됩니다. 이 둘을 조합하여 주제 블록에서 실행되는 논리를 정의합니다. 자세한 내용은 가상 에이전트 디자이너 컨트롤 문서를 참조하십시오.
    7. 주제 블록에서 반환된 출력을 정의하려면 다음을 수행합니다.
      1. 캔버스에서 End 노드를 선택합니다.
      2. 끝 세그먼트 속성 시트에서 + 새로 추가를 선택합니다.
      3. 시트의 다음 필드에 내용을 입력합니다.
        • 이름: 항목 블록에서 반환된 값의 이름입니다.
        • : 변수가 있는 문자열 또는 호출하는 항목 내에서 사용할 수 있는 스크립트입니다. 값은 정의한 입력 변수(입력 매개변수에 지정된 기본값과 주제 블록에 있는 노드의 입력 값)에 대한 데이터 알약으로 표시됩니다.
        예를 들어, 사전 구축된 컨텍스트 검색 주제 블록은 다음 출력 매개변수를 전달합니다.

        컨텍스트 검색 주제 블록의 출력 매개변수에는 반환된 결과 및 유용한 결과가 포함됩니다.

      4. 저장을 선택합니다.
      주제 블록이 호출 주제에서 실행을 마치면 출력 변수를 호출 주제에 전달할 수 있습니다.
    8. 주제 블록이 실행되는 방식을 보려면 테스트를 선택합니다.
      예를 들어 컨텍스트 검색 주제 블록은 출력 값이 있는 미리 보기 전용 메시지를 포함하여 다음 결과를 반환했습니다. 미리 보기 메시지는 예상 출력을 확인하는 데 도움이 되며 사용자에게 표시되지 않습니다.

      미리 보기 창에는 채팅 대화와 출력 변수 및 해당 값을 보여주는 미리 보기 전용 섹션이 표시됩니다. 예: "results_helpful":true.

    9. 주제 블록을 호출 주제에 사용할 수 있도록 설정할 준비가 되었으면 다음을 수행합니다.
      1. 테스트에 사용한 기본 매개변수를 제거합니다.
      2. 저장을 선택한 다음, 게시를 선택합니다.
      주제 블록 상태가 활성으로 변경되고 통화 주제에 사용할 준비가 되었습니다.

    다음에 수행할 작업

    호출 주제 또는 주제 블록에 재사용 가능한 주제 블록 추가.