watson banking chatbot

경고: 이 저장소는 더 이상 유지 관리되지 않습니다. ️

이 저장소는 업데이트되지 않습니다. 저장소는 읽기 전용 모드로 유지됩니다.

FAQ 검색, 분노 감지 및 자연어 이해 기능을 갖춘 뱅킹 챗봇 만들기

이번 코드 패턴에서는 Node.js와 Watson Assistant를 사용하여 챗봇을 만들어 보겠습니다. 보조자 흐름은 고객 감정을 감지하고 자연어 이해를 사용하여 위치 엔터티를 식별함으로써 향상됩니다. FAQ의 경우 Discovery 서비스 호출은 구절 검색을 사용하여 문서 모음에서 답변을 가져옵니다.

독자가 이 패턴을 완료하면 다음 방법을 이해하게 됩니다.

• Watson Assistant 및 Node.js를 사용하여 웹 UI를 통해 대화하는 챗봇 만들기
• 구절 검색과 함께 Watson Discovery를 사용하여 FAQ 문서에서 답변 찾기
• Watson Natural Language Understanding으로 위치 엔터티 식별

참고 : 이 코드 패턴은 IBM Cloud Pak for Data에서 실행되는 Watson 서비스에 액세스하기 위한 지침을 포함하도록 업데이트되었습니다. 이러한 업데이트는 앱을 로컬로 배치하거나 OpenShift on IBM Cloud에 앱을 배치하기 위한 특정 지시사항에서 찾을 수 있습니다. 필요한 주요 변경 사항은 Watson 서비스를 호스팅하는 IBM Cloud Pak for Data 클러스터에 액세스하려면 애플리케이션에 추가 자격 증명이 필요하다는 것입니다.

IBM Cloud Pak for Data에 대한 자세한 내용을 보려면 여기를 클릭하십시오.

흐름

1. FAQ 문서가 Discovery 컬렉션에 추가되었습니다.
2. 사용자는 앱 UI를 통해 챗봇과 상호작용합니다.
3. 사용자 입력은 NLU(자연어 이해)로 처리됩니다. NLU가 감지한 엔터티와 키워드(예: 위치)로 컨텍스트가 강화됩니다.
4. 입력 및 강화된 컨텍스트가 Assistant로 전송됩니다. 어시스턴트는 인텐트, 엔터티 및 대화 경로를 인식합니다. 응답 및/또는 작업으로 응답합니다.
5. 선택적으로 요청된 작업이 앱에서 수행됩니다. 여기에는 다음 중 하나가 포함될 수 있습니다.
   • 회신에 추가할 은행 서비스에서 추가 정보를 조회합니다.
   • Discovery를 사용하여 FAQ 문서의 답변을 회신하세요.

포함된 구성 요소

• IBM Watson Assistant: 모바일 장치, 메시징 플랫폼 또는 실제 로봇 전반에 걸쳐 봇 또는 가상 에이전트를 구축, 테스트 및 배포합니다.
• IBM Watson Discovery: 패턴, 추세 및 실행 가능한 통찰력을 식별하는 애플리케이션을 위한 인지 검색 및 콘텐츠 분석 엔진입니다.
• IBM Watson Natural Language Understanding: 텍스트를 분석하여 자연어 이해를 사용하여 개념, 엔터티, 키워드, 카테고리, 정서, 감정, 관계, 의미론적 역할과 같은 콘텐츠에서 메타데이터를 추출합니다.

주요 기술

• Node.js: 확장 가능한 애플리케이션을 구축하도록 설계된 비동기 이벤트 기반 JavaScript 런타임입니다.

단계

1. 저장소 복제
2. Watson 서비스 만들기
3. Watson Assistant 기술 사용자 정의
4. 검색 문서 로드
5. 애플리케이션 배포
6. 웹 앱 사용

1. 저장소 복제

watson-banking-chatbot 로컬로 복제합니다. 터미널에서 다음을 실행합니다.

git clone https://github.com/IBM/watson-banking-chatbot

2. Watson 서비스 만들기

다음 서비스를 제공합니다.

• 왓슨 어시스턴트
• 왓슨 디스커버리
• Watson 자연어 이해

참고 : Deploy to Cloud Foundry on IBM Cloud 배포 옵션을 사용하는 경우 다음 단계를 건너뛰고 애플리케이션 배포 섹션으로 바로 이동할 수 있습니다. 해당 배포 옵션은 자동으로 서비스를 생성하고 이를 애플리케이션에 연결합니다.

지침은 IBM Cloud Pak for Data 또는 IBM Cloud를 사용하여 서비스를 프로비저닝하는지 여부에 따라 다릅니다.

하나를 확장하려면 클릭하세요:

