IBM Cloud Docs
Elasticsearch 검색 통합 설정

Elasticsearch 검색 통합 설정

플러스 기업 IBM Cloud Pak for Data IBM Software Hub

Elasticsearch 는 어시스턴트가 엔터프라이즈 컨텐츠를 활용하여 더 높은 정확도와 관련성으로 메트릭, 구조화됨, 비구조화됨 및 시맨틱과 같은 다양한 유형의 검색을 수행할 수 있도록 지원합니다. Elasticsearch 데이터 분석 엔진은 검색 통합의 범위를 어시스턴트의 더 큰 데이터 세트로 확장합니다. 이 통합 외에도 대화식 방식으로 조회에 응답하는 데 도움이 되는 어시스턴트에서 Elasticsearch 에 대한 대화식 검색을 사용으로 설정할 수 있습니다.

환경당 하나의 검색 통합만 사용할 수 있습니다. 기존 검색 연동 서비스를 IBM Watson® Discovery 또는 Milvus 또는 사용자 정의 서비스와 같은 다른 연동 유형으로 변경하면 기존 검색 연동 설정이 덮어씌워집니다.

Elasticsearch 선택

Elasticsearch 를 기본 검색 통합으로 선택하려면 다음 프로시저 중 하나를 사용하십시오.

  • 통합 페이지에서 Elasticsearch 검색 통합 선택

    1. watsonx Assistant 인스턴스를 작성한 후 > 통합으로 이동하십시오.
    2. 검색 타일 안에서 열기를 클릭하여 열기 검색 창 을 엽니다.
    3. 어시스턴트의 초안 환경에서 Elasticsearch 설정하려면, 검색 창을 열고 드롭다운 메뉴에서 " Draft " 옵션을 선택합니다. 어시스턴트의 라이브 환경에서 Elasticsearch 설정하려면 드롭다운 메뉴에서 " Live " 옵션을 선택합니다.
    4. 기존의 새로운 검색 통합 편집 창 에서 Elasticsearch 타일을 선택합니다.
  • 환경 페이지에서 Elasticsearch 검색 통합 선택

    1. watsonx Assistant 인스턴스를 작성한 후 > 환경으로 이동하십시오.

    2. 초안 환경에서 Elasticsearch 설정하려면 초안 탭을 선택하십시오. 실시간 환경에서 Elasticsearch 설정하려면, 실시간 탭을 선택하십시오.

    3. Elasticsearch 추가하려면, 해결 방법 섹션 에서 확장 프로그램 아래의 검색 타일 내부의 추가 버튼을 클릭합니다.

      Elasticsearch 검색 통합을 이미 추가한 경우 확장아래의 검색 타일 내에 추가 대신 열기 단추가 표시됩니다.

    4. 새 검색 확장 프로그램 설정 창 에서 Elasticsearch 타일을 선택합니다.

      Elasticsearch 선택하세요
      Elasticsearch 선택하세요

설정 Elasticsearch

어시스턴트에서 Elasticsearch 를 설정하려면 다음 프로시저를 사용하십시오.

  1. 어시스턴트가 Elasticsearch 연결할 수 있도록 다음 필드를 제공하십시오

    • Elasticsearch URL

    • Elasticsearch 포트 (선택사항)

    • 인증 유형 선택

      • Basic authentication 를 선택하면 Elasticsearch 사용자 이름Elasticsearch 비밀번호를 입력해야 합니다.
      • API key 를 선택하는 경우 Elasticsearch API키를 제공해야 합니다.

      Elasticsearch 에 연결
      Elasticsearch 에 연결

  2. 다음 을 클릭하여 색인 선택 섹션으로 이동하십시오. 인덱스 선택 에는 두 가지 옵션이 있습니다.

    • 기존 색인을 사용하려면 내 색인 사용을 선택하십시오.
    • 새 색인을 작성하려면 Elasticsearch 인스턴스의 새 색인에 문서 업로드를 선택하십시오.

