IBM Watson Assistant 어시스턴트 V2 API의 채팅 통합 구성

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

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

    시작하기 전에

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

    필요한 역할: 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 Virtual Agent(com.glide.cs.chatbot)가 아직 활성화되지 않은 경우(구독 필요)
      • IBM Watson Assistant Integration 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 Assistant 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가 댈러스가 아닌 다른 데이터 센터(예: 워싱턴 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. 다음으로 이동 Service Portal > 서비스 포털 구성레이블이 표시됩니다.
      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. 명확성이 있는 예시 항목
      가상 에이전트 명확성 기능을 통해 검색된 추가 의도를 보여주는 대화입니다.