Crea y actualiza un recurso de almacén

Un Almacén de Vision (corpus) conectado en una app implementada que ingiere datos tiene uno o más recursos de objetos multimedia (por ejemplo, recursos de video). Estos objetos multimedia (recursos asset) contienen metadatos y anotaciones de recursos. Usa los siguientes comandos para crear y actualizar estos objetos multimedia.

Crea un recurso de Vision Warehouse de transmisión de video

Después de crear un warehouse (corpus recurso), puedes agregar uno o más recursos asset de video al warehouse.

LÍNEA DE REST Y CMD

Con el siguiente código, se crea un recurso nuevo en el warehouse determinado (corpus) con la opción de especificar el ID del recurso y un TTL.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con el LOCATION_ID como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Es tu Google Cloud número de proyecto.
  • LOCATION_ID: Es la región en la que usas Agent Platform Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: (Opcional) Es un valor proporcionado por el usuario para el ID del activo. En esta solicitud, el valor se agrega a la URL de la solicitud de la siguiente manera:
    • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
  • TIME_TO_LIVE: Es la cantidad de tiempo de actividad (TTL) para todos los recursos en un corpus o el TTL de un recurso específico. Por ejemplo, para un corpus con recursos con un TTL de 100 días, proporciona el valor 8640000 (segundos).

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

SDK de Gemini Enterprise Agent Platform Vision

Para enviar una solicitud para leer un flujo de salida del modelo, debes instalar el SDK de Gemini Enterprise Agent Platform Vision.

Cuando usas la herramienta de línea de comandos de vaictl para crear un activo, no puedes especificar un ID del activo ni un TTL.

Realiza las siguientes sustituciones de variables:

  • PROJECT_NUMBER: Es tu Google Cloud número de proyecto.
  • LOCATION_ID: Es tu ID de ubicación. Por ejemplo, us-central1. Regiones admitidas. Más información.
  • CORPUS_ID: Es el ID del warehouse de destino (recurso corpus).
vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Después de crear un recurso, puedes ingerir datos de video directamente en el warehouse para ese recurso con la herramienta de línea de comandos de vaictl.

Actualiza un recurso de Vision Warehouse de transmisión de video

Usa la siguiente muestra de código para actualizar el tiempo de actividad (TTL) de un recurso. Solo puedes actualizar el campo TTL.

Usa el parámetro de consulta updateMask en la siguiente muestra de código para actualizar el TTL de un recurso. Puedes usar un parámetro de consulta para actualizar solo el campo TTL. updateMask funciona de la siguiente manera:

  • Si se especifica, solo se actualizan los campos en updateMask.
  • Si el valor de la máscara de actualización es *, la solicitud actualiza todos los campos.

  • Si no se especifica la máscara de actualización, solo se actualizan los campos en la URL de la solicitud con un valor proporcionado en el cuerpo de la solicitud.

LÍNEA DE REST Y CMD

En los siguientes ejemplos de código, se modifica el TTL de un recurso con el projects.locations.corpora.assets.patch método.

Cambia un valor de TTL

En este ejemplo, se usa ?updateMask=ttl en la URL de la solicitud y se incluye un nuevo valor ttl.seconds en el cuerpo de la solicitud para actualizar el recurso.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con el LOCATION_ID como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Es tu Google Cloud número de proyecto.
  • LOCATION_ID: Es la región en la que usas Agent Platform Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: Es el ID de tu recurso de destino.
  • ?updateMask=fieldToUpdate: Es uno de los campos disponibles a los que puedes aplicar un updateMask a. Campos disponibles:
    • Tiempo de actividad (TTL): ?updateMask=ttl
    • Actualizar todos los campos: ?updateMask=*

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Quita un valor de TTL

En este ejemplo, se usa ?updateMask=ttl en la URL de la solicitud y se incluye un cuerpo de solicitud vacío para borrar el valor de TTL del recurso.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • REGIONALIZED_ENDPOINT: El extremo puede incluir un prefijo que coincida con el LOCATION_ID como europe-west4-. Obtén más información sobre los extremos regionalizados.
  • PROJECT_NUMBER: Es tu Google Cloud número de proyecto.
  • LOCATION_ID: Es la región en la que usas Agent Platform Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • CORPUS_ID: Es el ID de tu corpus de destino.
  • ASSET_ID: Es el ID de tu recurso de destino.
  • ?updateMask=fieldToUpdate: Es uno de los campos disponibles a los que puedes aplicar un updateMask a. Campos disponibles:
    • Tiempo de actividad (TTL): ?updateMask=ttl
    • Actualizar todos los campos: ?updateMask=*

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud: 

{}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando: 

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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