Paramètres et administration du projet
Paramètres et administration du projet
Modifier le nom, la langue, le pré-prompt et la clé OpenAI d’un projet
Gérez et sécurisez les paramètres de vos projets — changements rapides, bonnes pratiques pour les prompts et la gestion des clés.
Introduction Ce guide explique comment ouvrir et modifier les paramètres d’un projet : nom, langue, prompt utilisateur (pré-prompt) et clé OpenAI. Vous trouverez des procédures pas à pas pour chaque action, des conseils de sécurité, des recommandations pour rédiger des prompts efficaces, ainsi que les précautions à prendre avant de supprimer ou publier des paramètres uniques (ex. domaine personnalisé).
Pré-requis
La création et la modification d’un projet nécessitent d’être connecté·e et authentifié·e. Assurez-vous d’avoir les droits nécessaires sur le projet avant d’effectuer des changements.
Ouvrir les paramètres d’un projet
Étape 1
Accédez à la liste de vos projets depuis le tableau de bord et cliquez sur le projet concerné pour ouvrir sa page principale.
Étape 2
Sur la page du projet, repérez le menu d’actions (généralement une icône de menu ou de paramètres dans l’en-tête du projet) et ouvrez-le.
Étape 3
Dans le menu, choisissez l’option « Paramètres » ou les sous-éléments dédiés : « Nom du projet », « Langue », « Pré-prompt » ou « Clé OpenAI ». Chaque option ouvre une boîte de dialogue/modale dédiée.
Étape 4
Si vous ne voyez pas les options, vérifiez vos permissions de membre du projet ou contactez l’administrateur du projet.
Astuce rapide
Vous pouvez souvent modifier plusieurs champs depuis la même interface : commencez par changer le nom et la langue, puis vérifiez le pré-prompt avant d’enregistrer.
Modifier le nom et la langue du projet
Étape 1
Ouvrez la modal de modification du projet via le menu « Paramètres ». Le champ « Nom » est généralement en haut : modifiez-le pour refléter clairement l’objectif du projet.
Étape 2
Sélectionnez la langue du projet depuis la liste déroulante. La langue peut influencer le comportement des agents et la génération de contenu. :
Étape 3
Validez les champs obligatoires (le nom est requis). Si un champ doit être unique (ex. domaine personnalisé), assurez-vous qu’il respecte la règle d’unicité avant publication.
Étape 4
Cliquez sur « Enregistrer » ou « Sauvegarder ». Attendez la confirmation visuelle (message de succès ou toast). :
Étape 5
Vérifiez que le nouveau nom et la langue apparaissent partout sur la page du projet (en-tête, onglets, sections liées).
Champ unique — attention
Certains champs (par ex. domaine personnalisé) doivent être uniques et sont validés avant publication. Si vous essayez d’enregistrer un domaine déjà utilisé, l’enregistrement échouera — vérifiez l’unicité avant de publier.
Modifier le pré-prompt (user_prompt) — bonnes pratiques et procédure
Étape 1
Ouvrez la boîte d’édition du pré-prompt depuis le menu du projet (souvent nommée « Pré-prompt » ou « User prompt »). :
Étape 2
Rédigez ou collez votre texte de pré-prompt. Pensez à indiquer :
- le ton souhaité (formel, convivial),
- le rôle de l’assistant (ex. « Tu es un expert technique… »),
- les contraintes (longueur, style),
- les informations de contexte essentielles. :
Étape 3
Limitez la taille si nécessaire : des prompts trop longs peuvent compliquer la maintenance. Conservez une version maîtresse claire et documentée. :
Étape 4
Enregistrez et testez immédiatement en lançant une interaction courte (chat ou exécution d’un agent) pour vérifier l’impact. :
Étape 5
Itérez : ajustez le pré-prompt en fonction des résultats (précision, biais, urgence).
Structurer un pré-prompt efficace
Commencez par une instruction claire, fournissez le contexte essentiel (produit, public cible), donnez des exemples souhaités et ajoutez des contraintes (format de sortie, exclusions). Sauvegardez des versions numérotées pour faciliter les retours en arrière.
Prompt court
- Rapide à écrire.
- Facile à modifier.
- Moins de contrôle fin. :
Prompt détaillé
- Plus précis dans le comportement attendu.
- Permet des sorties cohérentes.
- Plus long à maintenir; testez systématiquement. :
Mettre à jour la clé OpenAI du projet
Étape 1
Ouvrez la modal « Clé OpenAI » depuis le menu du projet. :
Étape 2
Collez la nouvelle clé dans le champ prévu à cet effet. Attention : n’envoyez que la clé pertinente au projet et évitez de coller des clés partagées par erreur. :
Étape 3
Vérifiez la validité de la clé (format, longueur). Si votre plateforme propose un test de connexion, lancez-le pour confirmer. :
Étape 4
Enregistrez. Après enregistrement, effectuez un test simple (ex. conversation courte ou exécution d’un agent) pour vous assurer que la clé fonctionne et que les quotas sont suffisants. :
Étape 5
Surveillez l’usage après mise à jour (consommation et erreurs) afin de détecter toute fuite ou mauvaise configuration. :
Rotation des clés
Planifiez une rotation régulière des clés et conservez un processus de remplacement (clés temporaires, date d’expiration). Documentez qui a accès à quelle clé et pourquoi.
Stockage sécurisé
Ne copiez jamais une clé dans un canal public. Utilisez un gestionnaire de secrets ou des variables d’environnement dans vos intégrations externes.
Attention aux accès partagés
Si une clé OpenAI est compromise ou utilisée par plusieurs projets, elle peut générer des factures inattendues et exposer vos données. Supprimez immédiatement les clés suspectes et remplacez-les.
Enregistrer les modifications et vérifier leur propagation
Étape 1
Après chaque modification, cliquez sur « Enregistrer ». Attendez la confirmation visuelle. :
Étape 2
Rafraîchissez la page du projet si nécessaire pour confirmer que les modifications ont bien été appliquées. :
Étape 3
Exécutez un test qui utilise les paramètres modifiés : exemple — conversation rapide, génération d’un document, démarrage d’un agent ou prévisualisation du site. :
Étape 4
Si le comportement n’est pas conforme, revenez au pré-prompt ou à la clé et corrigez les valeurs puis ré-enregistrez. :
Étape 5
Consultez les logs / retours d’erreur si disponibles pour identifier la cause des problèmes (messages d’authentification, validation, erreurs de format). :
Supprimer un projet — procédure et précautions
Étape 1
Avant suppression, sauvegardez les données essentielles : exportez documents, prompts, configurations et notez les webhooks utilisés. :
Étape 2
Ouvrez l’option de suppression depuis le menu du projet. Lisez attentivement le message de confirmation. :
Étape 3
Confirmez la suppression si vous êtes sûr·e. Certaines plateformes demandent la saisie du nom du projet pour confirmer. :
Étape 4
Après suppression, toutes les ressources indexées (collections de recherche, webhooks, etc.) associées au projet seront supprimées : vérifiez vos dépendances externes avant d’effacer. :
Étape 5
Si vous avez besoin d’annuler, contactez immédiatement l’assistance (si disponible). En l’absence de sauvegarde, la restauration peut être impossible. :
Suppression irréversible
La suppression d’un projet supprime ses ressources indexées et ses webhooks liés. Effectuez des sauvegardes avant toute suppression pour éviter toute perte de données irréversible.
Pour un changement mineur (nom ou langue), ouvrez la modal, modifiez le champ, enregistrez et faites un test de validation rapide (chat court ou prévisualisation).
Avant
- Nom, langue et prompts initiaux.
- Clés anciennes ou partagées.
- Risque de tests limités. :
Après
- Nom à jour et clair.
- Langue adaptée au public et aux agents.
- Prompt optimisé et clé OpenAI sécurisée.
- Tests de validation complétés. :
Workflow recommandé pour les changements critiques
- Documentez la modification. 2) Effectuez-la dans un environnement de test/staging. 3) Testez (chat, agents, site). 4) Appliquez en production et surveillez l’usage.
Frequently Asked Questions
Besoin d’aide supplémentaire ?
Si vous avez des doutes sur une suppression ou la rotation d’une clé, contactez votre administrateur ou notre support avant d’agir.
Récapitulatif des options modifiables
Nom du projet
Modifiez le nom pour refléter l’objectif du projet. Champ requis et visible dans l’en-tête.
Langue
Détermine la langue par défaut pour les agents et la génération de contenu.
Pré-prompt (user_prompt)
Texte envoyé en amont aux agents pour guider leur comportement.
Clé OpenAI
Clé utilisée pour authentifier les requêtes vers le service d’IA. Gérez-la avec soin, et faites des rotations régulières.
Domaine personnalisé
Certaines plateformes permettent d’ajouter un domaine personnalisé — il doit être unique et validé avant publication.
Suppression
Supprime définitivement le projet et ses ressources indexées ; sauvegardez au préalable.
Merci d’avoir consulté ce guide. En suivant ces étapes et bonnes pratiques, vous pourrez administrer vos projets en toute sécurité et maintenir des comportements d’agents et de génération conformes à vos attentes.