Elasticsearch 검색 통합 설정
플러스 기업 IBM Cloud Pak for Data IBM Software Hub
Elasticsearch 는 어시스턴트가 엔터프라이즈 컨텐츠를 활용하여 더 높은 정확도와 관련성으로 메트릭, 구조화됨, 비구조화됨 및 시맨틱과 같은 다양한 유형의 검색을 수행할 수 있도록 지원합니다. Elasticsearch 데이터 분석 엔진은 검색 통합의 범위를 어시스턴트의 더 큰 데이터 세트로 확장합니다. 이 통합 외에도 대화식 방식으로 조회에 응답하는 데 도움이 되는 어시스턴트에서 Elasticsearch 에 대한 대화식 검색을 사용으로 설정할 수 있습니다.
환경당 하나의 검색 통합만 사용할 수 있습니다. 기존 검색 연동 서비스를 IBM Watson® Discovery 또는 Milvus 또는 사용자 정의 서비스와 같은 다른 연동 유형으로 변경하면 기존 검색 연동 설정이 덮어씌워집니다.
Elasticsearch 선택
Elasticsearch 를 기본 검색 통합으로 선택하려면 다음 프로시저 중 하나를 사용하십시오.
-
통합 페이지에서 Elasticsearch 검색 통합 선택
- watsonx Assistant 인스턴스를 작성한 후 홈 > 통합으로 이동하십시오.
- 검색 타일 안에서 열기를 클릭하여 열기 검색 창 을 엽니다.
- 어시스턴트의 초안 환경에서 Elasticsearch 설정하려면, 검색 창을 열고 드롭다운 메뉴에서 "
Draft
" 옵션을 선택합니다. 어시스턴트의 라이브 환경에서 Elasticsearch 설정하려면 드롭다운 메뉴에서 "Live
" 옵션을 선택합니다. - 기존의 새로운 검색 통합 편집 창 에서 Elasticsearch 타일을 선택합니다.
-
환경 페이지에서 Elasticsearch 검색 통합 선택
-
watsonx Assistant 인스턴스를 작성한 후 홈 > 환경으로 이동하십시오.
-
초안 환경에서 Elasticsearch 설정하려면 초안 탭을 선택하십시오. 실시간 환경에서 Elasticsearch 설정하려면, 실시간 탭을 선택하십시오.
-
Elasticsearch 추가하려면, 해결 방법 섹션 에서 확장 프로그램 아래의 검색 타일 내부의 추가 버튼을 클릭합니다.
Elasticsearch 검색 통합을 이미 추가한 경우 확장아래의 검색 타일 내에 추가 대신 열기 단추가 표시됩니다.
-
새 검색 확장 프로그램 설정 창 에서 Elasticsearch 타일을 선택합니다.
Elasticsearch 선택하세요
-
설정 Elasticsearch
어시스턴트에서 Elasticsearch 를 설정하려면 다음 프로시저를 사용하십시오.
-
어시스턴트가 Elasticsearch 연결할 수 있도록 다음 필드를 제공하십시오
-
Elasticsearch URL
-
Elasticsearch 포트 (선택사항)
-
인증 유형 선택
Basic authentication
를 선택하면 Elasticsearch 사용자 이름 과 Elasticsearch 비밀번호를 입력해야 합니다.API key
를 선택하는 경우 Elasticsearch API키를 제공해야 합니다.
Elasticsearch 에 연결
-
-
다음 을 클릭하여 색인 선택 섹션으로 이동하십시오. 인덱스 선택 에는 두 가지 옵션이 있습니다.
- 기존 색인을 사용하려면 내 색인 사용을 선택하십시오.
- 새 색인을 작성하려면 Elasticsearch 인스턴스의 새 색인에 문서 업로드를 선택하십시오.
기존 색인 사용
-
색인 선택 섹션에서 내 색인 사용 을 클릭하여 기존 Elasticsearch 색인에 연결하십시오. 내 색인 사용 옵션은 Elasticsearch 설정에서 기본값으로 선택됩니다.
-
내 색인 사용 옵션에서 Elasticsearch 색인 이름을 입력하십시오.
-
다음 을 클릭하여 대화식 검색 사용 (선택사항) 섹션으로 이동하십시오.
-
대화식 검색은 watsonx Assistant의 Plus및 Enterprise 플랜에서만 사용 가능합니다. 대화식 검색을 활성화하려면 대화식 검색 사용 (선택사항) 섹션에서 대화식 검색 토글을
on
로 전환하십시오. 대화식 검색을 활성화하지 않으려면 토글을off
로 전환하십시오. 대화식 검색에 대한 자세한 정보는 대화식 검색 을 참조하십시오. -
저장을 클릭한 다음 닫기를 클릭합니다.
새 인덱스 [베타] 에 문서 업로드{: 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 시작 을 참조하십시오.
새 인덱스에 문서를 업로드하려면 다음 프로시저를 사용하십시오.
-
Elasticsearch 창의 색인 선택 섹션에서 Elasticsearch 인스턴스의 새 색인에 문서 업로드를 클릭하십시오.
watsonx Assistant 는 업로드된 문서를 스토리지, 청크 및 인덱싱을 위해 Elasticsearch 인스턴스에 전달합니다.
-
결과 콘텐츠 구성 섹션에서 다음 필드를 입력하여 제목, 본문 및 URL 검색 응답에 매핑합니다:
-
제목
검색 결과 제목입니다. 콜렉션에서 제목, 이름 또는 유사한 유형의 필드를 검색 결과 제목으로 사용하십시오.
제목으로 사용할 항목을 선택해야 합니다. 그렇지 않으면 Facebook 및 Slack 통합에 검색 결과 응답이 표시되지 않습니다.
-
본문
검색 결과 설명입니다. 콜렉션에서 요약 또는 강조표시 필드를 검색 결과 본문으로 사용하십시오.
본문으로 사용할 항목을 선택해야 합니다. 그렇지 않으면 Facebook 및 Slack 통합에 검색 결과 응답이 표시되지 않습니다.
-
URL
이 필드에는 검색 결과의 끝에 포함시키고 싶은 모든 바닥글 내용을 입력할 수 있습니다.
중첩된 문서를 검색하도록 고급 Elasticsearch 설정 에서 쿼리 본문을 구성하는 경우 제목, 본문, URL 이 Elasticsearch 인덱스의 내부 문서 필드에 있는지 확인해야 합니다. 중첩 쿼리 사용에 대한 자세한 내용은 Elasticsearch 중첩 쿼 리를 참조하세요.
-
-
고급 Elasticsearch 설정 섹션을 펼쳐서 다음 텍스트 상자를 확인하십시오.
-
Elasticsearch에 대한 필터 배열 구성
필터를 오브젝트의 배열로 정의하여 조회 본문별로 컨텐츠를 배열하는 필터를 작성할 수 있습니다. 자세한 내용은 사용자 지정 필터 구성하기를 참조하세요.
-
Elasticsearch에 대한 조회 본문 구성
조회 본문은 사용자 요청을 검색에서 예상하는 형식으로 조작하는 데 사용됩니다. 조회 양식, 검색 필드, 필터 및 조회 크기를 제어합니다. REST API에서 쿼리 본문은 Elasticsearch
_search
요청의 쿼리 본문(POST
body)을 나타내는 객체입니다. 조회 본문에는 고객의 조회를 나타내는"$QUERY"
토큰 및 검색 설정 또는 단계 레벨에서 정의되는 필터의 배열을 나타내는"$FILTER"
토큰이 있습니다.기본적으로 Elasticsearch 통합은 키워드 검색을 사용합니다. 그러나 쿼리 본문을
Advanced Elasticsearch settings
에서 구성하여 다음과 같은 고급 검색 기술을 사용할 수 있습니다- ELSER를 이용한 의미 검색
- KNN 밀도 벡터 검색
- 중첩된 쿼리를 사용하여 중첩된 문서 검색하기
- 혼합 검색
- 의미론적 텍스트 필드에서 검색
다른 유형의 조회 본문 예제 사용에 대한 자세한 정보는 조회 본문 예제 를 참조하십시오.
Elasticsearch
_search
API 요청 본문에 대한 자세한 정보는 Elasticsearch 검색 API 요청 본문을 참조하십시오.기존 Elasticsearch 구성을 사용하여 어시스턴트에서 조회 본문을 사용자 정의할 수 없습니다.
-
-
메시지, 결과를 찾을 수 없음, 연결 문제 탭을 사용하여 검색 성공을 기반으로 사용자와 공유할 다른 메시지를 사용자 정의하십시오.
검색 결과 메시지 탭 시나리오 예제 메시지 메시지 검색 결과가 리턴됩니다. 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.
-
대화식 검색을 활성화하려면 대화식 검색 토글을
on
로 전환하십시오. 대화식 검색을 활성화하지 않으려면 토글을off
로 전환하십시오.대화식 검색은 watsonx Assistant의 Plus및 Enterprise 플랜에서만 사용 가능합니다. 대화식 검색 토글을
on
로 전환하면 어시스턴트 응답에서 인용 제목을 볼 수 있습니다. 대화식 검색에 대한 자세한 정보는 대화식 검색 을 참조하십시오. -
저장을 클릭하여 설정을 저장합니다.
-
Elasticsearch 창에서 문서 탭을 클릭하십시오.
문서 탭은 Elasticsearch 인스턴스의 새 색인에 문서 업로드 옵션을 선택하는 경우에만 사용으로 설정됩니다.
-
업로드 버튼을 클릭합니다. 문서 업로드 섹션 에서 파일을 드래그하거나 한 번의 클릭으로 문서를 어시스턴트에 직접 업로드할 수 있습니다.
한 번에 최대 20개의 문서를 업로드할 수 있습니다. 각 문서 파일 크기는 25KB를 초과할 수 없습니다. 모든 문서의 총 용량은 50MB를 초과하지 않아야 합니다.
Elasticsearch 업로드 문서 -
문서를 업로드한 후 Elasticsearch 창의 테이블에서 문서의 업로드 상태를 볼 수 있습니다.
-
상태
Ready
는 파일을 검색할 수 있음을 표시합니다. -
상태가
Error
인 경우Error
옆에 있는 세 개의 점을 클릭하고Delete
를 클릭하여 파일을 삭제할 수 있습니다.Elasticsearch 업로드 오류 -
Elasticsearch 인스턴스 자격 증명을 변경하지 않으려면 이 단계를 건너뛰세요. Elasticsearch 인스턴스 자격 증명을 변경하려면 인스턴스 탭을 클릭하고 자격 증명을 편집한 다음 저장를 클릭합니다.
-
저장 을 클릭한 후 닫기 를 클릭하여 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
인 경우 지식 기반 데이터베이스에서 최상의 결과의 텍스트 기반 응답이 표시됩니다.
