Implementa y anula la implementación de una aplicación

Después de crear una app, debes implementarla para poder transmitir y analizar datos.

Implementar una aplicación

Después de compilar una aplicación de extremo a extremo con todos los componentes necesarios, debes implementarla para comenzar a usarla.

Console

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

   Ir a la pestaña Aplicaciones

2. Selecciona Ver app junto al nombre de tu aplicación en la lista.

3. En la página del compilador de gráficos de aplicaciones, haz clic en el botón Implementar.

4. En el menú Implementar aplicación que se abre, selecciona cualquier opción y haz clic en Implementar.

   Nota: Para obtener más información sobre la opción Habilitar transmisión de salida, consulta Habilita la salida de transmisión en vivo. Para obtener más información sobre la opción Habilitar supervisión para esta aplicación, consulta Habilita y usa la supervisión de aplicaciones.

   Una vez que se complete la implementación, aparecerán marcas de verificación verdes junto a los nodos.

LÍNEA DE REST Y CMD

Para implementar tu aplicación para su uso, envía una solicitud POST con el projects.locations.applications.deploy.

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

• PROJECT: Tu Google Cloud ID del proyecto o 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.
• APPLICATION_ID: El ID de tu aplicación de destino.

Método HTTP y URL:

POST https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deploy

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deploy"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deploy" | Select-Object -Expand Content

Si la solicitud se realiza correctamente, se inicia una operación de larga duración y se muestra un objeto JSON con el ID de la operación.

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "YYYY-MM-DDTHH:MM:SS.454506987Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Obtén el estado de la operación

Usa el ID de operación en la respuesta para obtener el estado de la solicitud de implementación.

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.
• OPERATION_ID: El ID de operación que se muestra cuando inicias una operación de larga duración. Por ejemplo:
  • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

Método HTTP y URL:

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" | Select-Object -Expand Content

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

Respuesta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T17:53:14.454506987Z",
    "endTime": "2023-01-12T17:53:22.979720545Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "statusMessage": "Instance Deployment Pending....",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Application",
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "createTime": "2023-01-06T21:16:26.465867295Z",
    "updateTime": "2023-01-12T17:53:14.458441937Z",
    "displayName": "APPLICATION_NAME",
    "applicationConfigs": {
      "nodes": [
        {
          "name": "builtin-input-stream",
          "displayName": "Streams",
          "nodeConfig": {
            "videoStreamInputConfig": {}
          },
          "processor": "builtin:stream-input",
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-general-object-detector",
          "displayName": "Object detector",
          "nodeConfig": {
            "generalObjectDetectionConfig": {}
          },
          "processor": "builtin:general-object-detector",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            }
          ],
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-media-warehouse",
          "displayName": "Vision AI Warehouse",
          "nodeConfig": {
            "mediaWarehouseConfig": {
              "corpus": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID"
            }
          },
          "processor": "builtin:media-warehouse",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            },
            {
              "parentNode": "builtin-general-object-detector"
            }
          ],
          "outputAllOutputChannelsToStream": false
        }
      ]
    },
    "runtimeInfo": {
      "deployTime": "2023-01-12T17:53:22.887918Z",
      "globalOutputResources": [
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-resource-name",
          "key": "stream-resource-name"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-display-name",
          "key": "stream-display-name"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-resource-id",
          "key": "stream-resource-id"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/general-object-detection",
          "producerNode": "builtin-general-object-detector",
          "key": "general_object_detection_data_schema_id"
        }
      ]
    },
    "state": "DEPLOYED",
    "deploymentEnvironment": "DEPLOYMENT_ENVIRONMENT_CLOUD"
  }
}

Anular la implementación de una aplicación

Para dejar de usar una app, debes anular la implementación de la aplicación.

Console

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

   Ir a la pestaña Aplicaciones

2. Selecciona Ver app junto al nombre de tu aplicación en la lista.

3. En la página del compilador de gráficos de aplicaciones, haz clic en el botón Desactivar.

LÍNEA DE REST Y CMD

Para anular la implementación de tu aplicación, envía una solicitud POST con el projects.locations.applications.undeploy.

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

• PROJECT: Tu Google Cloud ID del proyecto o 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.
• APPLICATION_ID: El ID de tu aplicación de destino.

Método HTTP y URL:

POST https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:undeploy

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:undeploy"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:undeploy" | Select-Object -Expand Content

Si la solicitud se realiza correctamente, se inicia una operación de larga duración y se muestra un objeto JSON con el ID de la operación.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T18:14:48.260296926Z",
    "target": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Obtén el estado de la operación

Usa el ID de operación en la respuesta para obtener el estado de la solicitud de anulación de implementación.

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.
• OPERATION_ID: El ID de operación que se muestra cuando inicias una operación de larga duración. Por ejemplo:
  • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

Método HTTP y URL:

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" | Select-Object -Expand Content

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

Respuesta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T18:14:48.260296926Z",
    "endTime": "2023-01-12T18:14:58.059563424Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "statusMessage": "Instance Undeployment Pending....",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Application",
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "createTime": "2023-01-06T21:16:26.465867295Z",
    "updateTime": "2023-01-12T18:14:48.264089325Z",
    "displayName": "APPLICATION_NAME",
    "applicationConfigs": {
      "nodes": [
        {
          "name": "builtin-input-stream",
          "displayName": "Streams",
          "nodeConfig": {
            "videoStreamInputConfig": {}
          },
          "processor": "builtin:stream-input",
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-general-object-detector",
          "displayName": "Object detector",
          "nodeConfig": {
            "generalObjectDetectionConfig": {}
          },
          "processor": "builtin:general-object-detector",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            }
          ],
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-media-warehouse",
          "displayName": "Vision AI Warehouse",
          "nodeConfig": {
            "mediaWarehouseConfig": {
              "corpus": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID"
            }
          },
          "processor": "builtin:media-warehouse",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            },
            {
              "parentNode": "builtin-general-object-detector"
            }
          ],
          "outputAllOutputChannelsToStream": false
        }
      ]
    },
    "state": "CREATED",
    "deploymentEnvironment": "DEPLOYMENT_ENVIRONMENT_CLOUD"
  }
}

¿Qué sigue?

• Lee las instrucciones para comenzar la transferencia de datos desde el flujo de entrada de una app en Crea y administra flujos.
• Obtén información para enumerar apps y ver las instancias de una app implementada en Administra aplicaciones.
• Obtén información para leer datos de entrada de la app desde un flujo de transferencia o datos de resultado del modelo analizado en Lee datos de flujo.