IBM Cloud Pak for Data

세 가지 서비스 각각에 대해 다음 지침을 따르세요.

서비스 인스턴스 설치 및 프로비저닝

기본적으로 서비스를 사용할 수 없습니다. 관리자는 이를 IBM Cloud Pak for Data 플랫폼에 설치해야 하며 사용자에게 서비스에 대한 액세스 권한을 부여해야 합니다. 서비스가 설치되어 있는지 확인하려면 서비스 아이콘( ) 서비스가 활성화되어 있는지 확인하세요.

IBM 클라우드

서비스 인스턴스 만들기

• IBM Cloud 계정이 없으면 여기에서 무료 평가판 계정을 등록하세요.
• Watson Assistant 인스턴스를 생성하려면 여기를 클릭하세요.
• Discovery 인스턴스를 생성하려면 여기를 클릭하세요.
• 자연어 이해 인스턴스를 생성하려면 여기를 클릭하세요.

3. Watson Assistant 기술 사용자 정의

다음 지시사항은 IBM Cloud 또는 IBM Cloud Pak for Data 클러스터에서 Assistant를 프로비저닝하는지에 따라 달라집니다. 하나를 선택하세요:

IBM Cloud Pak for Data에 프로비저닝

• IBM Cloud Pak for Data 대시보드의 Provisioned Instances 목록에서 Assistant 서비스를 찾으십시오.
• 어시스턴트 서비스와 관련된 옵션 메뉴에서 View Details 를 클릭하세요.
• Open Watson Assistant 를 클릭하세요.
• Skills 탭으로 이동합니다.
• Create skill 클릭하세요.
• Dialog skill 옵션을 선택한 후 Next 클릭하십시오.
• Import skill 탭을 클릭하세요.
• Choose JSON file 을 클릭하고 복제된 저장소 디렉터리로 이동한 후 data/conversation/workspaces/banking_US.json 에서 JSON 파일을 Open (또는 full_banking.json 에서 이전 전체 버전 사용). banking_IN.json 인도 은행 콘텐츠에 사용되며, banking_US.json 미국 은행 콘텐츠에 사용됩니다.
• Everything 선택하고 Import 클릭합니다.

IBM Cloud에서 프로비저닝

• IBM Cloud 대시보드에서 Assistant 서비스를 찾으세요.
• 서비스를 클릭한 다음 Launch tool 을 클릭합니다.
• Skills 탭으로 이동합니다.
• Create skill 클릭합니다.
• Dialog skill 옵션을 선택한 후 Next 클릭하십시오.
• Import skill 탭을 클릭하세요.
• Choose JSON file 을 클릭하고 복제된 저장소 디렉터리로 이동한 후 data/conversation/workspaces/banking_US.json 에서 JSON 파일을 Open (또는 full_banking.json 에서 이전 전체 버전 사용). banking_IN.json 인도 은행 콘텐츠에 사용되며, banking_US.json 미국 은행 콘텐츠에 사용됩니다.
• Everything 선택하고 Import 클릭합니다.

Watson Assistant의 Skill ID 찾으려면 다음을 수행하세요.

• Skills 탭으로 돌아갑니다.

• 카드 오른쪽 상단에 있는 점 3개를 클릭하고 View API Details 선택합니다.

• Skill ID GUID를 복사합니다. 런타임 환경을 설정할 때 이 값을 사용하십시오.

• 기본적으로 애플리케이션은 watson-banking-chatbot 이라는 스킬을 가져와 사용하지만 런타임 환경 변수 SKILL_ID 설정하여 다른 스킬을 사용하도록 구성할 수 있습니다.

  

보조자 대화 상자를 보려면 스킬을 클릭하고 Dialog 탭을 선택하세요. 다음은 대화상자의 일부입니다.

4. 검색 문서 로드

기본적으로 애플리케이션은 watson-banking-chatbot 이라는 컬렉션을 생성하지만 런타임 환경 변수 DISCOVERY_COLLECTION_ID 및 DISCOVERY_ENVIRONMENT_ID 설정하여 다른 컬렉션을 사용하도록 구성할 수 있습니다.

다음 지시사항은 IBM Cloud 또는 IBM Cloud Pak for Data 클러스터에서 Discovery를 프로비저닝하는지에 따라 달라집니다. 하나를 선택하세요:

IBM Cloud Pak for Data에 프로비저닝

