시작하기 전에

시작하기 전에 다음을 수행해야 합니다.

• IBM Cloud 에서 또는 IBM Cloud Pak for Data에 설치된 Discovery v2 인스턴스를 설정하십시오.
• IBM Cloud에 대한 Plus 플랜 Discovery 서비스 인스턴스가 있어야 합니다. 이동 DiscoveryIBM Cloud 의 카탈로그 페이지에서 플러스 플랜 서비스 인스턴스를 생성합니다.
• 공용 엔드포인트를 사용하십시오. 개인용 엔드포인트는 현재 watsonx Assistant 또는 클래식 경험에 대해 지원되지 않습니다.

검색 통합 또는 검색 스킬 작성

검색 통합을 생성하려면:

1. 검색을 추가할 어시스턴트에서 통합을 클릭하십시오.

   유료 요금제를 사용하는 사용자라면 검색 기능을 추가할 수 있습니다.

2. 확장 섹션에서 검색을 찾고 추가를 클릭한 후 확인을 클릭하십시오.

클래식 경험을 사용하는 경우 검색 스킬을 추가하십시오.

1. 스킬을 추가하려는 어시스턴트에서 검색 스킬 추가를 클릭하십시오.

2. 다음 조치 중 하나를 수행하십시오.

   • 새 검색 스킬을 작성하려면 스킬 작성 탭에서 계속하십시오.

   • 이미 검색 스킬을 작성한 경우 기존 스킬 추가 탭이 표시되고 클릭하여 기존 스킬을 추가할 수 있습니다.

3. 새 스킬의 세부사항을 지정하십시오.

   • 이름: 길이가 64자 이하인 이름입니다. 이름이 필요합니다.
   • 설명: 길이가 128자 이하인 선택적 설명입니다.

기존 Discovery 인스턴스에 연결

1. 정보를 추출하려는 Discovery 서비스 인스턴스를 선택하십시오.

   Discovery 서비스 인스턴스 중 일부에 자격 증명이 설정되어 있지 않다는 경고가 표시되면, IBM Cloud 대시보드에서 한 번도 열지 않은 인스턴스 중 하나 이상에 액세스할 수 있다는 의미입니다. 작성할 신임 정보에 대해 서비스 인스턴스에 액세스해야 하며 watsonx Assistant에서 사용자를 대신하여 Discovery 서비스 인스턴스에 대한 연결을 설정하기 전에 신임 정보가 존재해야 합니다. Discovery 서비스 인스턴스가 목록에서 누락된 경우, IBM Cloud® 대시보드에서 인스턴스를 바로 열어 해당 인스턴스에 대한 인증 정보를 생성하십시오.

2. 다음 중 하나를 수행하여 사용할 데이터 콜렉션을 표시하십시오.

   • 기존 프로젝트를 선택하십시오.

     Discovery 열기 아이콘을 클릭하여 사용할 프로젝트를 결정하기 전에 프로젝트의 구성을 검토할 수 있습니다.

     검색 구성으로 이동하십시오.

   • 프로젝트가 없거나 나열된 프로젝트를 사용하지 않으려면 새 프로젝트 작성을 클릭하여 추가하십시오. 프로젝트 작성의 단계를 수행하십시오.

     Discovery 서비스 플랜에 따라 제한에 도달한 경우, 새 프로젝트 생성이 표시되지 않습니다. 플랜 한계 세부사항은 Discovery 가격 플랜 을 참조하십시오.

프로젝트 작성

1. 좋습니다. 데이터는 어디에 있습니까? 페이지에서 데이터 소스를 선택한 후 다음을 클릭하십시오. 예제 선택사항에는 Salesforce, SharePoint, Box, IBM Cloud Object Storage, 웹 크롤링, 업로드 데이터가 포함됩니다.

2. 데이터에 대해 콜렉션 작성 페이지에서 데이터에 연결하고 콜렉션을 구성하는 방법에 대한 정보를 입력하십시오. 입력해야 하는 정보는 데이터 소스에 따라 다릅니다. 예를 들어, Salesforce, Sharepoint, Box와 같은 서비스에 대한 인증 신임 정보를 입력해야 합니다. 웹 크롤링의 경우, 기존 정보로 웹사이트를 지정합니다.

3. ** 완료**를 누르십시오. Discovery에서 몇 분 내로 문서 작성을 시작하도록 하십시오. 프로젝트 내에서 컬렉션 관리 페이지를 사용하여 진행 상태를 확인할 수 있습니다.

