Connecter et contrôler les Apps Agent

Trouvez une application Agent, choisissez ses outils autorisés, connectez-la et gérez l'accès.

Les Apps Agent permettent à l'Agent Runner d'utiliser un service externe tout en travaillant sur votre projet. Vous pouvez inspecter les outils de l'application et désactiver les outils que vous ne voulez pas que l'Agent utilise.

Avant de commencer

Chemin d'accès : Projet → Apps → Apps Agent

Les Apps Agent sont conditionnelles. La section peut être masquée, et une application individuelle peut être indisponible, ou le catalogue peut ne pas charger. La disponibilité peut varier selon l'espace de travail, le projet, le fournisseur et l'accès au produit par étapes.

Vous avez besoin :

d'un accès au projet ;
d'un compte ou d'un identifiant accepté par le fournisseur sélectionné ; et
d'une permission pour laisser Runner utiliser les outils que vous laissez activés.

Examinez chaque outil avant de vous connecter. L'accès aux outils s'applique au projet actuel et peut permettre à l'Agent de lire ou de modifier les données du service externe.

La connexion du compte externe appartient à votre compte Runner connecté, tandis que les commutateurs d'outils sont enregistrés pour le projet actuel. La déconnexion peut donc supprimer la connexion utilisée par d'autres projets même si leurs choix d'outils sont séparés.

Trouver et inspecter une application

Contrôle ou état	Pourquoi c'est utile	Que se passe-t-il ensuite
Rechercher des applications	Filtre simultanément les Apps de boutique et les Apps Agent.	Le catalogue affiche les noms et descriptions correspondants.
Sélecteur de catégorie	Réduit le catalogue des Apps Agent.	Choisissez Tous pour supprimer le filtre de catégorie.
Précédent et Suivant	Se déplace dans un long catalogue.	Runner affiche la page précédente ou suivante des applications correspondantes.
Carte d'application	Affiche le nom de l'application, la description et l'état de la connexion.	La sélectionner ouvre Détails de l'application.
Aucune application trouvée	Indique que les filtres actuels n'ont pas de correspondance.	Effacer la recherche réinitialise la recherche et la catégorie.
Espaces réservés de chargement	Indique que Runner récupère le catalogue.	Attendez les cartes avant de choisir une application.

Contrôles des détails de l'application

Contrôle ou état	Pourquoi c'est utile	Que se passe-t-il ensuite
Description de l'application et catégorie	Aide à confirmer que vous avez ouvert le service prévu.	Aucun accès externe n'est accordé en visualisant les détails.
Commutateur d'outil	Limite ce que Runner peut demander à l'application connectée de faire.	Avant de vous connecter, Runner enregistre vos choix avec la connexion. Après la connexion, une modification est enregistrée immédiatement.
Précédent et Suivant dans la liste des outils	Examine les applications avec de nombreux outils.	Se déplace dans les outils sans fermer la boîte de dialogue.
Champs d'identifiants requis	Prend en charge les applications qui n'utilisent pas l'autorisation du navigateur.	Connecter reste indisponible jusqu'à ce que les champs requis soient remplis. Les champs de type secret sont masqués.
Connecter	Soumet les identifiants du fournisseur lorsque cette stratégie est requise.	Runner tente la connexion avec votre accès aux outils choisis.
Connecter et autoriser	Démarre l'autorisation du fournisseur.	Runner ouvre une fenêtre d'autorisation.
Connexion en cours...	Indique que l'autorisation est en cours.	L'action reste indisponible jusqu'à ce que Runner reçoive un résultat.
Connecté	Confirme que Runner reconnaît le compte.	Fermez la boîte de dialogue ou gérez l'accès aux outils.
Gérer	Rouvre une application connectée.	Examinez et modifiez ses outils activés ou déconnectez-la.
Déconnecter	Démarre la suppression.	Runner demande Êtes-vous sûr de vouloir vous déconnecter ?
Annuler ou Confirmer	Résout l'avertissement de déconnexion.	Annuler maintient l'accès ; Confirmer supprime la connexion de l'application Agent au niveau du compte Runner. Les paramètres d'outils du projet sont séparés.

Connecter une application Agent

Ouvrez Projet → Apps et faites défiler jusqu'à Apps Agent.
Recherchez l'application ou choisissez une catégorie.
Sélectionnez la carte d'application pour ouvrir Détails de l'application.
Lisez sa description et inspectez chaque outil disponible.
Désactivez tout outil que Runner ne doit pas utiliser dans ce projet.
Entrez les identifiants du fournisseur requis ou sélectionnez Connecter et autoriser.
Complétez l'étape du fournisseur. Si votre navigateur bloque la fenêtre d'autorisation, autorisez la fenêtre contextuelle pour Runner et recommencez.
Retournez à la boîte de dialogue et confirmez qu'elle indique Connecté.
Sélectionnez Gérer plus tard pour examiner l'accès aux outils ou déconnecter l'application.

La boîte de dialogue de connexion indique que les identifiants du fournisseur sont envoyés via le service de connexion et ne sont pas stockés par Runner. Vous devriez quand même traiter chaque identifiant comme un secret et l'entrer uniquement dans les champs d'identifiants de l'application.

Modifier l'accès aux outils

Sélectionnez Gérer sur l'application connectée.
Trouvez l'outil que vous souhaitez modifier.
Activez ou désactivez son commutateur.
Attendez Outil activé ou Outil désactivé.
Si Runner affiche Échec de la mise à jour de l'outil, laissez la boîte de dialogue ouverte, vérifiez l'état actuel du commutateur après son actualisation, et réessayez uniquement si l'état enregistré est clair.

Désactiver un outil limite l'utilisation de cet outil par Runner. Cela ne supprime pas les données précédemment créées dans le service externe.

Réparer ou déconnecter une connexion

Si le catalogue n'affiche plus une connexion utilisable, ouvrez l'application et commencez Connecter ou Connecter et autoriser à nouveau, puis confirmez Connecté.

Pour supprimer l'accès, sélectionnez Gérer → Déconnecter, examinez la confirmation et sélectionnez Confirmer. Cela supprime la connexion de l'application Agent du compte connecté, pas seulement l'accès aux outils du projet actuel. Si la déconnexion échoue, Runner maintient l'état connecté ; ne supposez pas que le compte externe a été supprimé.

Si les Apps Agent sont manquantes

La fonctionnalité peut ne pas être activée pour l'espace de travail.
Effacez la recherche et définissez la catégorie sur Tous.
Actualisez les Apps si le catalogue ne quitte jamais son état de chargement.
Une application individuelle peut signaler qu'elle n'est pas encore disponible pour la connexion.
Si la liste des outils échoue, sélectionnez Réessayer dans Détails de l'application.
Aucune entrée de catalogue spécifique ne doit être promise jusqu'à ce qu'elle apparaisse dans l'espace de travail actuel.