• IBM Cloud Pak for Data 대시보드의 Provisioned Instances 목록에서 Discovery 서비스를 찾으십시오.
• Discovery 서비스와 관련된 옵션 메뉴에서 View Details 를 클릭합니다.
• Open Watson Discovery 를 클릭합니다.
• 기존 Discovery Project 클릭하거나 새 프로젝트를 생성하세요.
• Project 패널에서 Collections 탭을 클릭하세요.
• New Collection + 을 클릭하세요.
• Upload data 옵션을 선택하고 Next 클릭합니다.
• 컬렉션 이름을 제공하세요.
• English 를 선택하세요.
• Finish 클릭하여 컬렉션을 생성합니다.
• Drag and drop your documents here or select documents 복제된 저장소의 data/discovery/docs 에 있는 5개 문서로 콘텐츠를 시드하세요.
• Discovery 패널의 왼쪽 메뉴에서 Integrate and deploy 옵션을 클릭합니다. 그런 다음 View API Details 탭을 선택하여 Project Id 확인하세요. 런타임 환경을 설정할 때 이를 Collection ID 값으로 사용하세요.

참고 : Cloud Pak for Data 컬렉션의 Environment Id 항상 default 으로 설정됩니다.

IBM Cloud에서 프로비저닝

• IBM Cloud 대시보드에서 Discovery 서비스를 찾으세요.

• 서비스를 클릭한 다음 Launch tool 을 클릭합니다.

• Upload your own data 버튼을 눌러 새 데이터 컬렉션을 만듭니다.

  

  • 컬렉션 이름을 입력하세요.
  • English 를 선택하세요
  • Create 클릭하세요

• Drag and drop your documents here or select documents 복제된 저장소의 data/discovery/docs 에 있는 5개 문서로 콘텐츠를 시드하세요.

• 오른쪽 상단 api 아이콘을 클릭하고 런타임 환경을 설정할 때 필요하므로 Environment ID 와 Collection ID 저장하세요.

  

5. 애플리케이션 배포

Node.js 서버 배포에 대한 지침을 보려면 아래 옵션 중 하나를 클릭하세요.

6. 웹 앱을 사용하세요

웹 앱은 고객 서비스 챗봇을 제공합니다. 메시지가 표시되면 버튼을 누르거나 Type something 상자를 사용하여 챗봇과 상호 작용합니다. 챗봇은 Discovery 및 Natural Language Understanding에서 제공되는 추가 정보와 함께 Watson Assistant로 구동됩니다.

문제 해결

• 오류: Watson Assistant에 대한 작업공간을 나열할 수 없습니다. 금지됨: 잘못된 자격 증명으로 인해 액세스가 거부되었습니다.

  이 오류는 Deploy to IBM Cloud 버튼을 사용할 때 발생합니다. 기본 스킬의 자동 구성을 허용하도록 ASSISTANT_APIKEY 에 대한 런타임 환경 변수를 구성하거나 다른 스킬을 사용하도록 SKILL_ID 구성합니다.

• 실패: 서비스 인스턴스 wbc-discovery-service에 대한 작업이 진행 중입니다.

  서비스가 준비되기 전에 앱을 시작할 때 발생하는 오류입니다. 이는 현재 Deploy to IBM Cloud 버튼을 사용하는 일반적인 동작입니다. 이 경우 Run 버튼을 클릭하여 애플리케이션을 다시 시작하세요. 서비스가 준비되면 성공합니다.

• 오류: {GUID} 환경이 아직 활성화되지 않았습니다. 상태가 활성화되면 다시 시도하세요.

  이는 첫 번째 실행 중에 일반적입니다. 검색 환경이 완전히 생성되기 전에 앱이 시작을 시도합니다. 몇 분 정도 기다린 후 Run 버튼을 클릭하여 애플리케이션을 다시 시작하세요.

• 오류: 조직당 하나의 무료 환경만 허용됩니다.

  무료 평가판을 사용하기 위해 소규모 무료 Discovery 환경이 생성됩니다. 이미 검색 환경이 있는 경우에는 실패합니다. Discovery를 사용하지 않는 경우 삭제하려는 이전 서비스를 확인하세요. 그렇지 않으면 .env DISCOVERY_ENVIRONMENT_ID를 사용하여 앱에서 사용할 환경을 앱에 알려주세요. 기본 구성을 사용하여 이 환경에서 컬렉션이 생성됩니다.

모래밭

• 유튜브 데모
• Watson Node.js SDK
• 관련성 교육 데모 비디오
• 관련성 교육 데모 노트북

특허

이 코드 패턴은 Apache 라이선스 버전 2에 따라 라이선스가 부여됩니다. 이 코드 패턴 내에서 호출되는 별도의 타사 코드 개체는 해당 공급자가 자체 라이선스에 따라 라이선스를 부여합니다. 기여에는 원본 개발자 인증서 버전 1.1 및 Apache 라이센스 버전 2가 적용됩니다.

Apache 라이센스 FAQ