4. 콜렉션이 완전히 수집될 때까지 기다린 후 watsonx Assistant에 돌아가기를 클릭하십시오.

검색 구성

1. watsonx Assistant 의 검색 통합 페이지에서 사용하려는 Discovery 인스턴스와 프로젝트가 선택되어 있는지 확인한 다음, 다음을 클릭합니다.

2. 결과 컨텐츠 구성 섹션에서 고객에게 표시되는 검색 결과에 사용되는 Discovery 필드 및 예제를 검토하십시오. 기본값을 승인하거나 원하는 대로 사용자 정의할 수 있습니다.

   데이터를 추출할 적절한 콜렉션 필드는 콜렉션의 데이터 소스 및 데이터 소스가 보강된 방법에 따라 달라집니다. 데이터 콜렉션 유형을 선택하면 콜렉션 필드 값이 콜렉션의 데이터 소스 유형에 따라 유용한 정보를 포함할 가능성이 가장 높은 소스 필드로 미리 채워집니다. 하지만, 사용자는 다른 누구보다 데이터를 잘 알고 있습니다. 소스 필드를 사용자 요구에 맞는 최상의 정보를 포함하는 필드로 변경할 수 있습니다.

   추출할 정보가 있는 필드의 이름을 포함하여 콜렉션에 있는 문서의 구조에 대해 자세히 학습하려면 Discovery에서 콜렉션을 열고 ID 필드 및 필드 관리 탭을 사용하십시오.

   각 검색 결과는 다음 섹션으로 구성될 수 있습니다.

   • 제목: 검색 결과 제목. 콜렉션에서 제목, 이름 또는 유사한 유형의 필드를 검색 결과 제목으로 사용하십시오.

     제목으로 사용할 항목을 선택해야 합니다. 그렇지 않으면 Facebook 및 Slack 통합에 검색 결과 응답이 표시되지 않습니다.

   • 본문: 검색 결과 설명. 콜렉션에서 요약 또는 강조표시 필드를 검색 결과 본문으로 사용하십시오.

     본문으로 사용할 항목을 선택해야 합니다. 그렇지 않으면 Facebook 및 Slack 통합에 검색 결과 응답이 표시되지 않습니다.

   • URL: 이 필드는 검색 결과 마지막에 포함하려는 바닥글 컨텐츠로 채워질 수 있습니다.

     예를 들어, 데이터 소스에 있는 원본 데이터 객체에 대한 하이퍼텍스트 링크를 포함할 수 있습니다. 대부분의 온라인 데이터 소스는 직접 액세스를 지원하기 위해 상점의 오브젝트에 대한 자체 참조 공용 URL을 제공합니다. URL을 추가하는 경우에는 URL이 유효하고 액세스가 가능해야 합니다. 그렇지 않은 경우, 슬랙 통합은 응답에 URL 를 포함하지 않으며, 페이스북 통합은 응답을 반환하지 않습니다.

     Facebook 및 Slack 통합은 URL 필드가 비어 있을 때 검색 결과 응답을 제대로 표시할 수 있습니다.

   검색 결과 중 하나 이상에 대해 필드를 사용해야 합니다.

   드롭 다운 필드에서 옵션을 사용할 수 없는 경우, 콜렉션 작성을 완료하는 데 Discovery에 더 많은 시간을 제공하십시오. 컬렉션이 생성되지 않은 경우, 컬렉션에 문서가 하나도 없을 수도 있고, 먼저 해결해야 할 수집 오류가 있을 수도 있습니다.

   

   필드 맵핑을 추가하면 검색 결과의 미리보기가 데이터 콜렉션의 해당 필드에 있는 정보와 함께 표시됩니다. 이 미리보기는 사용자에게 리턴되는 검색 결과 응답에 포함되는 항목을 표시합니다.

   검색 구성에 대해 도움을 받으려면 문제점 해결을 참조하십시오.

3. 메시지, 결과를 찾을 수 없음, 연결 문제 탭을 사용하여 검색 성공을 기반으로 사용자와 공유할 다른 메시지를 사용자 정의하십시오.

   검색 결과 메시지

   탭	시나리오	예제 메시지
   메시지	검색 결과가 리턴됩니다.	I found this information that might be helpful:
   결과를 찾을 수 없음	검색 결과를 찾을 수 없습니다.	I searched my knowledge base for information that might address your query, but did not find anything useful to share.
   연결 문제	어떤 이유로 인해 검색을 완료할 수 없음	I might have information that could help address your query, but am unable to search my knowledge base at the moment.

