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 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 Agent Builder.

      Buka Aplikasi

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

  2. Panggil metode engines.servingConfigs.search, yang 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}
}'

    • PROJECT_ID: ID project Anda.

    • APP_ID: ID aplikasi Anda.

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

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

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

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

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

      Misalnya, jika offset adalah 2 dan ukuran halaman adalah 10, hasil 2 hingga 11 akan ditampilkan.

  3. Tinjau respons. Lihat tabel berikut untuk 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 ringkas 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