Ricerca dei dati del data warehouse video batch

Prerequisito: crea un Batch Video Warehouse con un indice di cui è stato eseguito il deployment.

Cercare i dati di Batch Video Warehouse nella console

Console

  1. Apri la scheda Warehouse della dashboard Vision di Gemini Enterprise Agent Platform.

    Vai alla scheda Warehouse

  2. Trova l'endpoint dell'indice che vuoi cercare e fai clic su Cerca asset.

  3. Verrà visualizzato un elenco di video (ognuno corrispondente a un asset), nonché una barra di ricerca nella parte superiore. Puoi fare clic su un video per visualizzarlo o iniziare a cercare i video.

  4. Per iniziare la ricerca, inserisci una query di testo o carica un'immagine come query di ricerca. Sul lato destro della pagina dei risultati di ricerca vedrai un elenco di video clip, ognuno dei quali corrisponde a un video clip continuo negli asset. I video clip sono classificati in base alla pertinenza rispetto alla query di input.

  5. Puoi utilizzare la sezione Filters (Filtri) sul lato sinistro della pagina dei risultati di ricerca per perfezionare la ricerca. Ogni criterio di filtro è costituito da una chiave dello schema di dati e dal valore dell'annotazione che vuoi cercare. Dopo aver specificato i criteri di filtro, fai clic su Cerca per eseguire la ricerca.

Cercare i dati di Batch Video Warehouse utilizzando la riga di comando

Per cercare i video (assets) nel tuo corpus (corpus), inserisci il contenuto che vuoi trovare nel corpo dellasearchIndexEndpoint richiesta. Questo contenuto è disponibile in diversi formati:

  1. text_query o image_query: query con cui eseguire la ricerca.
  2. `criteria` (facoltativo): criteri di filtro per le annotazioni fornite dall'utente.

Nell'esempio seguente, considera un corpus che contiene video di paesaggi naturali. Per recuperare tutti gli asset pertinenti a "tramonto sulla spiaggia" e taggati con l'annotazione "state": "California", invia la seguente richiesta:

REST e riga di comando

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID come ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: Il Google Cloud numero del tuo progetto.
  • LOCATION_ID: la regione in cui utilizzi Vision di Agent Platform. Ad esempio: us-central1, europe-west4. Visualizza le regioni disponibili.
  • INDEX_ENDPOINT_ID: l'ID dell'endpoint dell'indice di destinazione.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
    }
  ]
}

Se hai un'immagine di un tramonto su una spiaggia, puoi utilizzarla anche come query di ricerca inviando la seguente richiesta (l'immagine di input è in formato di codifica Base64):

REST e riga di comando

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID come ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: Il Google Cloud numero del tuo progetto.
  • LOCATION_ID: la regione in cui utilizzi Vision di Agent Platform. Ad esempio: us-central1, europe-west4. Visualizza le regioni disponibili.
  • INDEX_ENDPOINT_ID: l'ID dell'endpoint dell'indice di destinazione.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
    }
  ]
}