IBM Watson Assistant Assistant V2 API에 대한 채팅 통합 구성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분

    • Assistant V2 API로 IBM Watson Assistant 생성된 IBM Watson Assistant 대화 기술(대화)을 실행하도록 채팅 통합을 구성합니다. V2 API를 사용하면 가상 에이전트 웹 채팅 클라이언트가 Watson 어시스턴트의 의도 명확성 기능을 사용하는 토픽을 실행하여 토픽 검색을 개선할 수 있습니다.

    시작하기 전에

    IBM Watson Assistant v2 API 채팅 통합을 사용하면 웹 채팅 클라이언트가 작업 공간 대신 도우미와 통신합니다. 작업 공간은 대화 기술이라고 합니다. 에 대한 IBM Watson Assistant자세한 내용은 설명서에서 IBM Watson Assistantv2 API로 마이그레이션을 참조하세요.

    필요한 역할: virtual_agent_admin 또는 admin

    이 태스크 정보

    이 통합은 IBM Watson Assistant 웹 채팅 클라이언트에서 주제로 대화 상자를 가상 에이전트 실행합니다. 활성화 자연어 이해 (NLU)하거나 의 서비스 공급자가상 에이전트로 NLU 설정할 IBM Watson Assistant 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을 찾아 기록합니다.
        의 자원 목록 페이지 IBM Watson Assistant에는 도우미의 API 키와 URL 값이 표시됩니다.
      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 어시스턴트 통합 V2 플러그인(com.glide.cs.ibm.watson.assistant.topicV2)
    5. 에서 가상 에이전트 디자이너V2 주제를 게시합니다 IBM Watson Assistant .
      1. 다음으로 이동 모두 > 대화형 인터페이스 > 가상 에이전트 > 디자이너.
      2. 토픽 페이지에서 V2 토픽을 IBM Watson Assistant 선택하여 토픽 속성 페이지를 엽니다.
        이 항목의 키워드 는 V2입니다 IBM Watson Assistant .
      3. [Topic Properties] 페이지에서 [Publish ]를 선택하여 웹 클라이언트에 주제를 배포합니다 가상 에이전트 .
    6. 모두로 이동한 다음 필터에 sys_properties.list를 입력합니다.
    7. 다음 속성을 업데이트합니다.

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

        watson_assistant.v2.assistantID 속성의 시스템 속성 양식입니다. 예제 Watson Assistant ID 값과 업데이트 버튼이 강조 표시되어 있습니다.

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

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

        Watson Assistant가 댈러스 이외의 데이터 센터(예: Washington 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 찾을 수 있습니다.

        에서 인스턴스 동작을 서비스 포털구성하지 않는 경우 채팅 웹 클라이언트를 열 때 및 sysparm_skip_load_history 매개변수를 사용하여 sysparm_topic 인스턴스 URL을 지정할 수 있습니다. 예: 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입니다.

        중요사항:

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

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