Passer au contenu principal

​
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 Knowledge. Nous vous recommandons de lire la documentation de Knowledge avant de créer des Playbooks, afin de comprendre quelle méthode correspond le mieux à vos besoins.
Devin
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 Procedure, Specifications, Advice, Forbidden Actions ou Required from User
    1. Procedure : 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. Specifications : décrivez les postconditions – qu’est-ce qui doit être vrai une fois que Devin a terminé ?
    3. Advice : incluez des conseils pour corriger les a priori de Devin
    4. Forbidden Actions : 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 l’application web en cliquant sur “Create a new Playbook”. Vous pouvez aussi enregistrer un fichier avec l’extension .devin.md et le faire glisser dans l’application web au démarrage d’une session Devin.
Devin
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 !
3. Create request dict with model: "tts-1", voice: "alloy"

​
Exemple de playbook

Consultez des sessions d’exemple utilisant le playbook ci-dessous ici et ici.
R Data Science Tutorial
Playbook : R Data Science Tutorial

## Aperçu
Créer un tutoriel de data science à l’aide d’un notebook R Markdown.

## Informations nécessaires de la part de l’utilisateur
- Lien vers un jeu de données (fichier CSV en pièce jointe ou lien Kaggle)
- Tâche spécifique pour laquelle créer le tutoriel de data science

## Procédure
1. Télécharger le jeu de données fourni par l’utilisateur.
-  Si nécessaire, télécharger le jeu de données à l’aide du CLI Kaggle – aucune information d’identification n’est requise pour cela.
2. Créer un notebook R Markdown intitulé `data_science_tutorial.Rmd`.
3. Créer un fichier `tmp.Rmd` pour écrire et sauvegarder le code intermédiaire.
4. Créer 5 sections principales dans le fichier `data_science_tutorial.Rmd` et y ajouter le code depuis le fichier `tmp.Rmd` contenant les éléments suivants :
- Statistiques du jeu de données. Générer un résumé statistique du jeu de données.
- EDA (Exploratory Data Analysis). Créer un diagramme en barres et un nuage de points pour les données fournies.
- Séparation train-test. Diviser les données selon un ratio 80:20. Sauvegarder les données d’entraînement et de test.
- Entraînement du modèle de machine learning. Sauvegarder le modèle une fois entraîné.
- Inférence avec le modèle sauvegardé. Charger le modèle sauvegardé et évaluer ses performances sur le jeu de test en utilisant la métrique spécifiée par l’utilisateur.
5. Une fois le code écrit, ajouter une brève explication pour chaque section.
6. Convertir le notebook R Markdown au format HTML.
7. Envoyer à l’utilisateur le notebook R Markdown final, le fichier HTML, le modèle sauvegardé et les données de test.

## Spécifications
1. Envoyer le notebook R Markdown et le fichier HTML à l’utilisateur.
2. Envoyer le modèle sauvegardé et les données de test à l’utilisateur.

## Conseils et recommandations
1. Ne pas réinstaller les packages s’ils sont déjà installés.
2. La connexion à RStudio n’est pas requise pour mener à bien cette tâche.
3. Exécuter l’intégralité du notebook après avoir ajouté le code pour chaque section.

## Actions interdites
1. Ne pas écraser le fichier `data_science_tutorial.Rmd`.