4. 응답 강조 사용 여부를 선택하십시오.

   이 옵션은 Discovery 인스턴스가 v2 Discovery API를 사용하는 경우에만 사용할 수 있습니다.

   이 기능을 사용으로 설정하면 고객의 질문에 정확한 응답이 되도록 Discovery에 의해 판별되는 문장이 검색 결과로 고객에게 표시되는 텍스트 블록에 강조표시됩니다.

5. 결과 수량 조정 섹션에서 리턴할 결과 수를 지정하십시오.

   상위 세 개의 결과가 자동으로 리턴됩니다. 응답에서 더 적거나 더 많은(최대 10개) 결과를 표시하도록 선택할 수 있습니다.

   기본적으로 고객은 더 많은 결과를 보도록 선택할 수 있습니다. 고객에게 이 선택사항을 제공하지 않으려면 고객이 최대 10개의 결과를 보도록 링크 포함 선택란을 선택 취소하십시오.

6. 결과 선택도 설정 섹션에서 리턴되는 응답에 더 선택적일지 여부를 결정하십시오. 결과 선택도를 증가시키면 검색은 더 적지만 더 정확한 결과를 리턴합니다. 대부분의 경우 검색이 기본 설정(해제)으로 충분할 정도로 정확합니다.

7. 사용자 정의 결과 필터 를 사용하여 검색 통합에서 사용자 정의 텍스트 문자열에 대한 필터를 추가하십시오. 사용자 정의 결과 필터 필드는 주제, 제품 또는 텍스트 문자열과 관련된 검색 결과를 정의하는 데 도움이 됩니다. 예를 들어, enriched_text.entities.text:"Boston, MA" 를 사용하여 사용자 정의 결과 필터 필드를 정의하는 경우, 어시스턴트의 모든 조회에 대한 검색 응답이 enriched_text.entities.text 파일의 "Boston, MA" 와 관련되도록 필터링됩니다.

   

8. 미리보기를 클릭하십시오. 구성 선택사항이 검색에 적용될 때 리턴되는 결과를 확인하기 위한 문자 메시지를 입력하십시오. 필요에 따라 조정하십시오.

9. 작성을 클릭하십시오.

검색 통합 구성 편집

나중에 검색 결과 카드의 구성을 변경하려면 검색 통합을 다시 열고 편집하십시오. 변경할 때 변경사항을 저장하지 않아도 됩니다. 자동으로 적용됩니다. 검색 결과에 만족하는 경우 저장을 클릭하여 검색 통합 구성을 완료하십시오.

다른 Discovery 서비스 인스턴스 또는 프로젝트에 연결하기로 결정했다면, 검색 통합을 열고 검색 설정 편집을 클릭합니다. 동일한 인스턴스에서 새로운 프로젝트를 선택하거나, 새로운 인스턴스와 프로젝트를 선택할 수 있습니다.

Discovery 검색을 사용하도록 어시스턴트 구성

Discovery 검색 통합을 구성한 후에는 고객 응답이 조치와 일치하지 않을 때 Discovery 검색을 사용하도록 어시스턴트를 구성해야 합니다. 검색을 사용하도록 일치하지 않음 을 업데이트하는 방법에 대한 자세한 정보는 일치하는 조치가 없을 때 검색 사용 을 참조하십시오.

문제점 해결

일반적인 작업에 대한 도움을 얻으려면 이 정보를 검토하십시오.

• 웹 크롤링 데이터 콜렉션: 웹 크롤링 데이터 소스를 작성할 때 알아야 하는 사항:

  • 데이터 콜렉션에 사용할 수 있는 문서 수를 늘리려면 URL 그룹 추가를 클릭하십시오. URL 그룹에는 크롤링이 필요하지만 초기 시드 URL과 링크되지 않는 페이지의 URL을 나열할 수 있습니다.
  • 데이터 콜렉션에 사용할 수 있는 문서 수를 줄이려면 기본 URL의 하위 도메인을 지정하십시오. 또는 웹 크롤링 설정에서 원본 페이지에서 이동할 수 있는 횟수를 제한하십시오. 크롤링에서 명시적으로 제외하려는 하위 도메인을 지정할 수도 있습니다.
  • 몇 분 후에 문서가 나열되지 않고 페이지가 새로 고쳐지면 수집하려는 컨텐츠가 URL의 페이지 소스에서 사용 가능한지 확인하십시오. 일부 웹 페이지 컨텐츠는 동적으로 생성되므로 크롤링할 수 없습니다.

