Menelusuri gambar di situs

Dengan Vertex AI Search, Anda dapat menelusuri gambar menggunakan aplikasi dengan data situs. Anda memberikan kueri dalam bentuk string teks atau gambar, dan metode default_config.search menampilkan gambar untuk kueri tersebut.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut. Persyaratan bervariasi, bergantung pada apakah Anda menelusuri menggunakan kueri teks atau kueri gambar.

Untuk menggunakan command line guna melihat pratinjau hasil gambar untuk sebuah situs, gunakan metode engines.servingConfigs.search:

  1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

    1. Di konsol Google Cloud , buka halaman AI Applications.

      Buka Aplikasi

    2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

  2. Panggil metode engines.servingConfigs.search, dengan menentukan 1 untuk search_type. Pilih sintaksis metode bergantung pada apakah kueri Anda berupa byte teks atau gambar.

    Kueri adalah string teks

    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}
}'

    Kueri adalah gambar

    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}
}'

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.

    • APP_ID: ID aplikasi Anda.

    • QUERY: teks kueri penelusuran. Misalnya, "Mobil dengan lampu depan bulat" atau "tunjukkan gaun dengan garis-garis".

    • IMAGE_BYTES: gambar dalam byte berenkode Base64. Format yang didukung adalah JPEG, PNG, dan BMP.

    • PAGE_SIZE: optional. Jumlah hasil yang ditampilkan oleh penelusuran. Nilai defaultnya adalah 10 untuk penelusuran situs.

      • Nilai di bawah 0 akan menyebabkan error.
      • Nilai di atas 100 akan menyebabkan nilai ditetapkan ke 100.

    • OFFSET: optional. Indeks awal hasil. Nilai defaultnya adalah 0.

      Misalnya, jika offsetnya adalah 2 dan ukuran halamannya adalah 10, hasil 2 hingga 11 akan ditampilkan.

  3. Tinjau respons. Lihat tabel berikut untuk mengetahui deskripsi kolom:

    Kolom Deskripsi
    title Judul teks biasa dari halaman web yang berisi gambar
    htmlTitle Judul, dalam HTML, halaman web yang berisi gambar
    displayLink Versi singkat dari URL hasil penelusuran ini, biasanya nama domain—misalnya, www.example.com
    link URL gambar
    image.contextLink Link konteks: URL yang mengarah ke halaman web yang berisi gambar
    image.byteSize Ukuran gambar, dalam byte
    image.width Lebar gambar, dalam piksel
    image.height Tinggi gambar, dalam piksel
    image.thumbnailWidth Lebar gambar thumbnail, dalam piksel
    image.thumbnailHeight Tinggi gambar thumbnail, dalam piksel
    image.thumbnailLink URL gambar thumbnail
    mime Jenis MIME gambar
    fileFormat Format file gambar