Skip to main content
L’éditeur web comporte deux niveaux de paramètres :
  • Vos paramètres ne s’appliquent qu’à vous et contrôlent la façon dont l’IA de l’éditeur vous assiste pendant vos modifications.
  • Les paramètres de publication s’appliquent à toutes les personnes d’un déploiement et déterminent ce qui se passe lorsque vous validez des modifications et les transformez en pull requests.
Vous pouvez configurer les deux depuis le panneau des paramètres. Pour l’ouvrir, cliquez sur l’icône de paramètres dans la barre d’outils de l’éditeur.

​
Instructions d’IA

Les instructions d’IA sont des consignes persistantes que l’éditeur envoie à l’IA avec votre requête. Utilisez-les pour formuler des règles de style et de ton que vous ne voulez pas répéter à chaque fois, comme la voix, la terminologie ou les conventions de mise en forme. Vos instructions s’appliquent à :
  • Les actions Edit with AI sur une sélection, comme réécrire, développer ou corriger.
  • Les sessions de l’agent lancées depuis l’éditeur.
Chaque membre de l’équipe gère ses propres instructions, liées à son compte utilisateur.

​
Quand utiliser les instructions d’IA

Ajoutez des instructions d’IA lorsque vous vous surprenez à répéter les mêmes consignes dans vos prompts, par exemple :
  • Imposer la deuxième personne ou des titres en majuscule initiale uniquement.
  • Privilégier des noms de produit ou une terminologie spécifiques.
  • Bannir le langage marketing ou les phrases de remplissage.
  • Exiger certains composants, comme toujours utiliser <Note> pour les encarts.
Gardez les instructions courtes et précises. L’IA les suit à chaque requête, donc des règles vagues ou contradictoires dégradent les résultats.

​
Configurer les instructions d’IA

  1. Cliquez sur l’icône de paramètres dans la barre d’outils de l’éditeur.
  2. Dans le champ AI instructions, saisissez les consignes que l’IA doit suivre.
  3. Enregistrez vos modifications.
Exemple :
Laissez le champ vide pour supprimer vos instructions.

​
Paramètres de publication

Vous configurez les paramètres de publication par déploiement, et ils s’appliquent à toutes les personnes qui publient depuis l’éditeur. Ils contrôlent la façon dont l’éditeur génère, ouvre et fusionne les pull requests et les commits. Vous devez disposer d’un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication.

​
Instructions pour la pull request

Les instructions pour la pull request guident l’IA lorsqu’elle génère le titre et la description d’une pull request. Elles s’appliquent dès que l’éditeur ouvre une pull request en votre nom, y compris dans les flux Create pull request et Merge and publish. Utilisez les instructions pour la pull request afin de standardiser ce que voient les relecteurs, par exemple :
  • Des sections obligatoires comme Summary et Changes.
  • Un modèle de description qui renvoie vers un système de suivi.
  • Des exigences de ton ou de longueur pour les titres.
Exemple :

​
Créer les pull requests en brouillon par défaut

Activez cette option pour que l’éditeur ouvre chaque nouvelle pull request à l’état de brouillon. Vous ne pouvez pas fusionner une pull request en brouillon avant de la marquer comme prête pour la relecture. C’est utile lorsque :
  • Votre équipe exige une relecture manuelle avant d’ouvrir la pull request pour approbation.
  • Vous voulez partager des URL de prévisualisation sans signaler que la modification est prête à être fusionnée.
Vous pouvez toujours marquer une pull request comme prête pour la relecture depuis votre fournisseur Git.

​
Méthode de fusion par défaut

Choisissez la manière dont l’éditeur fusionne les pull requests lorsque vous cliquez sur Merge and publish :
  • Merge : Crée un commit de fusion qui conserve l’historique complet de la branche.
  • Squash : Combine tous les commits de la branche en un seul commit sur votre branche de déploiement.
  • Rebase : Rejoue chaque commit de la branche sur votre branche de déploiement, sans commit de fusion.
L’éditeur utilise la méthode sélectionnée par défaut. Si vous passez une méthode de fusion explicite via l’API ou l’interface de votre fournisseur Git, ce choix prévaut.
Alignez votre méthode de fusion par défaut sur les règles de protection de branche de votre fournisseur Git. Si votre branche de déploiement n’autorise que les fusions squash, définissez la valeur par défaut sur Squash pour éviter les échecs de fusion depuis l’éditeur.