Implantar e remover a implantação de um aplicativo

Depois de criar um app, você precisa implantá-lo para poder transmitir e analisar dados.

Implantar um aplicativo

Depois de criar um aplicativo completo com todos os componentes necessários, você precisa implantá-lo para começar a usar.

Console

  1. Abra a guia Aplicativos do painel do Gemini Enterprise Agent Platform Vision.

    Acessar a guia "Aplicativos"

  2. Selecione Ver app ao lado do nome do aplicativo na lista.

  3. Na página do criador de gráficos de aplicativos, clique no botão Implantar.

  4. No menu Implantar aplicativo que é aberto, selecione as opções e clique em Implantar.

    Após a conclusão da implantação, haverá marcas de seleção verdes ao lado dos nós.

REST e LINHA DE CMD

Para implantar seu aplicativo para uso, envie uma solicitação POST usando o projects.locations.applications.deploy.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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
Se for bem-sucedida, a solicitação inicia uma operação de longa duração e retorna um objeto JSON com o ID da operação.
{
  "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
}

Receber status da operação

Use o ID da operação na resposta para receber o status da solicitação de implantação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • REGIONALIZED_ENDPOINT: o endpoint pode incluir um prefixo que corresponde ao LOCATION_ID, como europe-west4-. Saiba mais sobre endpoints regionalizados.
  • PROJECT_NUMBER: o Google Cloud número do projeto.
  • LOCATION_ID: a região em que você está usando o Agent Platform Vision. Por exemplo: us-central1, europe-west4. Consulte as regiões disponíveis.
  • OPERATION_ID: o ID da operação retornado quando você inicia uma operação de longa duração. Por exemplo:
    • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

Desimplantar um aplicativo

Para parar de usar um app, você precisa desimplantar o aplicativo.

Console

  1. Abra a guia Aplicativos do painel do Gemini Enterprise Agent Platform Vision.

    Acessar a guia "Aplicativos"

  2. Selecione Ver app ao lado do nome do aplicativo na lista.

  3. Na página do criador de gráficos de aplicativos, clique no botão Desativar.

REST e LINHA DE CMD

Para cancelar a implantação do aplicativo, envie uma solicitação POST usando o projects.locations.applications.undeploy.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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
Se for bem-sucedida, a solicitação inicia uma operação de longa duração e retorna um objeto JSON com o ID da operação.
{
  "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
}

Receber status da operação

Use o ID da operação na resposta para receber o status da solicitação de cancelamento da implantação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • REGIONALIZED_ENDPOINT: o endpoint pode incluir um prefixo que corresponde ao LOCATION_ID, como europe-west4-. Saiba mais sobre endpoints regionalizados.
  • PROJECT_NUMBER: o Google Cloud número do projeto.
  • LOCATION_ID: a região em que você está usando o Agent Platform Vision. Por exemplo: us-central1, europe-west4. Consulte as regiões disponíveis.
  • OPERATION_ID: o ID da operação retornado quando você inicia uma operação de longa duração. Por exemplo:
    • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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

Você receberá uma resposta JSON semelhante a esta:

A seguir

  • Leia as instruções sobre como iniciar a ingestão de dados do fluxo de entrada de um app em Criar e gerenciar fluxos.
  • Aprenda a listar apps e visualizar as instâncias de um app implantado em Gerenciar aplicativos.
  • Aprenda a ler dados de entrada de apps de um fluxo de ingestão ou dados de saída de modelos analisados em Ler dados de fluxo.