Los Playbooks son prompts fáciles de compartir y reutilizables para tareas repetitivas
Un Playbook es como un prompt de sistema personalizado para una tarea repetitiva. Por ejemplo, si necesitas tener muchas sesiones diferentes de Devin que cada una integre la misma biblioteca de terceros pero en distintas partes de tu aplicación, podrías querer usar un Playbook.Los Playbooks también son fáciles de compartir y reutilizar, así que una vez que alguien tiene éxito con Devin, otros pueden replicar ese éxito con mayor facilidad.
La mayoría de las buenas prácticas, guías de estilo u otras instrucciones específicas de un proyecto deberían compartirse con Devin usando Knowledge. Recomendamos leer la documentación sobre Knowledge antes de crear Playbooks, para entender qué método se ajusta mejor a tus necesidades.
Recomendamos usar Playbooks cuando:
Tú o tu equipo reutilizarán el prompt en múltiples sesiones.
Te encuentras repitiendo los mismos recordatorios a Devin.
El caso de uso puede ser relevante para otros, ya sea en tu organización o dentro de la comunidad de usuarios de Devin.
Los Playbooks pueden desbloquear de inmediato la capacidad de Devin para contribuir en una amplia variedad de áreas, pero actualmente hace falta cierta habilidad para escribirlos. De forma similar a la ingeniería de prompts, redactar playbooks requiere ensayo y error. El fruto de este trabajo, sin embargo, es un documento que desbloquea la capacidad de Devin para abordar de forma independiente tareas complejas, desde cargar datos en Redshift y realizar migraciones de bases de datos hasta utilizar distinto software y APIs: p. ej., Together, Plaid, Stripe, Modal, Springboot, Odoo y Storybook.
Considera escribir tu primer playbook con una tarea sencilla de varios pasos que quieras que Devin resuelva.
Crea un documento que describa…
El resultado que quieres que Devin logre
Los pasos necesarios para lograrlo
Opcional: Agrega secciones como Procedure, Specifications, Advice, Forbidden Actions o Required from User
Procedure: Describe todo el alcance de la tarea. Incluye al menos un paso para la configuración inicial, la tarea en sí y la entrega.
Specifications: Describe las postcondiciones: ¿qué debe ser cierto cuando Devin termine?
Advice: Incluye consejos para corregir los conocimientos previos de Devin
Forbidden Actions: Incluye cualquier acción que Devin absolutamente no deba realizar
Required from User: Describe cualquier dato o información que se requiera del usuario
Crea el playbook directamente en la aplicación web haciendo clic en “Create a new Playbook”. Como alternativa, guarda un archivo con la extensión .devin.md y arrástralo y suéltalo en la aplicación web al iniciar una sesión de Devin.
Has adjuntado correctamente un playbook a una sesión si ves aparecer una etiqueta azul, junto con un componente en línea para editar el playbook antes de iniciar tu sesión.
El consejo se aplica a toda la tarea o a varios pasos. Los consejos específicos de un solo paso deben escribirse junto a ese paso (por ejemplo, como una subviñeta)
Estás corrigiendo los supuestos previos de Devin. Los consejos pueden funcionar como comentarios en pseudocódigo que influyen en su ejecución.
Si el consejo solo se aplica a un paso de la Procedure, escribe el consejo debajo de ese paso usando viñetas anidadas
La sección de Especificaciones puede ser útil para describir las postcondiciones del playbook: ¿qué debería cumplirse una vez que Devin haya terminado?
Considera todo lo necesario que esté fuera del control de Devin. Por ejemplo, si el usuario debe proporcionar un token o información que no esté disponible públicamente para Devin.
Ejecuta 2 o más Devins en paralelo con el mismo playbook para identificar rápidamente posibles errores.
Si Devin necesita ayuda, interactúa con él mediante el chat para ayudarlo a avanzar. Luego agrégalo a tu playbook para que Devin tenga éxito sin intervención la próxima vez.
Dile a Devin cómo se ve un buen resultado
Sé explícito sobre cuál es el entregable y cómo debe comunicar Devin que ha terminado (por ejemplo, qué archivos debe adjuntar o qué enlaces debe compartir, si corresponde).
Optimiza la velocidad de ejecución de tu playbook
Explora las diferentes decisiones que puede tomar Devin y guíalo por el camino más eficiente dentro del playbook.
Comandos específicos, 'incantations' y strings son perfectamente válidos
Pueden marcar la diferencia entre un playbook funcional y uno con errores.
Por ejemplo, lo siguiente puede ser un muy buen detalle para incluir, porque alloy y tts-1 probablemente no serían opciones que Devin elegiría de otra forma, y esto guía a Devin en una dirección con más probabilidad de éxito.
Copiar
Preguntar a la IA
3. Create request dict with model: "tts-1", voice: "alloy"
Consulta sesiones de ejemplo que usan el playbook a continuación aquí y aquí.
R Data Science Tutorial
Copiar
Preguntar a la IA
Playbook: R Data Science Tutorial## OverviewCrea un tutorial de ciencia de datos usando un cuaderno R Markdown.## What’s Needed From User- Enlace a un conjunto de datos (archivo CSV adjunto o enlace de Kaggle)- Tarea específica para la que crear un tutorial de ciencia de datos## Procedure1. Descarga el conjunto de datos proporcionado por el usuario.- Si es necesario, descarga el conjunto de datos usando la CLI de Kaggle; no necesitas credenciales para esto.2. Crea un cuaderno R Markdown titulado `data_science_tutorial.Rmd`.3. Crea un archivo `tmp.Rmd` para escribir y guardar código intermedio.4. Crea 5 secciones principales dentro del archivo `data_science_tutorial.Rmd` y añade código desde el archivo `tmp.Rmd` que contenga lo siguiente:- Estadísticas del conjunto de datos. Genera un resumen estadístico del conjunto de datos.- EDA (Exploratory Data Analysis). Crea un gráfico de barras y un diagrama de dispersión para los datos proporcionados.- División train-test. Divide los datos en una proporción 80:20. Guarda los datos de entrenamiento y de prueba.- Entrenamiento del modelo de machine learning. Guarda el modelo una vez entrenado.- Inferencia con el modelo guardado. Carga el modelo guardado y evalúa su rendimiento en el conjunto de prueba usando la métrica especificada por el usuario.5. Una vez escrito el código, añade una breve explicación para cada sección.6. Convierte el cuaderno R Markdown al formato HTML.7. Envía al usuario el cuaderno R Markdown final, el archivo HTML, el modelo guardado y los datos de prueba.## Specifications1. Envía al usuario el cuaderno R Markdown y el archivo HTML.2. Envía al usuario el modelo guardado y los datos de prueba.## Advice and Pointers1. No reinstales paquetes si ya están instalados.2. No es necesario iniciar sesión en RStudio para completar esta tarea.3. Ejecuta el cuaderno completo después de añadir código para cada sección.## Forbidden Actions1. No sobrescribas el archivo `data_science_tutorial.Rmd`.
