프로그래밍 검색 엔진의 커스텀 검색 사이트 제한 JSON API를 사용하는 경우 Vertex AI Search를 사용해서 Google 품질의 사이트 제한 검색을 몇 분 내에 만들고 배포할 수 있습니다. 앱을 배포하려면 코딩할 필요 없이 Google Cloud 콘솔에서 웹페이지로 직접 코드를 복사하는 방식으로 검색 위젯을 사용할 수 있습니다. 또는 API 배포를 구현하여 웹사이트에서 검색 기능의 모양과 동작을 제어할 수도 있습니다.
API 사용에 대한 자세한 내용은 웹사이트 데이터가 있는 앱의 검색 결과 가져오기의 REST 탭과 REST 참조의 servingConfigs.search 메서드를 참조하세요.
Vertex AI Search가 검색 결과와 함께 반환하는 짧은 표준 스니펫 외에도 검색에 고급 기능을 추가할 수 있습니다. 여기에는 검색 결과에 대해 생성된 요약, 팝업 질문을 허용하는 컨텍스트 인식에 대한 질문으로 검색, 각 검색 결과로 반환된 추출된 텍스트에 대한 추출 답변이 포함됩니다. 웹 검색에 대해 이러한 고급 기능을 이용하려면 도메인 확인이 필요하고 추가적인 색인 생성 비용이 발생합니다.
검색 결과를 필터링하거나 정렬하고 추천 컨트롤을 적용하여 링크를 추천 결과로 표시할 수도 있습니다.
자세한 내용은 Vertex AI Agent Builder 가격 책정 페이지를 참고하세요.
Vertex AI Search 설정
Vertex AI Search를 설정하려면 다음 단계를 수행합니다.
Google Cloud 콘솔의 프로젝트 선택자 페이지에서 커스텀 검색 사이트 제한 JSON API에 대해 사용 중인 프로젝트를 선택합니다.
검색 앱 만들기
검색 앱을 만들려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.
앱 만들기를 클릭합니다.
앱 만들기 페이지의 웹사이트 검색에서 만들기를 클릭합니다.
엔터프라이즈 버전 기능이 사용 설정되었는지 확인합니다. 웹사이트 검색을 위해 필요합니다. 자세한 내용은 Enterprise 버전 기능을 참조하세요.
고급 LLM 기능을 사용 중지합니다. 이 기능을 사용 중지하면 프로그래밍 검색 엔진의 커스텀 검색 사이트 제한 JSON API와 비슷한 기능이 제공됩니다. 검색 요약 또는 질문으로 검색이 필요하지 않으면 이를 사용 중지합니다. 자세한 내용은 고급 LLM 기능을 참조하세요.
앱 이름 필드에 앱 이름을 입력합니다.
회사 또는 조직의 외부 이름 필드에 회사 또는 조직의 일반 이름을 입력합니다.
앱의 위치로 전역(전 세계)을 선택하고 계속을 클릭합니다.
데이터 스토어 페이지에서 데이터 스토어 만들기를 클릭합니다.
데이터 소스 선택 창에서 웹사이트 콘텐츠를 선택합니다.
고급 웹사이트 색인 생성을 사용 중지합니다. 이 기능을 사용 중지하면 프로그래밍 검색 엔진의 커스텀 검색 사이트 제한 JSON API와 비슷한 기능이 제공됩니다. 검색 요약 또는 질문으로 검색이 필요하지 않거나 지정한 도메인을 소유하지 않는 경우 이를 사용 중지합니다. 자세한 내용은 고급 웹사이트 색인 생성을 참조하세요.
색인 생성할 URL 패턴 지정 창의 포함할 사이트 필드에 검색하려는 웹사이트 URL 패턴을 입력한 후 계속을 클릭합니다.
데이터 스토어 구성 창에서 데이터 스토어의 표시 이름을 입력한 후 만들기를 클릭합니다.
데이터 스토어 페이지에서 새 데이터 스토어를 선택한 후 만들기를 클릭합니다.
검색 앱 배포
Vertex AI Search 검색 앱을 인증할 방법(OAuth 2.0 또는 API 키 사용)을 결정합니다. 각 방법의 장단점에 관한 자세한 내용은 인증 정보를 참고하세요.
검색 앱 배포 (OAuth 2.0)
OAuth 2.0 인증을 사용하여 검색 앱을 배포하려면 다음 단계를 따르세요.
OAuth 2.0을 설정하려면 Vertex AI Agent Builder에 인증의 Google Cloud를 참고하세요. 서비스 계정에 검색 엔진 사용자 또는 검색 엔진 뷰어 역할을 추가해야 합니다.
다음 방법 중 하나로 검색 앱을 배포합니다.
검색 위젯을 사용합니다. 코딩할 필요 없이 검색 앱을 배포합니다. 자세한 내용은 웹페이지에 검색 위젯 추가를 참조하세요.
API를 사용합니다. 이 API를 사용하여 웹사이트에서 검색 기능의 모양과 동작을 제어합니다. 자세한 내용은 웹사이트 데이터가 있는 앱의 검색 결과 가져오기의 REST 탭과 REST 참조의
servingConfigs.search메서드를 참조하세요. 웹 검색 쿼리의 결과를 정렬하려면 웹 검색 결과 정렬을 참조하세요.
검색 앱 배포 (API 키)
인증을 위해 API 키를 사용하여 검색 앱을 배포하려면 다음 단계를 따르세요.
API 키를 만듭니다.
Google Cloud 콘솔에서 사용자 인증 정보 페이지로 이동합니다.
아직 프로젝트에 있지 않은 경우 Google Cloud 콘솔 페이지 상단의 프로젝트 목록에서 프로젝트를 선택합니다.
사용자 인증 정보 만들기를 클릭한 후 API 키를 선택합니다. 리퍼러 제한사항을 추가하지 않습니다. 일부 사용자 개인 정보 보호 설정은 리퍼러 URL을 전달하지 않습니다.
searchLite메서드를 호출할 때 사용할 생성된 API 키를 기록합니다.
보안 강화를 위해
https://discoveryengine.googleapis.com/*에서 Vertex AI Agent Builder 서비스에 대한 액세스를 제한하려면 API 키에 HTTP 제한을 추가합니다.
API를 사용하여 검색 앱을 배포합니다. 웹사이트 데이터가 있는 앱의 검색 결과 가져오기 (API 키) 및 REST 참조의
servingConfigs.searchLite메서드를 참고하세요. 웹 검색 쿼리의 결과를 정렬하려면 웹 검색 결과 정렬을 참고하세요.
인증 정보
프로그래밍 검색 엔진의 Custom Search Site Restricted JSON API는 API 키를 사용하여 인증합니다. Vertex AI Search에는 몇 가지 예외가 있지만 OAuth 2.0이 필요합니다.
인증에 API 키를 계속 사용하려면 API 호출을 통해 searchLite 메서드를 사용해야 합니다.
OAuth 2.0을 통해 인증하려면 search 메서드와 answer 메서드를 사용하여 웹사이트를 쿼리해야 합니다. 또한 코드 없는 검색 위젯을 통해 검색 앱을 배포할 수 있습니다.
다음 표에는 API 키 인증을 사용한 searchLite 메서드와 OAuth 2.0 인증을 사용한 search 및 answer 메서드의 차이점이 나와 있습니다.
| 기능/메서드 | searchLite 메서드 |
search 메서드 |
|---|---|---|
| 인증 | API 키 | OAuth 2.0 |
| 검색 위젯 사용 가능 | ✘ | ✔ |
| 검색 요약 | ✔ | ✔ |
| 정부 웹사이트 검색하기 | ✔ | ✔ |
다음 단계
검색 결과를 필터링해야 하는 경우 기본 웹사이트 검색의 필터 표현식을 참조하세요.
이미지 검색을 제공해야 하는 경우 웹사이트에서 이미지 검색을 참조하세요.
날짜별 정렬과 같이 검색 결과를 정렬해야 하는 경우 기본 웹사이트 검색의 검색 결과 정렬을 참고하세요.
멀티턴 검색이 필요한 경우 후속 질문을 위한 명령어를 참고하세요.