웹사이트에서 이미지 검색

Vertex AI Search를 사용하면 웹사이트 데이터가 포함된 앱을 사용하여 이미지를 검색할 수 있습니다. 텍스트 문자열 또는 이미지 형식으로 쿼리를 제공하면 default_config.search 메서드가 해당 쿼리의 이미지를 반환합니다.

시작하기 전에

다음 기본 요건이 충족되었는지 확인합니다. 요구사항은 텍스트 쿼리를 사용해 검색하는지 아니면 이미지 쿼리를 사용해 검색하는지에 따라 다릅니다.

웹사이트 검색 앱에서 텍스트 쿼리를 사용하여 검색하는 경우 엔터프라이즈 버전 기능이 사용 설정되어 있는지 확인합니다.
웹사이트 검색 앱에서 이미지 쿼리를 사용하여 검색하는 경우 다음이 사용 설정되어 있는지 확인하세요.
- Enterprise 버전 기능
- 고급 웹사이트 색인 생성

이미지 검색 미리보기

명령줄을 사용하여 웹사이트의 이미지 결과를 미리 보려면 engines.servingConfigs.search 메서드를 사용하세요.

참고: engines.servingConfigs.search 메서드를 사용하여 앱을 검색하고 dataStores.servingConfigs.search 메서드를 사용하여 데이터 스토어를 검색할 수 있습니다. 다음 절차에서는 engines.servingConfigs.search 메서드를 사용하여 검색하는 것이 좋습니다.

앱 ID를 찾습니다. 앱 ID를 이미 알고 있는 경우 다음 단계로 건너뜁니다.
1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.
  
  앱으로 이동
2. 앱 페이지에서 앱 이름을 찾고 ID 열에서 앱 ID를 가져옵니다.

search_type에 1을 지정하여 engines.servingConfigs.search 메서드를 호출합니다. 쿼리가 텍스트인지 이미지 바이트인지에 따라 메서드 구문을 선택합니다.

텍스트 문자열인 쿼리

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

이미지인 쿼리

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"imageQuery": {"imageBytes":"IMAGE_BYTES"},
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

PROJECT_ID: 프로젝트의 ID입니다.
APP_ID: 앱의 ID입니다.
QUERY: 검색어 텍스트입니다. 예를 들어 '원형 헤드라이트 자동차' 또는 '줄무늬가 있는 드레스 보여 줘'라고 말합니다.
IMAGE_BYTES: Base64 인코딩된 바이트 단위의 이미지입니다. 지원되는 형식은 JPEG, PNG, BMP입니다.
PAGE_SIZE: 선택사항. 검색에서 반환된 결과 수입니다. 웹사이트 검색의 기본값은 10입니다.
- 0보다 작은 값은 오류를 일으킵니다.
- 100을 초과하는 값은 100으로 설정됩니다.
OFFSET: 선택사항. 결과의 시작 색인입니다. 기본값은 0입니다.

예를 들어 오프셋이 2이고 페이지 크기가 10이면 결과 2~11이 반환됩니다.

대답을 검토합니다. 필드 설명은 다음 표를 참조하세요.

필드	설명
`title`	이미지가 포함된 웹페이지의 일반 텍스트 제목
`htmlTitle`	이미지가 포함된 웹페이지의 HTML 제목
`displayLink`	이 검색 결과 URL의 축약된 버전으로 일반적으로 도메인 이름입니다(예: `www.example.com`).
`link`	이미지의 URL
`image.contextLink`	컨텍스트 링크: 이미지가 포함된 웹페이지를 가리키는 URL
`image.byteSize`	이미지 크기(바이트)
`image.width`	이미지 너비(픽셀)
`image.height`	이미지 높이(픽셀)
`image.thumbnailWidth`	썸네일 이미지 너비(픽셀)
`image.thumbnailHeight`	썸네일 이미지 높이(픽셀)
`image.thumbnailLink`	썸네일 이미지의 URL
`mime`	이미지의 MIME 유형
`fileFormat`	이미지의 파일 형식