Créer une automatisation personnalisée

Une automatisation personnalisée exécute l’agent selon un calendrier, en réponse à des pushes sur un dépôt ou lorsqu’un événement survient dans une intégration connectée, en utilisant les instructions que vous rédigez. Utilisez une automatisation personnalisée lorsque vous avez besoin d’un comportement non couvert par une automatisation prédéfinie, ou lorsque vous souhaitez combiner votre propre prompt avec des dépôts de contexte et des intégrations spécifiques. Pour un aperçu des déclencheurs, des modes de mise à jour et des options de configuration communs à toutes les automatisations, consultez Automatisations.

• Un projet Mintlify connecté à un dépôt GitHub ou GitLab
• Pour GitHub : la GitHub App Mintlify installée sur chaque dépôt que vous prévoyez d’utiliser dans l’automatisation
• Pour GitLab : un compte GitLab connecté (voir Configuration GitLab ci-dessous)

1. Ouvrez la page Automations dans votre dashboard.
2. Cliquez sur New automation.
3. Sur la page de configuration, définissez le nom de l’automatisation, le déclencheur, le prompt, les dépôts de contexte, les intégrations et le mode de mise à jour. Pour plus de détails sur chaque champ, consultez Configurations.
4. Cliquez sur Save.

Des instructions d’automatisation efficaces se concentrent sur une seule tâche et définissent un résultat clair et vérifiable. Les automatisations présentent une certaine variabilité car les agents sont non déterministes, mais des instructions bien formulées produisent des résultats plus cohérents.

• Décrivez le résultat. Indiquez à l’agent à quoi devrait ressembler une exécution réussie.
• Rédigez une procédure. Donnez à l’agent un guide étape par étape à suivre.
• Restez précis dans la portée. Divisez les tâches complexes en plusieurs automatisations plutôt que de les combiner dans un seul prompt.

Pour plus d’exemples et de modèles, consultez Utiliser les automatisations. Testez une nouvelle automatisation avec une exécution manuelle afin de ne pas avoir à attendre que son déclencheur se produise. Les exécutions manuelles utilisent la configuration actuelle de l’automatisation et apparaissent dans l’historique des exécutions aux côtés des exécutions automatisées. Vous ne pouvez pas exécuter manuellement les automatisations déclenchées par des événements d’intégration. Consultez Exécuter une automatisation manuellement pour choisir la portée d’une exécution de test. Examinez l’exécution dans l’historique des exécutions pour voir le prompt, les fichiers modifiés par l’agent et toute pull request ouverte. Si le résultat ne correspond pas à vos attentes, mettez à jour vos instructions et relancez l’exécution.

​

Configuration GitLab

Pour utiliser des dépôts GitLab dans une automatisation, connectez chaque projet via la page de paramètres OAuth GitLab. Connectez chaque dépôt que l’automatisation utilise — votre dépôt de documentation et tous les dépôts de déclenchement ou de contexte. Vous devez disposer au minimum du rôle Mainteneur sur chaque projet.

1. Ouvrez la page Automations dans votre dashboard.
2. Cliquez sur le bouton de paramètres sur la carte de l’automatisation pour ouvrir sa page de configuration.
3. Mettez à jour n’importe quel des champs décrits dans Configurations.
4. Cliquez sur Save.

La suppression d’une automatisation est définitive et supprime sa configuration ainsi que l’historique de ses exécutions.

1. Accédez à la page Automations dans votre dashboard.
2. Cliquez sur le bouton de paramètres sur la carte de l’automatisation pour ouvrir sa page de configuration.
3. Cliquez sur Delete automation en bas de la page et confirmez.