Streamingvideo-Warehouse erstellen und aktualisieren

Ein Vision Warehouse ist eine Komponente, die Sie Ihrer Anwendung hinzufügen können, um Modellausgabe und Streamingdaten zu speichern.

Streaming-Video-Warehouse erstellen

Wenn Sie andere Komponentenknoten Ihres Anwendungsdiagramms mit einem Warehouse verbinden möchten, müssen Sie zuerst ein Streaming-Video-Warehouse erstellen.

Console

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

    Zum Tab „Warehouses“

  2. Wählen Sie Erstellen aus.

  3. Geben Sie einen Namen für das Warehouse ein und wählen Sie eine Gültigkeitsdauer (Time to Live, TTL) für die im Warehouse gespeicherten Assets aus. Diese Werte können später geändert werden.

    Nachdem ein Warehouse erstellt wurde können Sie das Warehouse hinzufügen zu einem Anwendungsdiagramm.

REST UND BEFEHLSZEILE

Erstellt eine neue corpus-Ressource im angegebenen Projekt mit der Option, den Anzeigenamen, die Beschreibung und die TTL für corpus anzugeben.

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 finden Sie unter regionalisierte Endpunkte.
  • 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.
  • DISPLAY_NAME: Anzeigename für das Warehouse.
  • WAREHOUSE_DESCRIPTION: Die Beschreibung des Warehouse (corpus).
  • TIME_TO_LIVE: Die Gültigkeitsdauer (TTL) für alle Assets in einem Corpus oder die TTL eines bestimmten Assets. Geben Sie für ein Corpus mit Assets mit einer TTL von 100 Tagen den Wert 8640000 (Sekunden) an.

HTTP-Methode und URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora

JSON-Text der Anfrage: 

{
  "display_name": "DISPLAY_NAME",
  "description": "WAREHOUSE_DESCRIPTION",
  "type": "STREAM_VIDEO",
  "default_ttl": {
    "seconds": TIME_TO_LIVE
  }
}

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/corpora"

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/corpora" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.CreateCorpusMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Corpus",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID",
    "displayName": "DISPLAY_NAME",
    "description": "WAREHOUSE_DESCRIPTION",
    "type": "STREAM_VIDEO",
    "defaultTtl": "TIME_TO_LIVE"
  }
}

Streaming-Video-Warehouse aktualisieren

Aktualisiert ein vorhandenes Corpus im angegebenen Projekt mit der Option, den Anzeigenamen, die Beschreibung, die Standard-TTL oder alle verfügbaren Felder zu aktualisieren.

REST UND BEFEHLSZEILE

Aktualisiert eine vorhandene corpus-Ressource im angegebenen Projekt. In diesem Beispiel wird gezeigt, wie Sie den Anzeigenamen von corpus aktualisieren. Sie können aber auch die Beschreibung, die TTL oder alle Felder gleichzeitig mit demselben URL-Format und aktualisierten Anfragetext aktualisieren.

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 finden Sie unter regionalisierte Endpunkte.
  • 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.
  • CORPUS_ID: Die ID Ihres Ziel-Corpus.
  • ?updateMask=fieldToUpdate: Eines der verfügbaren Felder, auf das Sie eine updateMask anwenden können. Geben Sie den entsprechenden neuen Feldwert im Anfrage text an. Dieser neue Wert ersetzt den vorhandenen Feldwert. Verfügbare Felder:
    • Anzeigename: ?updateMask=display_name
    • Beschreibung: ?updateMask=description
    • Standard-TTL: ?updateMask=default_ttl
    • Alle Felder aktualisieren: ?updateMask=*
  • UPDATED_FIELD_VALUE: Ein neuer Wert für das angegebene Feld. In diesem Beispiel ein neuer vom Nutzer angegebener Anzeigename für die Warehouse-Ressource.

HTTP-Methode und URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name

JSON-Text der Anfrage: 

{
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": {
    "seconds": "7800"
  }
}

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 PATCH \
     -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/corpora/CORPUS_ID?update_mask=display_name"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPORA_ID",
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": "7800s"
}