Skip to main content

​
Qu’est-ce qu’un Playbook ?

​
Les Playbooks sont des prompts facilement partageables et réutilisables pour les tâches répétitives

Un Playbook s’apparente à un prompt système personnalisé pour une tâche répétitive. Par exemple, si vous avez besoin de nombreuses sessions Devin différentes qui intègrent toutes la même bibliothèque tierce, mais dans différentes parties de votre application, vous pouvez avoir besoin d’un Playbook. Les Playbooks sont également facilement partageables et réutilisables : une fois que quelqu’un réussit avec Devin, les autres peuvent plus facilement reproduire ce succès !
La plupart des bonnes pratiques, guides de style ou autres instructions propres à un projet doivent être partagés avec Devin en utilisant Skills. Nous vous recommandons de lire la documentation des Skills avant de créer des Playbooks, afin de comprendre quelle méthode correspond le mieux à vos besoins.

Création d’un Playbook, attribution d’une macro et utilisation dans une session

Nous recommandons d’utiliser des Playbooks lorsque :
  • Vous ou vos collègues allez réutiliser le prompt dans plusieurs sessions.
  • Vous vous surprenez à répéter les mêmes rappels à Devin.
  • Le cas d’usage peut être pertinent pour d’autres — dans votre organisation ou au sein de la communauté d’utilisateurs de Devin.

​
Bien démarrer avec les Playbooks

Les Playbooks peuvent immédiatement décupler la capacité de Devin à contribuer dans un large éventail de domaines, mais nécessitent aujourd’hui un certain savoir-faire pour être rédigés. À l’image de la conception de prompts, écrire des playbooks implique des essais et des erreurs. Le fruit de ce travail est toutefois un document qui permet à Devin de traiter de manière autonome des tâches complexes, qu’il s’agisse d’ingérer des données dans Redshift et d’effectuer des migrations de base de données ou d’utiliser divers logiciels et API, par exemple Together, Plaid, Stripe, Modal, Springboot, Odoo et Storybook.
Pour commencer, rédigez votre premier playbook autour d’une tâche simple en plusieurs étapes que vous souhaitez confier à Devin.
  1. Créez un document qui décrit…
    1. Le résultat que vous voulez que Devin atteigne
    2. Les étapes nécessaires pour y parvenir
  2. Optionnel : ajoutez des sections comme procédure, spécifications, conseil, actions interdites ou Required from User
    1. procédure : décrivez l’ensemble du périmètre de la tâche. Incluez au moins une étape pour la configuration, la tâche elle-même et la livraison.
    2. spécifications : décrivez les postconditions – qu’est-ce qui doit être vrai une fois que Devin a terminé ?
    3. conseil : incluez des conseils pour corriger les prérequis ou suppositions initiales de Devin
    4. actions interdites : indiquez toute action que Devin ne doit absolument pas effectuer
    5. Required from User : décrivez toute entrée ou information nécessaire de la part de l’utilisateur
  3. Créez le playbook directement dans la webapp : ouvrez Settings → Playbooks et cliquez sur Create playbook dans l’onglet Organization (ou dans l’onglet Enterprise pour les playbooks à l’échelle de l’entreprise).
La page de paramètres Playbooks affichant les onglets Organization et System, le tableau des playbooks avec les macros et le bouton Create playbook
Vous avez correctement attaché un playbook à une session si vous voyez apparaître une pastille bleue, ainsi qu’un composant inline pour modifier le playbook avant de démarrer votre session.
Devin

​
Rédiger un playbook de qualité

​
Procédure

La section Procédure doit…
  • Avoir une étape par ligne, chaque ligne rédigée à l’impératif
  • Couvrir l’ensemble de la tâche
  • Inclure au moins une étape pour la configuration, la tâche proprement dite et le livrable
  • Viser à rendre les étapes Mutuellement Exclusives et Collectivement Exhaustives
  • Conseils supplémentaires
    • Les procédures doivent vous aider à définir l’ordre dans lequel Devin agit — comme des if/else/boucles/goto dans le code
    • Ne rendez pas les tâches trop spécifiques, sauf si c’est vraiment nécessaire, car cela peut limiter la capacité de Devin à résoudre des problèmes
    • Chaque étape de la procédure doit contenir un verbe d’action — par exemple : écrire, naviguer vers, etc.

​
Conseils et recommandations

Partagez des conseils et des recommandations avec Devin si…
  • Vous avez une manière préférée d’accomplir les tâches
  • Le conseil s’applique à l’ensemble de la tâche ou à plusieurs étapes. Un conseil spécifique à une seule étape doit être écrit à côté de cette étape (par exemple sous forme de sous-puce)
  • Vous corrigez les prérequis ou suppositions initiales de Devin. Les conseils peuvent fonctionner comme des commentaires sur du pseudocode qui influencent son exécution.
Si le conseil ne s’applique qu’à une seule étape de la procédure, écrivez-le sous cette étape en utilisant des puces imbriquées

​
Spécifications

La section Spécifications peut être utile pour décrire les postconditions du playbook — qu’est-ce qui doit être vérifié une fois que Devin a terminé ?

​
Ce qui est nécessaire de la part de l’utilisateur

Identifiez tout ce qui est nécessaire mais échappe au contrôle de Devin. Par exemple, si l’utilisateur doit fournir un jeton ou des informations qui ne sont pas accessibles publiquement à Devin.

​
Autres conseils et tactiques

  • Exécutez 2 Devins ou plus en parallèle avec le même playbook pour identifier rapidement les erreurs possibles.
  • Si Devin a besoin d’aide, discutez avec lui pour le débloquer. Ajoutez ensuite ces précisions à votre playbook afin que Devin réussisse sans intervention la prochaine fois.
Soyez explicite sur le livrable attendu et sur la manière dont Devin doit indiquer qu’il a terminé (par exemple, quels fichiers joindre ou quels liens partager, le cas échéant).
Explorez les différentes décisions que Devin peut prendre et guidez-le vers la voie la plus efficace dans le playbook.
  • Elles peuvent faire la différence entre un playbook fonctionnel et un playbook défaillant.
  • Par exemple, le détail suivant peut être très utile à inclure, car alloy et tts-1 ne sont probablement pas des choix que Devin aurait faits de lui-même, et cela oriente Devin dans une direction plus susceptible de réussir !

​
Exemple de playbook

Consultez des sessions d’exemple utilisant le playbook ci-dessous ici et ici.

​
Macros

Vous pouvez attribuer une macro à n’importe quel playbook — un identifiant court commençant par ! (par ex. !data-tutorial). Les macros vous permettent d’associer rapidement un playbook à une session en saisissant le nom de sa macro dans le champ de saisie du prompt. Les macros ne peuvent contenir que des lettres, des chiffres, des tirets bas et des tirets, et doivent être uniques au sein de votre organisation.

​
Historique des versions

Les playbooks conservent un historique des versions qui vous permet de suivre les modifications au fil du temps. Chaque fois que vous modifiez et enregistrez un playbook, une nouvelle version est créée. Vous pouvez consulter les versions précédentes et revenir à une version antérieure si une modification récente n’a pas produit le résultat attendu.

​
Playbooks Enterprise

Pour les clients Enterprise, les playbooks peuvent être gérés au niveau de l’Enterprise en plus du niveau de l’organisation. Les playbooks Enterprise sont partagés entre toutes les organisations de votre Enterprise, ce qui facilite la standardisation des workflows entre les équipes. Les administrateurs Enterprise peuvent créer et gérer des playbooks au niveau de l’Enterprise depuis les Settings Enterprise.