Secrets et variables d'environnement sans coller vos clés dans le chat

La plupart des vraies applications ont besoin d'au moins un secret : la clé d'un fournisseur de paiement, celle d'un service courriel, ou une clé pour une API d'IA. Dans Mythex, vous n'avez pas à coller ces clés dans une consigne. Lorsque l'agent en a besoin, il affiche une carte de demande de secrets dans le chat ; vous saisissez la valeur dans la carte, et elle est enregistrée comme secret du projet que votre application peut lire, sans que la clé se retrouve dans la conversation.

Ce que cela fait

Chaque projet Mythex peut stocker des variables d'environnement : des valeurs nommées, comme STRIPE_SECRET_KEY, que votre application lit à l'exécution au lieu de les voir écrites dans le code. Les secrets sont des variables d'environnement dont la valeur doit rester privée.

Les mêmes valeurs sont disponibles à deux endroits :

• Le bac à sable, où l'agent construit et exécute votre application pendant que vous travaillez.
• Vos déploiements publiés, que les visiteurs utilisent.

Il existe trois façons de les ajouter :

1. La carte de demande de secrets, que l'agent affiche dans le chat lorsqu'il a besoin d'une clé pour terminer une tâche.
2. Paramètres du projet → Secrets, où vous pouvez ajouter ou modifier des valeurs en tout temps.
3. /secrets dans le chat, pour ajouter ou mettre à jour des secrets sur demande.

Pourquoi c'est utile

La façon la plus évidente de donner une clé à un agent d'IA est de la coller dans votre message. Ça fonctionne, mais la clé fait alors partie de l'historique de votre chat, en texte clair, à côté de tout le reste de ce que vous avez écrit.

La carte de secrets garde la valeur hors de la transcription. Vous la saisissez dans les champs de la carte, et non dans la zone de message, puis elle est enregistrée comme secret du projet. L'agent poursuit son travail avec la clé disponible dans le bac à sable.

Garder les clés dans les paramètres du projet plutôt que dans le code présente d'autres avantages :

• Les clés restent hors du contrôle de version. Votre code désigne une clé par son nom ; la valeur est conservée dans les paramètres du projet.
• L'agent et votre application en cours d'exécution voient la même configuration. Il n'y a pas de copie qui se désynchronise.
• Vous pouvez changer une clé sans réécrire le code. Modifiez la valeur dans les paramètres ; le code la lit toujours par son nom.

Si les variables d'environnement vous sont nouvelles, notre guide sur ce que sont les variables d'environnement et les secrets explique l'idée depuis le début.

Comment utiliser la carte de secrets

1. Demandez la fonctionnalité — par exemple, « envoie un courriel de bienvenue lorsqu'une personne s'inscrit ».
2. Lorsque l'agent a besoin d'une clé, une carte de demande de secrets apparaît dans le chat et indique la valeur requise.
3. Saisissez la valeur dans les champs de la carte, et non dans la zone de message.
4. Confirmez. La valeur est enregistrée comme secret du projet.
5. L'agent poursuit, avec la clé disponible dans le bac à sable.

Comment ajouter vous-même des secrets

1. Ouvrez les paramètres du projet, puis Secrets.
2. Ajoutez des clés comme STRIPE_SECRET_KEY, OPENAI_API_KEY, ou les identifiants de votre propre service.
3. Demandez à l'agent de les lire de la manière standard pour votre cadriciel — par exemple depuis process.env dans une application Node.
4. Republiez si une application publiée a besoin des nouvelles valeurs.

Vous pouvez aussi taper /secrets dans le chat pour les ajouter ou les mettre à jour.

Modifier un secret sur une application publiée

Une application publiée prend en compte les secrets au moment de la publication. Après avoir ajouté ou modifié un secret, publiez à nouveau pour que le déploiement en ligne reçoive la nouvelle valeur. Jusque-là, les visiteurs utilisent toujours l'application avec l'ancienne configuration.

Conseils de sécurité

• Ne versionnez jamais de secrets dans le dépôt. Gardez-les dans les paramètres du projet.
• Privilégiez les clés réservées au serveur pour les opérations sensibles. Une clé qui peut débiter des cartes ou envoyer des courriels doit se trouver dans le code qui s'exécute sur le serveur, jamais dans ce que le navigateur d'un visiteur télécharge.
• Si une clé apparaît dans l'historique du chat, révoquez-la. Créez une nouvelle clé chez le fournisseur, révoquez l'ancienne et mettez à jour la valeur dans les paramètres du projet. Considérez toute clé collée dans un chat comme exposée.

Limites

• La carte n'aide que si vous l'utilisez. Si vous collez quand même une clé dans la zone de message, elle se retrouve dans la transcription. Révoquez-la chez le fournisseur et mettez à jour la valeur enregistrée.
• Les applications publiées doivent être republiées pour prendre en compte les secrets nouveaux ou modifiés.
• Bien stocker une clé ne rend pas toutes ses utilisations sûres. L'endroit où la clé est utilisée compte toujours — gardez les clés privilégiées du côté serveur de votre application.

Pour en savoir plus sur la sécurisation d'une application avant de la partager, consultez notre liste de contrôle de sécurité pour les applications construites avec l'IA.

La documentation contient les détails : Variables d'environnement et secrets et Secrets dans le chat.