Menelusuri data Batch Video Warehouse

Prasyarat: buat Batch Video Warehouse dengan indeks yang di-deploy.

Menelusuri data Batch Video Warehouse di konsol

Konsol

  1. Buka tab Warehouses di dasbor Gemini Enterprise Agent Platform Vision.

    Buka tab Warehouses

  2. Temukan endpoint indeks yang ingin Anda telusuri, lalu klik Search Assets.

  3. Anda akan melihat daftar video (masing-masing sesuai dengan aset), serta satu kotak penelusuran di bagian atas. Anda dapat mengklik video untuk melihatnya, atau mulai menelusuri video.

  4. Untuk mulai menelusuri, masukkan kueri teks atau upload gambar sebagai kueri penelusuran. Anda akan melihat daftar klip video di sisi kanan halaman hasil penelusuran, yang masing-masing sesuai dengan klip video berkelanjutan dalam aset. Klip video diberi peringkat berdasarkan relevansinya dengan kueri input.

  5. Anda dapat menggunakan bagian Filters di sisi kiri halaman hasil penelusuran untuk menyaring penelusuran. Setiap kriteria filter terdiri dari kunci skema data dan nilai anotasi yang ingin Anda telusuri. Setelah menentukan kriteria filter, klik Search untuk menjalankan penelusuran.

Menelusuri data Batch Video Warehouse menggunakan command line

Untuk menelusuri video (assets) dalam korpus (corpus), isi searchIndexEndpoint isi permintaan dengan konten yang ingin Anda temukan. Konten ini memiliki beberapa format yang berbeda:

  1. text_query atau image_query: Kueri untuk ditelusuri.
  2. `criteria` opsional criteria: Kriteria filter pada anotasi yang diberikan pengguna.

Pada contoh berikut, pertimbangkan korpus yang berisi video pemandangan alam. Untuk mengambil semua aset yang relevan dengan "sunset at beach" dan diberi tag dengan anotasi "state": "California", kirim permintaan berikut:

REST &CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti seperti europe-west4-. Lihat lebih lanjut tentang endpoint regional.
  • PROJECT_NUMBER: Nomor Google Cloud project Anda.
  • LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • INDEX_ENDPOINT_ID: ID endpoint indeks target Anda.

Metode HTTP dan URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Meminta isi JSON: 

{
  "text_query": "sunset at beach",
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}

Jika memiliki gambar matahari terbenam di pantai, Anda juga dapat menggunakannya sebagai kueri penelusuran dengan mengirimkan permintaan berikut (gambar input dalam format encoding base64):

REST &CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti seperti europe-west4-. Lihat lebih lanjut tentang endpoint regional.
  • PROJECT_NUMBER: Nomor Google Cloud project Anda.
  • LOCATION_ID: Region tempat Anda menggunakan Agent Platform Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • INDEX_ENDPOINT_ID: ID endpoint indeks target Anda.

Metode HTTP dan URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Meminta isi JSON: 

{
  "image_query": {
    "input_image": "IMAGE_BYTES"
  },
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}