기존 색인 사용

  1. 색인 선택 섹션에서 내 색인 사용 을 클릭하여 기존 Elasticsearch 색인에 연결하십시오. 내 색인 사용 옵션은 Elasticsearch 설정에서 기본값으로 선택됩니다.

  2. 내 색인 사용 옵션에서 Elasticsearch 색인 이름을 입력하십시오.

  3. 다음 을 클릭하여 대화식 검색 사용 (선택사항) 섹션으로 이동하십시오.

  4. 대화식 검색은 watsonx Assistant의 Plus및 Enterprise 플랜에서만 사용 가능합니다. 대화식 검색을 활성화하려면 대화식 검색 사용 (선택사항) 섹션에서 대화식 검색 토글을 on 로 전환하십시오. 대화식 검색을 활성화하지 않으려면 토글을 off 로 전환하십시오. 대화식 검색에 대한 자세한 정보는 대화식 검색 을 참조하십시오.

  5. 저장을 클릭한 다음 닫기를 클릭합니다.

새 인덱스 [베타] 에 문서 업로드{: tag-cyan}

문서를 업로드하기 전에 Elasticsearch 인스턴스에 다음 전제조건이 있어야 합니다.

  • Elasticsearch 8.8 이상.

  • IBM Cloud Databases for Elasticsearch 플래티넘 에디션이나 Elastic.co 플래티넘 또는 엔터프라이즈 구독과 같은 Elasticsearch 유료 또는 체험판 구독.

  • ELSER 모델을 배치하기 위한 최소 4GB메모리가 있는 Machine Learning (ML) 노드. ELSER 요구사항에 대한 자세한 정보는 ELSER 요구사항 을 참조하십시오.

  • 업로드하는 문서는 영어로 작성해야 합니다.

Elasticsearch 문서 업로드에 필요한 전제 조건이 충족되지 않으면, " Requirements not met " 오류 메시지가 표시됩니다.

사전 조건을 충족한 후에도 문서 업로드가 지연되거나 실패하는 경우, ELSER 모델 배포의 추론 성능을 조정하는 것을 고려할 수 있습니다. 이를 위해, number_of_allocations, threads_per_allocation 와 같은 매개 변수를 설정할 수 있습니다. 추론 성능 스케일링에 대한 자세한 정보는 훈련된 모델 배치 API 시작 을 참조하십시오.

