Une fois que vous avez créé et déployé des applications, vous pouvez gérer ces instances d'application à l'aide de la Google Cloud console ou de la ligne de commande.
Afficher les instances d'application déployées et la sortie
Vous pouvez afficher les instances d'application et la sortie à l'aide de la Google Cloud console ou ligne de commande. Vous pouvez ensuite utiliser ces informations pour lire les flux de sortie du modèle et obtenir des éléments.
UI Web
Affichez les instances et la sortie d'une application dans la Google Cloud console.
Ouvrez l'onglet Applications du tableau de bord Gemini Enterprise Agent Platform Vision.
Sélectionnez le nom de l'application que vous souhaitez afficher. La page d'informations sur l'application s'affiche.
La page d'informations sur l'application affiche un tableau contenant les ressources de l'application. Ce tableau répertorie toutes les instances en cours d'exécution de l'application. Chaque flux d'entrée de l'application possède sa propre instance. Chaque instance possède ses propres ressources d'entrée et de sortie listées en dessous.
Pour inspecter les ressources de flux ou d'élément d'entrepôt dans le tableau des instances, cliquez sur l'ID d'entrée ou de sortie, ou sélectionnez le chemin d'accès.
Si vous cliquez sur la ressource flux, vous êtes redirigé vers la page d'informations sur le flux, où vous pouvez inspecter les informations détaillées de ce flux.
Pour apprendre à lire le flux de sortie d'un modèle à l'aide de la ligne de commande, consultez Créer et gérer des flux.
Si vous cliquez sur la ressource asset d'entrepôt , vous accédez à la page d'informations sur l'asset d'entrepôt Vision.
Pour obtenir un asset Vision Warehouse, consultez Gérer les ressources à l'aide de l'API Vision Warehouse.
REST
Pour répertorier les instances d'application, envoyez une requête GET à l'aide de la projects.locations.applications.instances.list.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT : ID de votre projet ou numéro de projet. Google Cloud
- LOCATION_ID : région dans laquelle vous utilisez Agent Platform Vision. Par exemple :
us-central1,europe-west4. Consultez les régions disponibles. - APPLICATION_ID : ID de votre application cible.
Méthode HTTP et URL :
GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances"
PowerShell
Exécutez la commande suivante :
$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/applications/APPLICATION_ID/instances" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"instances": [
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances/INSTANCE_ID",
"createTime": "2022-03-01T20:05:45.863836157Z",
"inputResources": [
{
"inputResource": "input-stream",
"consumerNode": "builtin-input-stream"
}
],
"outputResources": [
{
"outputResource": "sample-resource-1",
"producerNode": "builtin-occupancy-count",
"isTemporary": true
},
{
"outputResource": "sample-resource-2",
"producerNode": "builtin-input-stream"
},
{
"outputResource": "sample-resource-3",
"producerNode": "builtin-input-stream",
"isTemporary": true
},
{
"outputResource": "sample-resource-4",
"producerNode": "builtin-input-stream",
"isTemporary": true
}
]
}
]
}
Supprimer une instance d'application
REST
Pour supprimer des instances d'application, envoyez une requête POST à l'aide de la projects.locations.applications.deleteApplicationInstances.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_NUMBER : Votre Google Cloud numéro de projet.
- LOCATION_ID : région dans laquelle vous utilisez Agent Platform Vision. Par exemple :
us-central1,europe-west4. Consultez les régions disponibles. - APPLICATION_ID : ID de votre application cible.
Méthode HTTP et URL :
POST https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances
Corps JSON de la requête :
{
"instanceIds": [
"INSTANCE_ID1",
"INSTANCE_ID2",
[...]
]
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$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://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
"createTime": "[...]",
"Target": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID"
"Verb": "update"
"apiVersion": "v1"
},
"done": false
}
Gérer des applications à grande échelle
Les méthodes de déploiement et d'annulation du déploiement sont valides pour les applications comportant moins de 20 instances. Si votre application comporte plus de 20 instances, vous devez créer et supprimer des instances de manière incrémentielle avec l'API. Le workflow recommandé est le suivant :
- Créez votre application.
- Ajoutez entre 1 et 20 instances expérimentales.
- Déployez votre application.
- Vérifiez que votre application fonctionne comme prévu.
- Utilisez la méthode
createApplicationInstancespour ajouter progressivement d'autres entrées à l'application déployée. - Autorisez l'application à s'exécuter.
- Utilisez la méthode
deleteApplicationInstancespour supprimer progressivement des entrées des applications déployées. - Annulez le déploiement de l'application.