Applications

L'écran Applications permet d'enregistrer les applications gouvernées du tenant (avec leurs agents, modèles et outils), d'enregistrer et d'activer leurs déploiements, de les suspendre ou de les retirer et d'enregistrer leurs agents externes. Chemin dans le portail : /agents/applications ; le titre de sa page est Registre des applications. Il sert aux propriétaires et développeurs d'applications (tenant_admin, developer, application_owner) et aux responsables sécurité (security_officer) qui suspendent une application.

Ce que montre l'écran

Un tableau Applications avec Actualiser et Nouvelle application :

Colonne	Contenu
Nom	Nom de l'application.
Type	agent_app, assistant, external_agent ou workflow.
Origine	internal ou third_party.
Propriétaire	Propriétaire de l'application.
Risque	low, medium ou high.
Statut	État de l'application, par exemple suspended ou retired.
Mis à jour	Date du dernier changement.

Un clic sur une ligne ouvre un panneau latéral avec l'application et ses déploiements, lus dans l'API. La liste est lue en un seul appel. État vide : Aucune application, « Enregistrez une application pour gouverner ses agents, modèles et outils. »

Sous le tableau, le formulaire Activer un déploiement, « Rend actif, dans son environnement, un déploiement enregistré d'une application. », avec les champs Application et Identifiant de déploiement et une zone Résultat.

Actions

Bouton ou action	Ce qu'il fait	Appel d'API	Rôles
Ouverture de l'écran, Actualiser	Lit les applications.	GET /v1/applications	Membre du tenant
Nouvelle application puis Créer	Formulaire Nom (obligatoire), Type (obligatoire), Origine, Risque, Propriétaire, Projet, Agents, Modèles, Outils, Environnements (listes, par exemple dev, prod).	POST /v1/applications	tenant_admin, developer, application_owner
Clic sur une ligne	Ouvre le panneau de détail avec les déploiements.	GET /v1/applications/{id}	Membre du tenant
Déployer	Boîte de dialogue Version (obligatoire), Environnement (obligatoire), Raison ; enregistre un déploiement et affiche la réponse (son identifiant compris).	POST /v1/applications/{id}/deployments	tenant_admin, developer, application_owner
Suspendre	Boîte de dialogue Raison (obligatoire) ; passe le statut à suspended. Affichée sauf si l'application est suspendue ou retirée.	POST /v1/applications/{id}/status	tenant_admin, security_officer
Retirer	Boîte de dialogue Raison (obligatoire) ; passe le statut à retired. Affichée sauf si elle est retirée.	POST /v1/applications/{id}/status	tenant_admin, security_officer
Enregistrer un agent externe	Boîte de dialogue Nom (obligatoire), Portées ; affiche la réponse. Affichée pour le type external_agent seulement.	POST /v1/applications/{id}/external-agents	tenant_admin
Activer un déploiement, Application, Identifiant de déploiement, puis Exécuter	Confirmation du navigateur « Activer un déploiement ? Cette action sensible est consignée dans le journal d'audit. », puis le déploiement devient l'actif de son environnement.	POST /v1/applications/{app_id}/deployments/{deployment_id}/activate	tenant_admin, developer, application_owner

Rôles

D'après services/control-plane/src/eai/domains/applications/routes.py : chaque route exige un principal rattaché à un tenant ; créer, déployer et activer exigent tenant_admin, developer ou application_owner (WRITE_ROLES de services/control-plane/src/eai/domains/agents/kit.py) ; changer le statut exige tenant_admin ou security_officer ; enregistrer un agent externe exige tenant_admin. platform_admin passe chaque contrôle. Le portail affiche les actions de ligne à tout utilisateur ; le serveur décide.

Tâches courantes

Enregistrer et déployer une application

1. L'enregistrer. Bouton Nouvelle application : Nom claims-assistant, Type assistant, Risque medium, les Agents, Modèles et Outils qu'elle utilise, Environnements dev, prod. Puis Créer. Résultat attendu : le message Créé et la nouvelle ligne. En cas d'échec : forbidden si votre rôle n'est pas un rôle d'écriture.
2. Enregistrer un déploiement. Menu de la ligne > Déployer : Version 1.0.0, Environnement prod, Raison. Résultat attendu : la réponse dans un panneau latéral, avec l'identifiant du déploiement. En cas d'échec : application_suspended si l'application est suspendue.
3. L'activer. Dans Activer un déploiement, collez l'identifiant de l'application dans Application et l'identifiant du déploiement dans Identifiant de déploiement, puis Exécuter et confirmez. Résultat attendu : le résultat JSON du déploiement activé. En cas d'échec : application_deployment_not_found (HTTP 404) si les identifiants ne correspondent pas.

Suspendre une application pendant un incident

1. Suspendre. Menu de la ligne > Suspendre, saisissez la Raison, envoyez. Résultat attendu : le statut suspended. En cas d'échec : forbidden si vous n'êtes ni tenant_admin ni security_officer.

Dépannage

Symptôme	Cause	Correction
forbidden (HTTP 403) avec required_roles	L'action exige un autre rôle (voir la section Rôles).	Adressez-vous à un tenant_admin ou au propriétaire de l'application.
application_not_found (HTTP 404)	L'identifiant d'application est inconnu dans le tenant.	Copiez l'identifiant depuis le panneau de détail.
application_deployment_not_found (HTTP 404)	Le déploiement n'appartient pas à cette application.	Copiez l'identifiant de déploiement renvoyé par Déployer.
application_suspended (HTTP 409 ou 403)	L'application est suspendue.	Levez la suspension avant de déployer ou de l'appeler.
Enregistrer un agent externe manque	Le type n'est pas external_agent.	Créez une application de type external_agent.
tenant_required (HTTP 403)	La session n'agit pas dans un tenant.	Connectez-vous avec un compte du tenant.

Pages liées

• Développement d'agents
• Catalogue des packs
• Pipeline de changement
• Registre