• 업로드된 문서에 대한 검색 결과 구성: 업로드된 문서의 콜렉션을 사용 중이고 올바른 검색 결과를 얻을 수 없거나 검색 결과가 충분하게 간결하지 않은 경우 데이터 콜렉션을 작성할 때 스마트 문서 이해 사용을 고려해 보십시오.

  텍스트 형식을 기반으로 문서에 어노테이션을 작성할 수 있습니다. 예를 들어 Discovery에게 28포인트 굵은체 글꼴의 텍스트는 문서 제목이라고 알릴 수 있습니다. 이 정보를 수집할 때 콜렉션에 적용하면, 나중에 검색 결과의 제목 섹션에 대한 소스로 제목 필드를 사용할 수 있습니다.

  또한 스마트 문서 이해를 사용하여 대형 문서를 세그먼트로 분할함으로써 보다 쉽게 검색할 수 있습니다. 자세한 정보는 Discovery 문서의 Smart Document Understanding 주제를 참조하십시오.

• 내 응답 텍스트가 대괄호 안에 있음: 미리보기에서 테스트할 때 응답 텍스트가 대괄호 및 인용 부호(["My response text"]) 안에 있음을 알고 있는 경우 예를 들어, 구성에서 사용 중인 소스 필드를 변경해야 할 수도 있습니다. 예기치 않은 형식은 값이 소스 문서에 배열로 저장되었음을 표시합니다. 텍스트를 추출하는 모든 필드에는 배열 데이터 유형이 아닌 문자열 데이터 유형의 값이 포함되어야 합니다. 대화 통합에 데이터가 배열로 저장된 필드에서 추출된 응답이 표시되면 배열 값을 문자열로 직접 변환하여 배열 구문이 포함된 응답을 생성합니다.

  예를 들어, 소스 문서의 필드에 단일 텍스트 값이 있는 배열이 유일한 배열 요소로 포함되어 있을 수 있습니다.

  "title": ["a single array element"]
  

  배열 값은 watsonx Assistant에 의해 문자열 값으로 변환됩니다.

  "title": "[\"a single array element\"]"
  

  결과적으로 문자열은 대화에서 대괄호와 따옴표로 둘러싸인 형식으로 리턴됩니다.

  ["a single array element"]
  

  이 상황이 발생하면 검색 결과를 추출할 다른 콜렉션 필드를 선택하십시오.

  Discovery 문서 highlight 필드는 배열에 값을 저장합니다.

다음 단계

처음으로 검색 통합을 추가한 후에는 드래프트 환경 페이지에 타일로 표시됩니다. 타일을 클릭하여 검색 구성을 보거나 편집하십시오.

준비가 되면 다중 환경 을 사용 중인 경우 검색 통합을 라이브 환경 또는 다른 환경에 추가하는 단계를 반복할 수 있습니다.

검색 통합 테스트

검색을 구성한 후 테스트 조회를 전송하면 미리보기 페이지를 사용하여 Discovery에서 리턴되는 검색 결과를 확인할 수 있습니다.

고객이 질문을 하면 답변이 바로 제공되거나 검색이 트리거되는 전체 경험을 테스트하려면 어시스턴트 미리보기를 사용하십시오.

클래식 경험에서 검색 스킬 테스트

클래식 환경에서 검색 스킬을 사용하는 경우 검색 스킬의 미리보기 분할창을 사용하여 Discovery 에서 리턴되는 검색 결과를 보기 위해 테스트 조회를 전송할 수 있습니다.

대화 상자에서 응답하거나 검색을 트리거하는 질문을 받을 때 고객이 가지는 전체 경험을 테스트하려면 어시스턴트의 미리보기 단추를 사용하십시오.

대화 "시험 사용" 분할창에서 전체 엔트 투 엔드 사용자 경험을 테스트할 수 없습니다. 검색 스킬은 별도로 구성되고 어시스턴트에 연결됩니다. 대화 스킬은 검색 세부사항을 알 수 없으므로 검색 결과를 "시험 사용" 분할창에 표시할 수 없습니다.

하나 이상의 통합 채널을 구성하여 검색 스킬을 테스트하십시오. 채널에서 검색을 트리거하는 조회를 입력하십시오. 대화에서 모든 유형의 검색을 시작하는 경우, 검색이 예상대로 트리거되는지 확인하려면 대화를 테스트하십시오. 검색 응답 유형을 사용하지 않는 경우, 기존 대화 노드가 사용자 입력을 처리할 수 없는 경우에만 검색이 트리거되는지 테스트하십시오. 검색이 트리거될 때마다 의미 있는 결과를 리턴하는지 확인하십시오.