Connecter une intégration tierce

Les intégrations portent les identifiants dont votre projet a besoin pour parler à des services externes : un prestataire de paiement, une API de LLM, un CRM, un outil de suivi de tickets. Chaque intégration appartient à un projet et stocke ses secrets par environnement, pour que développement, staging et production gardent chacun leurs propres clés.

Où vivent les intégrations

Ouvrez le projet, puis Integrations. La liste affiche une carte par service connecté, avec le compte au-dessus et Add en haut à droite.

Sous la liste, Add another integration met les services courants à un clic, à côté de Browse all et d'un raccourci pour en décrire une avec l'IA. Servez-vous-en quand vous savez déjà quel service brancher ensuite.

Trois façons d'en ajouter une

Cliquez sur Add, ou sur Add integration depuis l'état vide. L'écran s'ouvre sur une seule question, How would you like to add an integration ?, avec trois réponses.

• Browse catalog : cherchez dans la grille, choisissez une tuile. Chaque tuile indique combien de secrets elle demande.
• Describe with AI : décrivez ce qu'il vous faut, affinez la proposition, recommencez si le résultat ne convient pas.
• Create from scratch : renseignez un nom, une description facultative, la documentation et les définitions de clés secrètes.

Les trois chemins arrivent sur la même dernière étape.

Configurer les secrets

Sous Secrets by environment, les trois environnements ont leur couleur : bleu pour Development, ambre pour Staging, émeraude pour Production. Chacun a son interrupteur, et celui qui est éteint le dit au lieu d'afficher des champs. Vous pouvez activer la production sans activer le staging.

Chaque secret porte sa propre description et un dépliant How to obtain qui indique où récupérer la valeur. Add custom secret ajoute une clé que le catalogue ne listait pas, et Additional documentation accueille les notes que l'agent doit lire, en Markdown.

Create Integration enregistre l'ensemble.

Gérer une intégration existante

De retour sur la liste, cliquez sur une carte pour l'ouvrir. À partir de là :

• Des interrupteurs d'activation par environnement.
• Un formulaire de secrets séparé par environnement, avec son propre bouton d'enregistrement.
• Une vue Documentation, éditable si vous en avez le droit.
• Une action de suppression, avec confirmation.