웹사이트에서 이미지 검색

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

시작하기 전에

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

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

  1. 앱 ID를 찾습니다. 앱 ID를 이미 알고 있는 경우 다음 단계로 건너뜁니다.

    1. Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동합니다.

      앱으로 이동

    2. 앱 페이지에서 앱 이름을 찾고 ID 열에서 앱 ID를 가져옵니다.

  2. 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번까지 결과가 반환됩니다.

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

    필드 설명
    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 이미지의 파일 형식