Vertex AI Agent Builder를 처음 사용하는 경우 Vertex AI Search 시작하기 튜토리얼에 따라 샘플 앱을 만들어 보세요.
Google Cloud 프로젝트를 설정하고 Vertex AI Agent Builder를 사용 설정하고 프로젝트의 액세스 제어를 설정합니다. 기존 Google Cloud 프로젝트가 이미 있으면 해당 프로젝트를 사용할 수 있습니다.
작업
- 시작하기 전에를 검토하고 단계를 완료했는지 확인합니다.
검색 앱에서 사용할 데이터의 종류를 결정하고 Vertex AI Search로 가져오기 위해 준비합니다.
다음 유형의 데이터를 기반으로 데이터 스토어를 만들 수 있습니다.
- 비정형 데이터. Cloud Storage에 저장된 문서(예: PDF, HTML 파일, TXT 파일)입니다. 원하는 경우 JSON 파일이나 BigQuery 테이블로 메타데이터를 제공할 수 있습니다.
- 정형 데이터. 특정 스키마와 함께 제공되는 데이터입니다. 예를 들어 BigQuery 테이블, Cloud Storage의 JSON 파일 또는 Jira와 같은 서드 파티 커넥터에서 데이터를 제공할 수 있습니다.
작업
앱 및 데이터 스토어 정보에서 지원되는 데이터 및 앱과 데이터 스토어 간의 관계에 관한 정보를 검토합니다.
수집을 위한 데이터 준비의 요구사항에 따라 데이터를 준비합니다.
사용자가 검색 앱 결과에서 볼 수 있는 데이터를 제한하기 위해 액세스 제어를 설정해야 하는 경우 기본 요건을 검토하고 데이터 소스 액세스 제어 사용에서 ID 공급업체 유형 및 데이터 소스에 관한 안내를 따르세요.
데이터 스토어를 만든 다음 데이터를 가져오거나 서드 파티 커넥터를 동기화된 데이터 소스로 설정합니다.
데이터를 가져오는 방법은 가져오는 위치에 따라 다릅니다. 예를 들어 데이터가 Cloud Storage에 있는 경우 콘솔 또는 API를 사용하여 데이터의 버킷 위치를 제공해 데이터를 가져올 수 있습니다.
작업
- 검색 데이터 스토어 만들기에서 데이터 소스에 관한 안내를 따릅니다.
Vertex AI Search는 다양한 구성 옵션을 제공합니다. 일부 옵션은 검색 위젯을 배포할지 여부에 따라 다릅니다.
작업
사용 사례와 즉시 사용 가능한 검색 위젯을 배포할지 아니면 검색 API 호출을 자체 코드에 통합할지에 따라 Vertex AI Search에서는 여러 구성 옵션을 제공합니다.
웹사이트에 검색 위젯을 삽입할 수 있습니다. 이 위젯은 검색창과 확장 가능한 검색 인터페이스를 자동으로 제공합니다. 검색 위젯을 배포하려면 다음을 구성합니다.
검색 위젯 결과. 검색 위젯의 결과 구성을 참고하세요.
검색 위젯 패싯(미리보기). 검색 위젯의 패싯 구성을 참고하세요.
위젯을 사용하는 대신 검색 API 호출을 서버 또는 애플리케이션에 통합하려는 경우 다음 옵션을 사용하여 검색 설정을 구성할 수 있습니다.
필드 설정. 정형 데이터 또는 메타데이터가 있는 비정형 데이터의 경우 필드 설정을 업데이트하여 Vertex AI Search에서 검색에 메타데이터를 사용하는 방식을 미세 조정합니다. 검색 필드 구성을 참고하세요.
자동 완성. 데이터에 따라 문서 콘텐츠, 필드, 검색 기록 또는 사용자 이벤트를 기반으로 자동 완성 추천을 설정합니다. 자동 완성 구성을 참조하세요.
서빙 컨트롤(허용 목록이 있는 미리보기). 검색 결과가 상단에 표시되거나, 하단에 표시되거나, 필터링되거나, 리디렉션되는 시점 또는 특정 검색어가 다른 검색어와 연관되는지 여부를 제어합니다. 서빙 컨트롤 구성을 참고하세요.
검색 조정(미리보기). 자체 학습 데이터로 검색 모델을 조정합니다. 검색 조정으로 검색 결과 개선을 참고하세요.
커스텀 임베딩(미리보기). 자체 임베딩을 만든 경우 Vertex AI Search에서 생성한 임베딩 대신 이를 사용하여 추가 컨텍스트로 검색을 보강할 수 있습니다. 이 기능은 정형 데이터가 포함된 데이터 스토어 또는 메타데이터가 있는 비정형 데이터에 사용할 수 있습니다. 커스텀 임베딩 사용을 참고하세요.
검색 API 호출을 자체 코드에 통합하여 앱을 배포하려는 경우 Vertex AI Search에서는 검색 결과가 반환되는 방식을 구성할 수 있는 추가 옵션을 제공합니다.
작업
다음 옵션을 사용하여 검색 결과를 구성합니다.
- 정형 또는 비정형 데이터의 일반 검색을 필터링합니다.
- 스니펫, 추출 답변 또는 추출 세그먼트를 가져옵니다. 스니펫 및 추출된 콘텐츠 가져오기를 참고하세요.
검색 결과를 미리 보고 앱 구성이 예상대로 작동하는지 확인할 수 있습니다.
작업
검색 결과를 미리 보려면 콘솔 또는 API를 사용하세요.
콘솔. Vertex AI Agent Builder 콘솔 미리보기 페이지를 사용하여 검색 위젯 구성이 결과에 미치는 영향을 미리 봅니다. 검색 결과 가져오기의 콘솔 안내를 참고하세요.
API. API 호출을 애플리케이션에 통합하는 경우 API 호출을 실행하여 검색 구성을 미리 봅니다. 검색 결과 가져오기의 REST 안내를 참고하세요.
검색 앱의 미리보기 버전에 만족하면 웹사이트에 배포하여 사용자와 공유합니다.
작업
다음 방법 중 하나로 검색 앱을 배포할 수 있습니다.
웹사이트에 검색 위젯을 삽입합니다. Vertex AI Search는 웹사이트 또는 웹 애플리케이션에 복사할 수 있는 코드를 제공합니다. 이렇게 하면 검색 위젯이 배포됩니다. 콘솔에서 검색 결과를 미리 볼 수 있습니다. 웹페이지에 검색 위젯 추가를 참고하세요.
서버 또는 애플리케이션에 검색 API 호출을 통합합니다. 검색 결과가 표시되는 방식을 완전히 제어하려면 API 호출을 서버 또는 애플리케이션에 통합하면 됩니다. API 호출에 관한 자세한 내용은 검색 결과 가져오기를 참고하세요. 클라이언트 라이브러리 리소스는 Vertex AI Agent Builder 클라이언트 라이브러리를 참고하세요.