---
title: Connecter et contrôler les Apps Agent
description: 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

1. Ouvrez **Projet → Apps** et faites défiler jusqu'à **Apps Agent**.
2. Recherchez l'application ou choisissez une catégorie.
3. Sélectionnez la carte d'application pour ouvrir **Détails de l'application**.
4. Lisez sa description et inspectez chaque outil disponible.
5. Désactivez tout outil que Runner ne doit pas utiliser dans ce projet.
6. Entrez les identifiants du fournisseur requis ou sélectionnez **Connecter et autoriser**.
7. Complétez l'étape du fournisseur. Si votre navigateur bloque la fenêtre d'autorisation, autorisez la
   fenêtre contextuelle pour Runner et recommencez.
8. Retournez à la boîte de dialogue et confirmez qu'elle indique **Connecté**.
9. 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

1. Sélectionnez **Gérer** sur l'application connectée.
2. Trouvez l'outil que vous souhaitez modifier.
3. Activez ou désactivez son commutateur.
4. Attendez **Outil activé** ou **Outil désactivé**.
5. 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.

## Guides connexes

- [Aperçu des applications et intégrations](../apps-and-integrations)
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Dépanner une connexion d'application](./troubleshooting)