Crea y actualiza un almacén de videos de transmisión

Un almacén de Vision es un componente que puedes agregar a tu app para almacenar la salida del modelo y los datos de transmisión.

Crea un almacén de videos en streaming

Para conectar otros nodos de componentes de tu gráfico de la app a un almacén, primero debes crear un almacén de videos de transmisión.

Console

  1. Abre la pestaña Warehouses del panel de Vision de Gemini Enterprise Agent Platform.

    Ir a la pestaña Almacenes

  2. Selecciona Crear.

  3. Agrega un nombre para el almacén y elige un período de tiempo de actividad (TTL) para los activos almacenados en él. Estos valores se pueden modificar más adelante.

    Después de crear un almacén, puedes agregar el almacén a un gráfico de aplicación.

LÍNEA DE REST Y CMD

Crea un nuevo recurso corpus en el proyecto determinado con la opción de especificar el nombre visible, la descripción y el TTL de corpus.

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: Tu Google Cloud número de proyecto.
  • LOCATION_ID: La región en la que usas Agent Platform Vision. Por ejemplo: us-central1, europe-west4. Consulta las regiones disponibles.
  • DISPLAY_NAME: Es el nombre visible del almacén.
  • WAREHOUSE_DESCRIPTION: Es la descripción del almacén (corpus).
  • TIME_TO_LIVE: Es la cantidad de tiempo de actividad (TTL) para todos los activos de un corpus o el TTL de un activo específico. Por ejemplo, para un corpus con recursos que tienen 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

Cuerpo JSON de la solicitud:

{
  "display_name": "DISPLAY_NAME",
  "description": "WAREHOUSE_DESCRIPTION",
  "type": "STREAM_VIDEO",
  "default_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"

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

Actualiza un almacén de videos de transmisión

Actualiza un corpus existente en el proyecto determinado con la opción de actualizar el nombre visible, la descripción, el TTL predeterminado o todos los campos disponibles.

LÍNEA DE REST Y CMD

Actualiza un recurso corpus existente en el proyecto determinado. En este ejemplo, se muestra cómo actualizar el nombre visible de corpus, pero también puedes actualizar la descripción, el TTL o todos los campos a la vez con el mismo formato de URL y el cuerpo de la solicitud actualizado.

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: Tu Google Cloud número de proyecto.
  • LOCATION_ID: 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 del corpus de destino.
  • ?updateMask=fieldToUpdate: Uno de los campos disponibles a los que puedes aplicar un updateMask. Especifica el valor del nuevo campo correspondiente en el cuerpo de la solicitud. Este nuevo valor reemplaza el valor de campo existente. Campos disponibles:
    • Nombre visible: ?updateMask=display_name
    • Descripción: ?updateMask=description
    • Tiempo de actividad (TTL) predeterminado: ?updateMask=default_ttl
    • Actualiza todos los campos: ?updateMask=*
  • UPDATED_FIELD_VALUE: Es un valor nuevo para el campo especificado. En este ejemplo, se muestra un nuevo nombre visible proporcionado por el usuario para el recurso del almacén.

Método HTTP y URL: 

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

Cuerpo JSON de la solicitud:

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

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?update_mask=display_name"

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?update_mask=display_name" | Select-Object -Expand Content

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

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