Skip to main content

​
¿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 Skills. Recomendamos leer la documentación sobre Skills antes de crear Playbooks, para entender qué método se ajusta mejor a tus necesidades.

Cómo crear un Playbook, asignarle una macro y usarlo en una sesión

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 procedimiento, especificación, Advice, Forbidden Actions o Required from User
    1. procedimiento: 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. especificación: 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 web app: abre Settings → Playbooks y haz clic en Create playbook en la pestaña Organization (o en la pestaña Enterprise si quieres crear playbooks a nivel Enterprise).
La página de configuración de Playbooks con las pestañas Organization y System, la tabla de playbooks con macros y el botón Create playbook
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.

​
Ejemplo de playbook

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

​
Macros

Puedes asignar una macro a cualquier playbook: un identificador corto que empieza por ! (por ejemplo, !data-tutorial). Las macros te permiten asociar rápidamente un playbook a una sesión escribiendo el nombre de la macro en el campo del prompt. Las macros solo pueden contener letras, números, guiones bajos y guiones, y deben ser únicas dentro de tu organización.

​
Historial de versiones

Playbooks mantienen un historial de versiones para que puedas hacer un seguimiento de los cambios a lo largo del tiempo. Cada vez que editas y guardas un playbook, se crea una nueva versión. Puedes ver versiones anteriores y volver a una versión anterior si un cambio reciente no funcionó como se esperaba.

​
Playbooks de Enterprise

Para los clientes Enterprise, los playbooks se pueden gestionar en el nivel Enterprise además del nivel de organización. Los playbooks de Enterprise se comparten en todas las organizaciones de tu Enterprise, lo que facilita estandarizar los flujos de trabajo entre equipos. Los administradores de Enterprise pueden crear y gestionar playbooks de nivel Enterprise desde los Settings de Enterprise.