for Assistant V2 API와 IBM Watson Assistant 통합 가상 에이전트

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

    • IBM Watson Assistant 도우미 V2 API로 생성된 IBM Watson Assistant 대화 기술(대화)을 실행하도록 채팅 통합을 구성합니다. V2 API를 사용하면 채팅 위젯이 가상 에이전트 Watson Assistant의 의도 명확성 기능을 사용하여 주제 검색을 개선하는 주제를 실행할 수 있습니다.

    시작하기 전에

    주:
    주제 기술을 설치하고 Now Assist가상 에이전트 켜면 Now Assist 업데이트된 가상 에이전트 디자이너 사용자 인터페이스를 사용할 수 있습니다. 이 컨텐츠에서는 사용자가 이 기술을 활성화했으며 목록 뷰를 볼 수 있다고 가정합니다. 이 기술이 활성화되지 않으면 레거시 UI 및 주제 페이지가 표시됩니다. 자세한 내용은 가상 에이전트 디자이너 레거시 주제 페이지를 참조하십시오.

    IBM Watson Assistant v2 API 채팅 통합을 사용하면 채팅 위젯이 작업 공간 대신 도우미와 통신합니다. 작업 공간을 대화 기술이라고 합니다. 에 대한 IBM Watson Assistant자세한 내용은 설명서의 v2 APIIBM Watson Assistant 로 마이그레이션을 참조하십시오.

    필요한 역할: virtual_agent_admin 또는 admin

    이 태스크 정보

    이 통합은 IBM Watson Assistant 채팅 위젯에서 대화 상자를 주제로 가상 에이전트 실행합니다. ()를 활성화 자연어 이해 하거나 에 대한 가상 에이전트서비스 제공자로 NLU 설정할 IBM Watson Assistant NLU 필요가 없습니다.NLU

    V2 API를 사용하면 IBM Watson Assistant 채팅 위젯이 Watson Assistant 의도 명확성 기능을 사용할 수 있으며, 이는 잠재적으로 거짓 긍정 의도 예측을 줄일 수 있습니다. 사용자의 발화가 모호한 IBM Watson Assistant 경우 는 사용자의 실제 의도와 더 잘 일치할 수 있는 추가 의도를 제안합니다. 예를 들어 사용자 발언이 레스토랑IBM Watson Assistant인 경우 레스토랑 예약이나 레스토랑 리뷰 등 가능한 다른 의도를 제안할 수 있습니다.

    프로시저

    1. IBM Watson Assistant 항목을 구성합니다.
      1. 도우미를 만든 다음, 대화 기술을 추가합니다.
        자세한 내용은 설명서의 도우미IBM Watson Assistant 만들기를 참조하세요.
      2. 자원 목록 페이지에서 채팅 통합을 설정하는 데 필요한 API 키와 URL을 찾아 기록합니다.
        도우미의 API 키 및 URL 값을 보여주는 의 IBM Watson Assistant자원 목록 페이지입니다.
      3. 세 개의 세로 점 아이콘 추가 작업 아이콘을 선택합니다. 을 클릭하고 설정을 선택합니다.
        • API 세부 정보 탭을 선택합니다.
        • 도우미 설정 페이지에서 도우미 ID 키를 찾습니다.

        IBM Watson Assistant 사용할 대화 기술에 대한 설정입니다. API 상세 정보 및 도우미 ID가 여기에 강조 표시됩니다.

    2. 에서 IBM Watson Assistant 명확성 기능을 활성화합니다(프리미엄 및 플러스 사용자만 해당).
      각 기술에 대해 명확성을 활성화(또는 비활성화)할 수 있으며, 최종 사용자에게 표시할 명확성 메시지와 제안 수를 지정할 수도 있습니다.
      1. 패널에서 기술 트리 아이콘 기술 트리 아이콘을 선택하여 기술에 액세스합니다.
        기술 트리 아이콘이 강조 표시된 도우미 목록입니다 IBM Watson Assistant .
      2. 다음으로 이동 옵션 > 동음이의 동음이의를 활성화하고 동음이의 기능을 설정합니다.
        다음 예제에서는 명확성 메시지 및 최종 사용자에게 표시할 제안된 의도 수와 같이 설정할 수 있는 명확성 기능을 보여 줍니다.

        의 IBM Watson Assistant동음이의 형태 . 동음이의 탭, 켜기-끄기 토글, 동음이의 메시지, 기타 메시지 및 제안 최대값이 강조 표시됩니다.

    3. 대화 상자로 이동하여 명확성 기능을 적용할 노드를 선택하고 의도 제안 중 하나인 경우 사용자에게 표시될 노드 요약을 제공합니다.
      명확성을 위한 대체 의도 선택으로 사용자에게 표시되는 노드 목적 요약이 있는 대화 상자 노드입니다. 선택적 노드 요약이 강조 표시됩니다.
    4. ServiceNow 인스턴스에서 다음 플러그인을 활성화합니다.
      • Glide 가상 에이전트(com.glide.cs.chatbot), 아직 활성화되지 않은 경우(구독 필요)
      • IBM Watson Assistant Integration V2 플러그인(com.glide.cs.ibm.watson.assistant.topicV2)
    5. 에서 가상 에이전트 디자이너V2 주제를 게시합니다 IBM Watson Assistant .
      1. 다음으로 이동 대화형 인터페이스 > 가상 에이전트 > 디자이너 을 클릭하고 NLU/키워드 토글을 선택합니다.모두 > 대화형 인터페이스 > 가상 에이전트 > 디자이너.
      2. 가상 에이전트 디자이너 홈페이지에서 V2 주제를 선택하여 IBM Watson Assistant 주제 속성 페이지를 엽니다.
        이 주제의 키워드 는 V2입니다 IBM Watson Assistant .
      3. 주제 속성 페이지에서 게시 를 선택하여 채팅 위젯에 가상 에이전트 주제를 배포합니다.
    6. 모두로 이동한 다음 필터에 sys_properties.list를 입력합니다.
    7. 다음 속성을 업데이트합니다.

      • watson_assistant.v2.assistantID — 값 필드에 어시스턴트의 Watson 어시스턴트 ID를 입력하고 업데이트를 선택합니다.

        watson_assistant.v2.assistantID 속성에 대한 시스템 속성 양식입니다. Watson 어시스턴트 ID 값 예와 업데이트 버튼이 강조표시됩니다.

      • watson_assistant.v2.service_endpoint — 값 필드에서 기존 값을 Watson 어시스턴트 URL로 바꾸고 업데이트를 선택합니다.

        watson_assistant.v2.service_endpoint 속성의 양식입니다. 예시 URL 값과 업데이트 버튼이 강조 표시됨.
        주:
        값 필드에서 서비스 인스턴스 URL의 위치 부분만 지정할 수 있습니다. 예를 들어 IBM Watson 서비스 엔드포인트의 기준 URL이 https://gateway.watsonplatform.net/assistant/api 인 경우 값 필드에 gateway.watsonplatform.net 서비스 인스턴스의 위치만 입력할 수 있습니다.

        Watson 어시스턴트가 댈러스가 아닌 다른 데이터 센터(예: 워싱턴 DC)에서 호스팅되는 경우 기본 URL은 https://gateway-wdc.watsonplatform.net/assistant/api 입니다. 값 필드에 gateway-wdc.watston.platform.net 입력합니다.

    8. Watson Assistant API 키를 프로파일의 비밀번호로 IBM Watson Assistant 설정하십시오.
      1. 모두로 이동한 다음 필터에 sys_auth_profile_basic.list를 입력합니다.
      2. IBM Watson Assistant 프로파일 기록을 엽니다.
      3. 기본 인증 구성 양식에서 암호 필드에 Watson Assistant API 키를 입력하고 업데이트를 선택합니다.
        에 IBM Watson Assistant 대한 기본 인증 구성 암호 필드와 업데이트 버튼이 강조 표시된 프로파일입니다.
    9. 가상 에이전트 (웹 채팅) 클라이언트를 서비스 포털에 추가합니다.
      1. 다음으로 이동 서비스 포털 > 서비스 포털 구성.
      2. 디자이너를 선택한 다음 Service Portal 방문 페이지를 선택합니다.
      3. 위젯을 가상 에이전트 검색하고 위젯을 윤곽선 영역으로 드래그합니다.
        보라색 채팅 아이콘이 오른쪽 아래 모서리에 나타납니다.

        서비스 포털 위젯, 디자인 캔버스 및 채팅 아이콘이 강조 표시된 디자이너 페이지 가상 에이전트 서비스 포털 입니다.

    10. 편집 아이콘을 선택하여 위젯을 가상 에이전트 구성합니다. 오른쪽 상단 모서리에 있는 편집 아이콘을 클릭하여 채팅 클라이언트에 전달된 URL 매개변수를 설정하고 부동 채팅 버튼의 색상을 변경합니다.
      1. 가상 에이전트 클라이언트 URL 매개변수 필드에 주제 기록이 채팅 클라이언트에 sysparm_topic 표시되지 않도록 매개변수를 입력하고 실행될 게시된 IBM Watson Assistant V2 주제의 sys_id 매개변수를 입력합니다 sysparm_skip_load_history=true.
        주제 [sys_cs_topic] 테이블에서 주제의 sys_id 찾을 수 있습니다.

        에서 서비스 포털인스턴스 동작을 구성하지 않은 경우 채팅 채팅 위젯을 열 때 인스턴스 URL을 sysparm_topic 및 sysparm_skip_load_history 매개변수를 사용하여 지정할 수 있습니다. 예: https://<인스턴스 URL>$sn-va-web-client-app.do?sysparm_skip_load_history=true&sysparm_topic=<sys_id> 여기서 <sys_id> 는 실행할 게시된 IBM Watson Assistant V2 주제의 sys_id입니다.

        중요사항:

        sysparm_topic 매개변수는 채팅 클라이언트에서 지정된 주제를 서비스 포털 로드하거나 채팅 통합(com.glide.cs.ibm.watson.assistant.topic 및 com.glide.cs.ibm.watson.assistant.topicV2 플러그인)을 IBM Watson Assistant 사용할 때만 사용하십시오. 이 매개변수를 사용하면 사용자가 새 대화를 시작하거나 라이브 에이전트로 전송할 수 없습니다. 또한 상황에 맞는 메뉴를 비활성화하고 다른 타사 채팅 클라이언트를 지원하지 않습니다.

      2. 부동 단추 색상을 변경하려면 부동 버튼 색상 필드에 새 색상(RGB 16진수 형식)을 입력합니다.
      3. 저장을 선택합니다.
        서비스 포털 인스턴스 대화 상자가 열려 있는 디자이너 페이지. 가상 에이전트 클라이언트 URL 매개변수 필드가 강조 표시되어 있습니다.
    11. 명확성 기능이 주제에 작동하는지 테스트합니다.
      Watson Assistant 기술과 두 개 이상의 대화 노드에 대해 명확성이 활성화되어 있는지 확인하십시오. 다음 예에서 가상 에이전트는 사용자가 선택할 수 있는 네 가지 추가 의도를 제공합니다.
      그림 1. 명확성이 있는 예제 주제
      가상 에이전트 명확성 기능을 통해 검색된 추가 의도를 보여주는 대화입니다.