In Batch Video Warehouse-Daten suchen

Voraussetzung: Batch Video Warehouse mit einem bereitgestellten Index erstellen.

Batch Video Warehouse-Daten in der Konsole suchen

Console

  1. Öffnen Sie den Tab Warehouses (Data Warehouses) des Gemini Enterprise Agent Platform Vision-Dashboards.

    Tab „Warehouses“ aufrufen

  2. Suchen Sie den Indexendpunkt, den Sie durchsuchen möchten, und klicken Sie auf Search Assets (Assets suchen).

  3. Oben sehen Sie eine Liste von Videos (jedes entspricht einem Asset) sowie eine Suchleiste. Sie können entweder auf ein Video klicken, um es anzusehen, oder nach Videos suchen.

  4. Geben Sie zum Starten der Suche eine Textanfrage ein oder laden Sie ein Bild als Suchanfrage hoch. Auf der rechten Seite der Suchergebnisseite sehen Sie eine Liste von Videoausschnitten, die jeweils einem durchgehenden Videoausschnitt in den Assets entsprechen. Die Videoausschnitte werden nach Relevanz für die Eingabeanfrage sortiert.

  5. Im Bereich Filters (Filter) auf der linken Seite der Suchergebnisseite können Sie Ihre Suche verfeinern. Jedes Filterkriterium besteht aus einem Datenschemaschlüssel und dem Annotationswert, nach dem Sie suchen möchten. Nachdem Sie die Filterkriterien angegeben haben, klicken Sie auf Search (Suchen), um die Suche auszuführen.

Batch Video Warehouse-Daten über die Befehlszeile suchen

Wenn Sie die Videos (assets) in Ihrem Korpus (corpus) durchsuchen möchten, füllen Sie den searchIndexEndpoint Anfragetext mit dem Inhalt, den Sie suchen möchten. Dieser Inhalt kann in verschiedenen Formaten vorliegen:

  1. text_query oder image_query: Anfrage für die Suche.
  2. Optional criteria: Filterkriterien für vom Nutzer bereitgestellte Annotationen.

Betrachten Sie im folgenden Beispiel einen Korpus mit Videos von Naturlandschaften. Wenn Sie alle Assets abrufen möchten, die für „Sonnenuntergang am Strand“ relevant sind und mit der Annotation "state": "California" getaggt wurden, senden Sie die folgende Anfrage:

REST UND BEFEHLSZEILE

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit der LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten.
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Agent Platform Vision verwenden. Beispiel: us-central1, europe-west4. Verfügbare Regionen ansehen.
  • INDEX_ENDPOINT_ID: Die ID Ihres Zielindexendpunkts.

HTTP-Methode und URL: 

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

JSON-Text der Anfrage: 

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Wenn Sie ein Bild von einem Sonnenuntergang am Strand haben, können Sie es auch als Suchanfrage verwenden, indem Sie die folgende Anfrage senden (das Eingabebild ist im Base64-Codierungsformat):

REST UND BEFEHLSZEILE

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit der LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten.
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Agent Platform Vision verwenden. Beispiel: us-central1, europe-west4. Verfügbare Regionen ansehen.
  • INDEX_ENDPOINT_ID: Die ID Ihres Zielindexendpunkts.

HTTP-Methode und URL: 

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

JSON-Text der Anfrage: 

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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