웹사이트 검색 체크리스트

이 페이지에서는 일반 검색 앱의 한 유형인 웹사이트 검색 앱을 만드는 데 필요한 단계의 체크리스트를 제공합니다. 다른 유형의 일반 검색 앱을 만드는 체크리스트는 일반 검색 체크리스트를 참고하세요.

Vertex AI Agent Builder를 처음 사용하는 경우 일반 검색 시작하기 튜토리얼에 따라 샘플 웹사이트 데이터 앱을 만들어 보세요.

기본 웹사이트 검색과 고급 웹사이트 색인 생성 중에서 선택

Vertex AI Agent Builder는 기본 웹사이트 검색과 고급 웹사이트 색인 생성이라는 두 가지 유형의 웹사이트 데이터 스토어를 제공합니다.

고급 웹사이트 색인 생성을 사용 설정하여 검색 데이터 스토어의 웹페이지에 색인을 생성할 수 있습니다. 고급 웹사이트 색인 생성에는 도메인 확인이 필요하며 기본 웹사이트 검색보다 더 많은 추가 기능을 제공합니다. 자세한 내용은 고급 웹사이트 색인 생성을 참조하세요.

비즈니스 요구사항에 필요한 웹사이트 데이터 스토어의 유형에 따라 다음 체크리스트 중 하나를 선택합니다.

Google Cloud 프로젝트 설정

Google Cloud 프로젝트를 설정하고 Vertex AI Agent Builder를 사용 설정하고 프로젝트의 액세스 제어를 설정합니다. 기존 Google Cloud 프로젝트가 이미 있으면 해당 프로젝트를 사용할 수 있습니다.

작업

시작하기 전에 페이지를 검토하고 단계를 완료했는지 확인합니다.

데이터 준비

웹사이트 검색 앱(일반 검색 앱의 한 유형)의 동작 방식과 웹사이트 데이터 스토어에 웹사이트를 포함하기 위한 기본 요건을 이해합니다.

작업

앱 및 데이터 스토어 정보에서 일반 앱과 데이터 스토어 간의 관계에 관한 정보와 웹사이트 데이터의 구성요소를 검토합니다. 데이터 스토어에 고급 웹사이트 색인 생성이 사용 설정되어 있으면 여러 데이터 스토어가 앱에 연결된 혼합 검색에 해당 데이터 스토어를 사용할 수 있습니다.
웹사이트 데이터의 요구사항에 따라 웹사이트 데이터를 준비합니다.

데이터 스토어 만들기

포함할 웹사이트 URL 패턴과 제외할 URL 패턴을 제공하여 데이터 스토어를 만듭니다. 데이터 스토어 생성 프로세스에는 고급 웹사이트 색인 생성을 사용 설정하는 단계가 포함되며, 이 단계에서 도메인 확인이 필요합니다.

작업

웹사이트 URL을 사용하여 데이터 스토어 만들기에서 데이터 소스에 관한 안내를 따릅니다.

데이터 스토어 생성 및 도메인 확인에 성공하면 Vertex AI Agent Builder가 최선의 방식으로 자동으로 새로고침되는 초기 색인을 생성합니다. 이 절차는 몇 시간 정도 걸릴 수 있습니다.

앱 만들기

웹사이트 검색 앱을 만들고 새 데이터 스토어에 연결합니다.

작업

검색 앱을 만듭니다. 엔터프라이즈 버전을 사용 설정해야 합니다.

데이터 스토어 수준에서 검색 설정 구성

Vertex AI Search는 다양한 구성 옵션을 제공합니다. 일부 옵션은 검색 위젯을 배포할지 여부에 따라 다릅니다.

작업

사용 사례와 즉시 사용 가능한 검색 위젯을 배포할지 아니면 검색 API 호출을 자체 코드에 통합할지에 따라 Vertex AI Search에서는 여러 구성 옵션을 제공합니다.

