Connecter et gérer les Intégrations
Les Intégrations connectent Atoms aux outils et services que vous utilisez déjà. Selon le connecteur, Atoms peut utiliser des informations externes tout en vous aidant à créer, à ajouter des capacités à votre app publiée, ou à prendre en charge les deux workflows.
Chaque connecteur prend en charge ses propres actions et autorisations. Vérifiez les capacités et la portée des autorisations affichées pour le connecteur connecté ; un panneau de détails non connecté peut n’afficher que sa description et son contrôle de connexion.
Utilisez le compte et la portée d’autorisations les moins privilégiés pouvant accomplir la tâche. Ne collez pas de mots de passe, de jetons d’accès, de clés privées ou de données sensibles non liées dans un prompt. Lorsqu’un service contient des données de production ou des données client, testez avec un échantillon non sensible et vérifiez la cible exacte avant d’autoriser une écriture.
Les connecteurs et actions que vous voyez peuvent varier selon le compte et la version. Ouvrez le catalogue des connecteurs dans Atoms pour voir ce qui vous est actuellement disponible.
Déterminer ce que la connexion doit faire
Avant de connecter un service, déterminez où vous en avez besoin.
| Objectif | Exemples |
|---|---|
| Donner du contexte à l’Agent pendant que vous créez | Trouver des fichiers, résumer des tâches, examiner des problèmes ou utiliser des données de projet dans un prompt |
| Permettre à l’Agent d’agir dans un autre service | Créer une tâche, mettre à jour un enregistrement, ajouter des données à une feuille de calcul ou créer un événement de calendrier |
| Ajouter un service à l’app publiée | Stocker des données d’application, gérer l’authentification, traiter les paiements ou exécuter un workflow d’app |
Certains connecteurs prennent en charge plusieurs objectifs. Consultez la description du connecteur et les autorisations demandées avant de le connecter.
Connecter une intégration
Ouvrez Settings → Connectors pour utiliser le point d’entrée principal. Vous pouvez également sélectionner Connect your tools to Atoms depuis le tableau de bord.
La connexion ou la déconnexion d’une intégration peut nécessiter un accès de propriétaire de l’espace de travail ou d’administrateur autorisé. Si vous n’êtes ni propriétaire ni administrateur et qu’un contrôle n’est pas disponible, demandez au propriétaire de l’espace de travail ou à un administrateur autorisé.
Depuis le tableau de bord
- Ouvrez le tableau de bord Atoms.
- Sélectionnez Connect your tools to Atoms.
- Choisissez le connecteur que vous souhaitez utiliser. Suivez le contrôle de connexion affiché sur la carte de ce connecteur.
- Utilisez le contrôle affiché pour ce connecteur. S’il ouvre un panneau de détails générique, sélectionnez Connect ; les intégrations spécifiques au fournisseur peuvent ouvrir leur propre flux de configuration ou d’autorisation.
- Connectez-vous au service externe si vous y êtes invité.
- Vérifiez le compte et les autorisations, puis approuvez la connexion.
- Revenez dans Atoms et confirmez que le connecteur apparaît comme connecté. Dans le Chat où vous souhaitez l’utiliser, ouvrez le sélecteur de connecteurs et activez le connecteur pour ce Chat.
Utiliser une intégration connectée
Indiquez à l’Agent quel service utiliser et incluez suffisamment de détails pour identifier l’élément correct. Les détails utiles incluent :
- Le nom du projet, de l’espace de travail, du dépôt, du dossier, du calendrier ou de la feuille de calcul
- Un nom de tâche, un ID de problème, un nom de fichier ou un identifiant d’enregistrement
- Une plage de dates, une date d’échéance, un propriétaire, un statut ou une priorité
- Ce que vous voulez qu’Atoms lise, résume, crée ou mette à jour
Par exemple :
- « Résume les problèmes Linear de haute priorité qui me sont assignés. »
- « Trouve le brief de lancement dans Drive et liste les décisions en suspens. »
- « Ajoute ces leads approuvés à la feuille de calcul de campagne. »
- « Crée un événement de calendrier pour la revue de design mardi prochain à 15 h. »
Atoms ne peut utiliser que les actions prises en charge par le connecteur et les données disponibles pour le compte connecté. Si la capacité ou l’action dont vous avez besoin n’est pas affichée pour ce connecteur, arrêtez-vous et ne supposez pas qu’elle est prise en charge.
Vérifier les modifications externes avant leur exécution
Lorsqu’un connecteur et une action prennent en charge la création ou la mise à jour de données externes, Atoms peut afficher une confirmation avant de l’exécuter.
Vérifiez :
- Le service et le compte connecté
- Le fichier, la feuille de calcul, le calendrier, le projet ou l’enregistrement cible
- Les informations qui seront créées ou modifiées
- Toute date, heure, tout destinataire ou toute autre valeur importante
Si Atoms affiche une confirmation, vérifiez-la et sélectionnez Confirm pour continuer ou annulez pour laisser le service externe inchangé. La disponibilité de l’écriture dépend du connecteur et de l’action ; les connecteurs en lecture seule ne proposent pas d’actions d’écriture.
Après une écriture, vérifiez le résultat dans le service externe avant de réessayer. Si la cible ou les valeurs sont incorrectes, arrêtez le workflow et utilisez les outils d’historique, d’annulation ou de récupération du fournisseur lorsque disponibles. Déconnecter un connecteur empêche toute utilisation future ; cela n’annule pas les modifications déjà effectuées.
Gérer une connexion
Ouvrez le catalogue des connecteurs et sélectionnez un service connecté pour vérifier son statut actuel.
Depuis le panneau de détails du connecteur, vous pourrez peut-être :
- Vérifier quel compte est connecté
- Vérifier les actions prises en charge par le connecteur et la portée des autorisations
- Reconnecter lorsque l’autorisation a expiré
- Actualiser ou modifier l’accès lorsque le service le prend en charge
- Déconnecter le compte d’Atoms
La déconnexion dans Atoms empêche toute utilisation future de la connexion. Certains services peuvent également exiger que vous révoquiez Atoms depuis les paramètres de compte ou de sécurité du service lui-même.
Exemples par cas d’usage
Le tableau ci-dessous est un regroupement éditorial par cas d’usage, et non un ensemble de catégories du catalogue. Utilisez le catalogue consultable pour obtenir la liste actuelle des connecteurs disponibles.
| Catégorie | Usages courants | Exemples |
|---|---|---|
| Développement | Contrôle de source, dépôts, problèmes et workflows de livraison | GitHub, Linear |
| Backend et données | Bases de données, authentification, stockage et données structurées | Supabase |
| Paiements | Checkout, facturation et workflows de paiement | Stripe |
| Gestion du travail | Tâches, projets, propriétaires et dates d’échéance | Asana, Todoist |
| Fichiers et contenu | Rechercher, lire et organiser des fichiers externes | Box, Dropbox |
| Analytique et marketing | Trafic, performances de recherche, campagnes et rapports | Google Analytics 4, Google Search Console, Google Ads |
La disponibilité des connecteurs évolue au fil du temps. Utilisez le catalogue dans Atoms pour obtenir la liste actuelle et ouvrez un connecteur pour vérifier ses capacités exactes.
Guides de configuration
Choisissez le guide pour votre service :
Pour les problèmes de connexion, consultez Intégration troubleshooting.