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

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

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

    시작하기 전에

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

    v2 API 채팅 통합을 IBM Watson Assistant 사용하면 채팅 위젯이 작업 공간 대신 도우미와 통신합니다. 작업 공간을 대화 기술이라고 합니다. 에 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. 세로 점 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 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가 댈러스가 아닌 다른 데이터 센터(예: 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. 디자이너를 선택한 다음 서비스 포털 방문 페이지를 선택합니다.
      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입니다.

        중요사항:

        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 기술 및 두 개 이상의 대화 노드에 대해 명확성 제거가 사용 가능한지 확인하십시오. 다음 예에서 가상 에이전트는 사용자가 선택할 수 있는 4개의 추가 의도를 제공합니다.
      그림 1. 명확성이 있는 주제 예시
      가상 에이전트 중의어 제거 기능을 통해 검색된 추가 의도를 보여주는 대화입니다.