IBM Cloud Docs
Google 사용자 정의 검색 확장 설정

Google 사용자 정의 검색 확장 설정

Google Programmable Search Engine 을 사용하는 어시스턴트에 대한 확장을 통해 Google 검색에 액세스할 수 있습니다. 유스 케이스에 따라 사용자 정의할 수 있는 구성 가능한 검색입니다.

Google 검색에 대한 확장을 설정하려면 다음을 수행하십시오.

검색 엔진 ID및 API키 가져오기

Google Programmable Search Engine을 작성하십시오. 그런 다음 검색 엔진 ID및 API키를 가져오십시오. 자세한 지시사항은 Google 프로그래밍 가능 검색 엔진 문서의 프로그래밍 가능 검색 엔진 작성 을 참조하십시오.

OpenAPI 스펙 다운로드

OpenAPI 스펙 파일 google-custom-search-openapi.json을 다운로드하십시오. 이 파일을 사용하여 어시스턴트에 확장을 추가합니다.

OpenAPI 스펙은 다음 메소드를 정의합니다.

  • GET /customsearch/v1: 전체 웹에서 컨텐츠를 검색합니다.
  • GET /customsearch/v1/siterestrict: 특정 웹 사이트 콜렉션에서 컨텐츠를 검색합니다.

엔드포인트에 대한 자세한 정보는 사용자 정의 검색 또는 사용자 정의 검색 사이트 제한을 참조하십시오.

엔드포인트에는 동일한 인수 및 응답이 있지만 다음과 같은 차이점이 있습니다.

  • 제한된 사용자 정의 검색 사이트 는 10개이하의 웹 사이트를 검색하도록 제한되며 각 웹 사이트에는 무제한의 페이지가 있을 수 있습니다.
  • 사용자 정의 검색 은 Google에 의해 색인화되지만 일일 조회 한계 가 있는 임의의 수의 웹 사이트를 지원할 수 있습니다.

특정 주제에 초점을 맞춘 일반적인 어시스턴트의 경우 일반적으로 단일 웹 사이트 또는 몇 개의 웹 사이트만 검색하면 됩니다. 제한된 사용자 정의 검색 사이트 는 하루에 실행할 수 있는 조회 수에 제한이 없으므로 더 적합합니다. 10개이상의 웹 사이트를 검색해야 하는 어시스턴트는 대신 사용자 정의 검색 을 사용해야 합니다.

확장 작성 및 추가

  1. 어시스턴트의 통합 페이지에서 사용자 정의 확장 빌드 를 클릭하고 OpenAPI 스펙 파일을 사용하여 사용자 정의 확장을 빌드하십시오. 사용자 정의 확장 빌드에 대한 일반 지시사항은 사용자 정의 확장 빌드 를 참조하십시오.

  2. Google 사용자 정의 검색 확장을 빌드한 후 통합 페이지에 표시되면 추가 를 클릭하여 어시스턴트에 추가하십시오. Google 프로그래밍 가능 검색 엔진 API키를 사용하여 인증하십시오. 사용자 정의 확장 추가에 대한 일반 지시사항은 어시스턴트에 확장 추가 를 참조하십시오.

Google 사용자 정의 검색 스타터 킷 조치 템플리트 추가

  1. 조치 페이지를 여십시오.

  2. 조치가 없는 경우 새 조치 작성을 선택하십시오. 이미 일부 조치가 있는 경우 새 조치를 선택하십시오.

  3. 조치 작성에서 템플리트로 빠른 시작을 선택하십시오.

    템플리트로 빠른 시작 은 영어 지원에서만 사용 가능합니다.

  4. 템플리트를 사용한 빠른 시작에서 Google 사용자 정의 검색 스타터 킷을 추가하십시오.

시스템 조치 편집

  1. 어시스턴트로 설정 을 클릭하고 일치하지 않음 조치를 여십시오.

  2. 두 개의 기본 단계를 삭제하십시오.

  3. 단계를 추가하십시오. 그리고 를 하위 액션으로 이동 으로 설정하고 Google 검색 액션을 선택하십시오.

  4. 고객을 라이브 에이전트에 연결하지 않는 경우 일치하지 않음과 동일한 방식으로 대체 조치를 편집할 수 있습니다.

Google 사용자 정의 검색 확장 사용

어시스턴트에 대한 조회를 실행하십시오. 해당 조회와 일치하는 조치가 없으면 Google 을 사용하여 검색 결과를 생성합니다.

검색 결과 크기 제한

watsonx Assistant 에는 검색 결과를 포함하는 컨텍스트 변수에 저장되는 정보의 크기에 대한 100KB제한이 있습니다. 확장의 결과가 해당 한계를 초과하는 경우 표시되는 경고 또는 오류 없이 조치가 실패할 수 있습니다. 일반적으로 지연 시간이 길면 응답이 없습니다. 이 실패는 Google 사용자 정의 검색 확장에서 거의 발생하지 않지만 Google 사용자 정의 검색에서 리턴되는 대량의 메타데이터가 있는 사이트를 검색하는 경우에 발생할 수 있습니다. 이것이 문제가 될 수 있다고 생각되면 curl, In불면증 또는 Postman 과 같은 API 테스트 도구에서 조회를 실행하십시오. 검색 결과로 가져오는 데이터의 바이트 수를 확인하십시오. 총계가 100KB이상인 경우, num_of_results 를 줄이고 각 조회에 대해 더 적은 결과를 얻거나 대량의 메타데이터가 있는 사이트 또는 페이지를 제외하여 문제를 해결할 수 있습니다.

자세한 정보는 IBM Watson® Discovery의 스타터 킷에서 검색 결과 크기 제한 을 참조하십시오.