Saltar al contenido principal

​
¿Qué son los Playbooks?

​
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.
Devin
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.

​
Primeros pasos con los Playbooks

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.
  1. Crea un documento que describa…
    1. El resultado que quieres que Devin logre
    2. Los pasos necesarios para lograrlo
  2. Opcional: Agrega secciones como Procedure, Specifications, Advice, Forbidden Actions o Required from User
    1. 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.
    2. Specifications: Describe las postcondiciones: ¿qué debe ser cierto cuando Devin termine?
    3. Advice: Incluye consejos para corregir los conocimientos previos de Devin
    4. Forbidden Actions: Incluye cualquier acción que Devin absolutamente no deba realizar
    5. Required from User: Describe cualquier dato o información que se requiera del usuario
  3. 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.
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.
Devin

​
Cómo elaborar un playbook excelente

​
Procedimiento

La sección de Procedimiento debe:
  • Tener un paso por línea, cada línea escrita en modo imperativo
  • Cubrir todo el alcance de la tarea
  • Incluir al menos un paso para la configuración, la tarea en sí y la entrega
  • Procurar que los pasos sean mutuamente excluyentes y colectivamente exhaustivos
  • Consejos adicionales
    • Los procedimientos deben ayudarte a definir la secuencia de acciones de Devin, como if/else/bucles/goto en el código
    • No hagas las tareas demasiado específicas a menos que realmente lo necesites; esto puede reducir la capacidad de Devin para resolver problemas
    • Cada paso del procedimiento debe contener un verbo de acción, por ejemplo: Escribir, Ir a, etc.

​
Consejos y recomendaciones

Comparte consejos y recomendaciones con Devin si…
  • Tienes una forma preferida de realizar las tareas
  • 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

​
Especificaciones

La sección de Especificaciones puede ser útil para describir las postcondiciones del playbook: ¿qué debería cumplirse una vez que Devin haya terminado?

​
Qué se necesita del usuario

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.

​
Otros consejos y tácticas

  • 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.
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).
Explora las diferentes decisiones que puede tomar Devin y guíalo por el camino más eficiente dentro del playbook.
  • 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.
3. Create request dict with model: "tts-1", voice: "alloy"

​
Ejemplo de playbook

Consulta sesiones de ejemplo que usan el playbook a continuación aquí y aquí.