검색창과 확장 가능한 검색 인터페이스를 자동으로 제공하는 검색 위젯을 웹사이트에 삽입할 수 있습니다. 검색 위젯을 배포하려면 다음을 구성합니다.
- 검색 위젯 결과. 검색 위젯의 결과 구성을 참고하세요.
- 검색 위젯 패싯(미리보기). 검색 위젯의 패싯 구성을 참고하세요.
- 자동 완성. 자동 완성 설정 업데이트를 참고하세요.
- 검색 조정(미리보기). 검색 조정으로 검색 결과 개선을 참고하세요.
위젯을 사용하는 대신 검색 API 호출을 서버 또는 애플리케이션에 통합하려는 경우 다음 옵션을 사용하여 검색 설정을 구성할 수 있습니다.
- 자동 완성. 데이터에 따라 문서 콘텐츠, 필드, 검색 기록 또는 사용자 이벤트를 기반으로 자동 완성 추천을 설정합니다. 자동 완성 구성을 참조하세요.
- 서빙 컨트롤(허용 목록이 있는 미리보기). 검색 결과가 상단에 표시되거나, 하단에 표시되거나, 필터링되거나, 리디렉션되는 시점 또는 특정 검색어가 다른 검색어의 동의어인지 여부를 제어합니다. 서빙 컨트롤 구성을 참고하세요.
- 검색 조정(미리보기). 자체 학습 데이터로 검색 모델을 조정합니다. 검색 조정으로 검색 결과 개선을 참고하세요.

요청 수준에서 검색 결과 구성

검색 API 호출을 자체 코드에 통합하여 앱을 배포하려는 경우 Vertex AI Search에서는 검색 결과가 반환되는 방식을 구성할 수 있는 추가 옵션을 제공합니다.

작업

다음 옵션을 사용하여 검색 결과를 구성합니다.

검색 결과 미리보기

검색 결과를 미리 보고 앱 구성이 예상대로 작동하는지 확인할 수 있습니다.

작업

검색 결과를 미리 보려면 콘솔 또는 API를 사용하세요.
- 콘솔. Vertex AI Agent Builder 콘솔 미리보기 페이지를 사용하여 검색 위젯 구성이 결과에 미치는 영향을 미리 봅니다. 검색 결과 가져오기의 콘솔 안내를 참고하세요.
- API. API 호출을 애플리케이션에 통합하는 경우 curl 호출을 실행하여 검색 구성을 미리 볼 수 있습니다. 검색 결과 가져오기의 REST 안내를 참고하세요.

검색 결과 필터링

웹페이지에 추가된 정형 데이터를 활용하여 데이터 스토어의 색인을 보강합니다.

작업

웹페이지에 정형 데이터를 추가하는 것은 다음과 같이 반복적인 프로세스입니다.

웹페이지에서 정형 데이터를 수정합니다. 자세한 내용은 고급 웹사이트 색인 생성에 정형 데이터 사용을 참조하세요.
필요에 따라 정형 데이터 속성으로 데이터 스토어 스키마를 업데이트합니다.
검색 결과를 다시 구성합니다. 이 체크리스트의 6단계를 참고하세요.
검색 결과를 미리 봅니다. 이 체크리스트의 7단계를 참고하세요.
검색 앱을 배포하기 전에 필요한 검색 동작을 실행하려면 필요한 만큼 이 프로세스를 반복합니다.

검색 앱 배포

검색 앱의 미리보기 버전에 만족하면 웹사이트에 배포하여 사용자와 공유합니다.

작업

다음 방법 중 하나로 검색 앱을 배포할 수 있습니다.
- 웹사이트에 검색 위젯을 삽입합니다. Vertex AI Search는 웹사이트 또는 웹 애플리케이션에 복사할 수 있는 코드를 제공합니다. 이렇게 하면 검색 위젯이 배포됩니다. 콘솔에서 검색 결과를 미리 볼 수 있습니다. 웹페이지에 검색 위젯 추가를 참고하세요.
- 서버 또는 애플리케이션에 검색 API 호출을 통합합니다. 검색 결과가 표시되는 방식을 완전히 제어하려면 API 호출을 서버 또는 애플리케이션에 통합하면 됩니다. API 호출에 관한 자세한 내용은 검색 결과 가져오기를 참고하세요. 클라이언트 라이브러리 리소스는 Vertex AI Agent Builder 클라이언트 라이브러리를 참고하세요.

앱 유지관리

앱을 유지하여 데이터 스토어에서 최신 및 필요한 데이터를 사용할 수 있도록 할 수 있습니다.

작업

데이터를 새로고침합니다.