Vertex AI Search를 처음 사용하는 경우 미디어 검색 시작하기 빠른 시작 튜토리얼에 따라 샘플 앱을 만들어 보세요.
Google Cloud 프로젝트를 설정하고 Vertex AI Agent Builder를 사용 설정하고 프로젝트의 액세스 제어를 설정합니다. 기존 Google Cloud 프로젝트가 이미 있으면 해당 프로젝트를 사용할 수 있습니다.
작업
- 시작하기 전에의 단계를 완료합니다.
Vertex AI Search로 가져올 데이터를 준비합니다.
미디어 검색 앱은 다음 데이터를 사용합니다.
구조화된 미디어 데이터. 필수 항목입니다. 제목, 설명, URI와 같은 미디어 콘텐츠에 관한 메타데이터 정보를 미디어 위치에 업로드합니다. Vertex AI Search는 미디어의 사전 정의된 스키마를 제공합니다. 또는 자체 스키마를 사용할 수 있습니다.
사용자 이벤트. 선택사항이지만 적극 권장됩니다. 사용자 이벤트를 기록하면 검색 결과의 순위를 높이는 데 도움이 됩니다.
작업
미디어 문서 및 데이터 스토어 정보에서 미디어 데이터 및 데이터 스토어에 관한 정보를 검토하고 필요한 스키마 및 필드에 따라 데이터를 준비합니다. 자체 스키마를 사용하는 경우 JSON 객체로 된 스키마 예시 및 정형 데이터도 참고하세요.
사용자 이벤트 정보에서 미디어 사용자 이벤트의 요건을 검토합니다.
앱과 데이터 스토어를 만든 다음 미디어 데이터를 가져옵니다.
미디어 데이터를 가져오는 방법은 가져오는 위치에 따라 다릅니다. 예를 들어 데이터가 Cloud Storage에 있는 경우 콘솔 또는 API를 사용하여 데이터의 버킷 위치를 제공해 데이터를 가져올 수 있습니다.
미디어 검색 앱의 경우 사용자 이벤트가 권장되지만 필수는 아닙니다.
작업
앱에서 학습을 시작할 수 있도록 이전 사용자 이벤트를 일괄적으로 가져옵니다.
Vertex AI Search는 다양한 구성 옵션을 제공합니다. 일부 옵션은 검색 위젯을 배포할지 여부에 따라 다릅니다.
작업
사용 사례와 즉시 사용 가능한 검색 위젯을 배포할지 아니면 검색 API 호출을 자체 코드에 통합할지에 따라 Vertex AI Search에서는 여러 구성 옵션을 제공합니다.
검색창과 확장 가능한 검색 인터페이스를 자동으로 제공하는 검색 위젯을 웹사이트에 삽입할 수 있습니다. 검색 위젯을 배포하려면 다음을 구성합니다.
검색 위젯 결과. 검색 위젯의 결과 구성을 참고하세요.
검색 위젯 패싯. 검색 위젯의 패싯 구성을 참고하세요.
위젯을 사용하는 대신 검색 API 호출을 서버 또는 애플리케이션에 통합하려는 경우 다음 옵션을 사용하여 검색 설정을 구성할 수 있습니다.
필드 설정. 정형 데이터 또는 메타데이터가 있는 비정형 데이터의 경우 필드 설정을 업데이트하여 Vertex AI Search에서 검색에 메타데이터를 사용하는 방식을 미세 조정합니다. 검색 필드 구성을 참고하세요.
자동 완성. 데이터에 따라 문서 콘텐츠, 필드, 검색 기록 또는 사용자 이벤트를 기반으로 자동 완성 추천을 설정합니다. 자동 완성 구성을 참조하세요.
서빙 컨트롤(허용 목록이 있는 미리보기). 검색 결과가 상단에 표시되거나, 하단에 표시되거나, 필터링되거나, 리디렉션되는 시점 또는 특정 검색어가 다른 검색어와 연관되는지 여부를 제어합니다. 서빙 컨트롤 구성을 참고하세요.
Search-as-you-type. 앱에서 TV 리모컨과 같이 불편한 입력 장치를 사용하는 경우 실시간 검색 기능을 사용 설정할 수 있습니다. 미디어 앱의 실시간 검색 결과 가져오기를 참고하세요.
검색 결과를 미리 보고 앱 구성이 예상대로 작동하는지 확인할 수 있습니다.
작업
검색 결과를 미리 보려면 콘솔 또는 API를 사용하세요.
콘솔. Vertex AI Agent Builder 콘솔 미리보기 페이지를 사용하여 검색 위젯 구성이 결과에 미치는 영향을 미리 봅니다. 검색 결과 가져오기의 콘솔 안내를 참고하세요.
API. API 호출을 애플리케이션에 통합하는 경우 API 호출을 실행하여 검색 구성을 미리 봅니다. 검색 결과 가져오기의 REST 안내를 참고하세요.
미디어 검색 앱의 미리보기 버전에 만족하면 웹사이트에 배포하여 사용자와 공유합니다.
작업
다음 방법 중 하나로 검색 앱을 배포할 수 있습니다.
웹사이트에 검색 위젯을 삽입합니다. Vertex AI Search는 웹사이트 또는 웹 애플리케이션에 복사할 수 있는 코드를 제공합니다. 이렇게 하면 검색 위젯이 배포됩니다. 콘솔에서 검색 결과를 미리 볼 수 있습니다. 웹페이지에 검색 위젯 추가를 참고하세요.
서버 또는 애플리케이션에 검색 API 호출을 통합합니다. 검색 결과가 표시되는 방식을 완전히 제어하려면 API 호출을 서버 또는 애플리케이션에 통합하면 됩니다. API 호출에 관한 자세한 내용은 검색 결과 가져오기를 참고하세요. 클라이언트 라이브러리 리소스는 Vertex AI Agent Builder 클라이언트 라이브러리를 참고하세요.