새 인덱스에 문서를 업로드하려면 다음 프로시저를 사용하십시오.

  1. Elasticsearch 창의 색인 선택 섹션에서 Elasticsearch 인스턴스의 새 색인에 문서 업로드를 클릭하십시오.

    watsonx Assistant 는 업로드된 문서를 스토리지, 청크 및 인덱싱을 위해 Elasticsearch 인스턴스에 전달합니다.

  2. 결과 콘텐츠 구성 섹션에서 다음 필드를 입력하여 제목, 본문 및 URL 검색 응답에 매핑합니다:

    • 제목

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

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

    • 본문

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

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

    • URL

      이 필드에는 검색 결과의 끝에 포함시키고 싶은 모든 바닥글 내용을 입력할 수 있습니다.

    중첩된 문서를 검색하도록 고급 Elasticsearch 설정 에서 쿼리 본문을 구성하는 경우 제목, 본문, URL 이 Elasticsearch 인덱스의 내부 문서 필드에 있는지 확인해야 합니다. 중첩 쿼리 사용에 대한 자세한 내용은 Elasticsearch 중첩 쿼 리를 참조하세요.

  3. 고급 Elasticsearch 설정 섹션을 펼쳐서 다음 텍스트 상자를 확인하십시오.

    • Elasticsearch에 대한 필터 배열 구성

      필터를 오브젝트의 배열로 정의하여 조회 본문별로 컨텐츠를 배열하는 필터를 작성할 수 있습니다. 자세한 내용은 사용자 지정 필터 구성하기를 참조하세요.

    • Elasticsearch에 대한 조회 본문 구성

      조회 본문은 사용자 요청을 검색에서 예상하는 형식으로 조작하는 데 사용됩니다. 조회 양식, 검색 필드, 필터 및 조회 크기를 제어합니다. REST API에서 쿼리 본문은 Elasticsearch _search 요청의 쿼리 본문( POST body)을 나타내는 객체입니다. 조회 본문에는 고객의 조회를 나타내는 "$QUERY" 토큰 및 검색 설정 또는 단계 레벨에서 정의되는 필터의 배열을 나타내는 "$FILTER" 토큰이 있습니다.

      기본적으로 Elasticsearch 통합은 키워드 검색을 사용합니다. 그러나 쿼리 본문을 Advanced Elasticsearch settings 에서 구성하여 다음과 같은 고급 검색 기술을 사용할 수 있습니다

      • ELSER를 이용한 의미 검색
      • KNN 밀도 벡터 검색
      • 중첩된 쿼리를 사용하여 중첩된 문서 검색하기
      • 혼합 검색
      • 의미론적 텍스트 필드에서 검색

      다른 유형의 조회 본문 예제 사용에 대한 자세한 정보는 조회 본문 예제 를 참조하십시오.

      Elasticsearch _search API 요청 본문에 대한 자세한 정보는 Elasticsearch 검색 API 요청 본문을 참조하십시오.

      기존 Elasticsearch 구성을 사용하여 어시스턴트에서 조회 본문을 사용자 정의할 수 없습니다.

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

    검색 결과 메시지
    시나리오 예제 메시지
    메시지 검색 결과가 리턴됩니다. 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.
  5. 대화식 검색을 활성화하려면 대화식 검색 토글을 on 로 전환하십시오. 대화식 검색을 활성화하지 않으려면 토글을 off 로 전환하십시오.

    대화식 검색은 watsonx Assistant의 Plus및 Enterprise 플랜에서만 사용 가능합니다. 대화식 검색 토글을 on 로 전환하면 어시스턴트 응답에서 인용 제목을 볼 수 있습니다. 대화식 검색에 대한 자세한 정보는 대화식 검색 을 참조하십시오.

  6. 저장을 클릭하여 설정을 저장합니다.

  7. Elasticsearch 창에서 문서 탭을 클릭하십시오.

    문서 탭은 Elasticsearch 인스턴스의 새 색인에 문서 업로드 옵션을 선택하는 경우에만 사용으로 설정됩니다.

  8. 업로드 버튼을 클릭합니다. 문서 업로드 섹션 에서 파일을 드래그하거나 한 번의 클릭으로 문서를 어시스턴트에 직접 업로드할 수 있습니다.

    한 번에 최대 20개의 문서를 업로드할 수 있습니다. 각 문서 파일 크기는 25KB를 초과할 수 없습니다. 모든 문서의 총 용량은 50MB를 초과하지 않아야 합니다.

    Elasticsearch 업로드 문서
    Elasticsearch 업로드 문서

  9. 문서를 업로드한 후 Elasticsearch 창의 테이블에서 문서의 업로드 상태를 볼 수 있습니다.

  10. 상태 Ready 는 파일을 검색할 수 있음을 표시합니다.

  11. 상태가 Error 인 경우 Error 옆에 있는 세 개의 점을 클릭하고 Delete 를 클릭하여 파일을 삭제할 수 있습니다.

    Elasticsearch 업로드 오류
    Elasticsearch 업로드 오류

  12. Elasticsearch 인스턴스 자격 증명을 변경하지 않으려면 이 단계를 건너뛰세요. Elasticsearch 인스턴스 자격 증명을 변경하려면 인스턴스 탭을 클릭하고 자격 증명을 편집한 다음 저장를 클릭합니다.

  13. 저장 을 클릭한 후 닫기 를 클릭하여 Elasticsearch 설정을 종료하십시오.

Elasticsearch 를 사용하도록 어시스턴트 구성

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

Elasticsearch 테스트

조치 미리보기, 미리보기 페이지에서 또는 미리보기 링크를 사용하여 Elasticsearch 와의 검색 통합을 테스트할 수 있습니다.

이 예제에서 사용자는 Tell me about a custom extension 를 묻습니다.

대화식 검색이 off 인 경우 지식 기반에서 검색 결과를 가져옵니다. 답은 I searched my knowledge base and found this information which might be useful 입니다.

에서 대화형 검색 끄기 대화형 검색 끄기

대화식 검색이 on 인 경우 지식 기반 데이터베이스에서 최상의 결과의 텍스트 기반 응답이 표시됩니다.

에서 대화형 검색 대화형 검색