Crea e aggiorna un asset warehouse

Un Vision Warehouse connesso (corpus) in un'app di importazione dei dati di cui è stato eseguito il deployment ha una o più risorse di oggetti multimediali (ad esempio risorse video). Questi oggetti multimediali (risorse asset) contengono metadati e annotazioni delle risorse. Utilizza i seguenti comandi per creare e aggiornare questi oggetti multimediali.

Creare un asset magazzino video in streaming

Dopo aver creato un warehouse (risorsa corpus), puoi aggiungere una o più risorse video asset al warehouse.

REST & CMD LINE

Il seguente codice crea una nuova risorsa nell'ambito del magazzino specificato (corpus) con l'opzione per specificare l'ID della risorsa e un TTL.

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

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID, ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: il tuo Google Cloud numero di progetto.
  • LOCATION_ID: la regione in cui utilizzi Agent Platform Vision. Ad esempio: us-central1, europe-west4. Consulta le regioni disponibili.
  • CORPUS_ID: l'ID del corpus di destinazione.
  • ASSET_ID: (facoltativo) un valore fornito dall'utente per l'ID risorsa. In questa richiesta, il valore viene aggiunto all'URL della richiesta nel formato:
    • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
  • TIME_TO_LIVE: la durata (TTL) di tutti gli asset di un corpus o la durata (TTL) di un asset specifico. Ad esempio, per un corpus con asset con un TTL di 100 giorni, fornisci il valore 8640000 (secondi).

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "ttl": {
    "seconds": TIME_TO_LIVE
  }
}

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

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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID",
  "ttl": "TIME_TO_LIVEs"
}

SDK Vision di Gemini Enterprise Agent Platform

Per inviare una richiesta di lettura di un flusso di output del modello devi installare l'SDK Vision di Gemini Enterprise Agent Platform.

Quando utilizzi lo strumento a riga di comando vaictl per creare una risorsa, non puoi specificare un ID risorsa o un TTL.

Effettua le seguenti sostituzioni di variabili:

  • PROJECT_NUMBER: il tuo Google Cloud numero di progetto.
  • LOCATION_ID: il tuo ID località. Ad esempio, us-central1. Regioni supportate. Scopri di più.
  • CORPUS_ID: l'ID del magazzino di destinazione (risorsa corpus).
vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Dopo aver creato una risorsa, puoi importare i dati video direttamente nel warehouse per quella risorsa utilizzando lo strumento a riga di comando vaictl.

Aggiorna un asset del magazzino di video in streaming

Utilizza il seguente esempio di codice per aggiornare il time-to-live (TTL) di un asset. Puoi aggiornare solo il campo TTL.

Utilizza il parametro della query updateMask nel seguente esempio di codice per aggiornare il TTL di un asset. Puoi utilizzare un parametro di query per aggiornare solo il campo TTL. Il updateMask funziona nel seguente modo:

  • Se specificato, vengono aggiornati solo i campi in updateMask.
  • Se il valore della maschera di aggiornamento è *, la richiesta aggiorna tutti i campi.

  • Se la maschera di aggiornamento non è specificata, vengono aggiornati solo i campi nell'URL della richiesta con un valore fornito nel corpo della richiesta.

REST & CMD LINE

I seguenti esempi di codice modificano il TTL di un asset utilizzando il metodo projects.locations.corpora.assets.patch.

Modificare un valore TTL

Questo esempio utilizza ?updateMask=ttl nell'URL della richiesta e include un nuovo valore ttl.seconds nel corpo della richiesta per aggiornare l'asset.

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

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID, ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: il tuo Google Cloud numero di progetto.
  • LOCATION_ID: la regione in cui utilizzi Agent Platform Vision. Ad esempio: us-central1, europe-west4. Consulta le regioni disponibili.
  • CORPUS_ID: l'ID del corpus di destinazione.
  • ASSET_ID: l'ID dell'asset di destinazione.
  • ?updateMask=fieldToUpdate: uno dei campi disponibili a cui puoi applicare un updateMask. Campi disponibili:
    • Durata (TTL): ?updateMask=ttl
    • Aggiorna tutti i campi: ?updateMask=*

Metodo HTTP e URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Corpo JSON della richiesta: 

{
  "ttl": {
    "seconds": "1"
  }
}

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 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/assets/ASSET_ID?updateMask=ttl"

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 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/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}

Rimuovere un valore TTL

Questo esempio utilizza ?updateMask=ttl nell'URL della richiesta e include un corpo della richiesta vuoto per cancellare il valore TTL dell'asset.

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

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID, ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: il tuo Google Cloud numero di progetto.
  • LOCATION_ID: la regione in cui utilizzi Agent Platform Vision. Ad esempio: us-central1, europe-west4. Consulta le regioni disponibili.
  • CORPUS_ID: l'ID del corpus di destinazione.
  • ASSET_ID: l'ID dell'asset di destinazione.
  • ?updateMask=fieldToUpdate: uno dei campi disponibili a cui puoi applicare un updateMask. Campi disponibili:
    • Durata (TTL): ?updateMask=ttl
    • Aggiorna tutti i campi: ?updateMask=*

Metodo HTTP e URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

Corpo JSON della richiesta: 

{}

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 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/assets/ASSET_ID?updateMask=ttl"

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 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/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}