Vai al contenuto principale

​
Cosa sono i playbook?

​
I Playbook sono prompt facilmente condivisibili e riutilizzabili per attività ripetute

Un Playbook è come un prompt di sistema personalizzato per un’attività ricorrente. Per esempio, se hai bisogno di molte sessioni di Devin, diverse tra loro, che integrino tutte la stessa libreria di terze parti ma in parti diverse della tua applicazione, potresti voler usare un Playbook. I Playbook sono anche facilmente condivisibili e riutilizzabili, quindi, una volta che qualcuno ottiene buoni risultati con Devin, gli altri possono replicare più facilmente quel successo!
La maggior parte delle best practice, delle guide di stile o di altre istruzioni specifiche di progetto dovrebbe essere condivisa con Devin usando Knowledge. Ti consigliamo di leggere la documentazione relativa a Knowledge prima di creare Playbook, per capire quale metodo si adatta meglio alle tue esigenze.
Devin
Ti consigliamo di usare i Playbook quando:
  • Tu o i tuoi colleghi riutilizzerete il prompt in più sessioni.
  • Ti ritrovi a ripetere le stesse indicazioni a Devin.
  • Il caso d’uso può essere rilevante per altri — nella tua organizzazione o all’interno della community di utenti Devin.

​
Introduzione ai Playbook

I Playbook possono sbloccare immediatamente la capacità di Devin di contribuire in un’ampia gamma di ambiti, ma al momento richiedono una certa competenza per essere scritti. In modo simile al prompt engineering, scrivere playbook richiede tentativi ed errori. Il frutto di questo lavoro, però, è un documento che sblocca la capacità di Devin di affrontare in modo indipendente attività complesse, dall’ingestione di dati in Redshift e l’esecuzione di migrazioni di database all’utilizzo di diversi software e API: ad esempio Together, Plaid, Stripe, Modal, Spring Boot, Odoo e Storybook.
Ti consigliamo di scrivere il tuo primo playbook partendo da una semplice attività in più fasi che vuoi che Devin gestisca.
  1. Crea un documento che descriva…
    1. Il risultato che vuoi che Devin raggiunga
    2. I passaggi necessari per arrivarci
  2. Opzionale: aggiungi sezioni come Procedura, Specifiche, Consigli, Azioni vietate o Richiesto dall’utente
    1. Procedura: Delinea l’intero ambito dell’attività. Includi almeno un passaggio per il setup, il lavoro vero e proprio e la consegna.
    2. Specifiche: Descrivi le postcondizioni: cosa deve essere vero dopo che Devin ha finito?
    3. Consigli: Includi suggerimenti per correggere i presupposti iniziali di Devin
    4. Azioni vietate: Includi qualsiasi azione che Devin non deve assolutamente intraprendere
    5. Richiesto dall’utente: Descrivi qualsiasi input o informazione richiesti all’utente
  3. Crea il playbook direttamente nella web app facendo clic su “Create a new Playbook”. In alternativa, salva un file con estensione .devin.md e trascinalo nella web app quando avvii una sessione con Devin
Devin
Hai collegato correttamente un playbook a una sessione se vedi apparire una pillola blu, insieme a un componente inline per modificare il playbook prima di iniziare la sessione.
Devin

​
Come scrivere un playbook efficace

​
Procedura

La sezione Procedura dovrebbe…
  • Avere un passo per riga, ogni riga scritta in forma imperativa
  • Coprire l’intero ambito dell’attività
  • Includere almeno un passo per la configurazione iniziale, il compito effettivo e la consegna
  • Puntare a rendere i passi mutuamente esclusivi e collettivamente esaustivi
  • Suggerimenti aggiuntivi
    • Le procedure dovrebbero aiutarti a definire l’ordine delle azioni di Devin, come if/else/loops/goto nel codice
    • Non rendere i compiti troppo specifici a meno che non sia davvero necessario: questo può ridurre la capacità di Devin di risolvere problemi
    • Ogni passo della procedura dovrebbe contenere un verbo d’azione, ad es. Scrivi, Vai a, ecc.

​
Consigli e indicazioni

Condividi consigli e indicazioni con Devin se…
  • Hai un modo preferito di svolgere le attività
  • Il consiglio si applica all’intera attività o a più passaggi. I consigli specifici per un singolo passaggio andrebbero scritti accanto a quel passaggio (ad es. come sotto-elenco puntato)
  • Stai correggendo le assunzioni di base di Devin. I consigli possono funzionare come commenti su pseudocodice che ne influenzano l’esecuzione.
Se il consiglio si applica solo a un singolo passaggio della procedura, inserisci il consiglio sotto quel passaggio usando punti elenco annidati

​
Specifiche

La sezione Specifiche può essere utile per descrivere le postcondizioni del playbook: che cosa dovrebbe essere vero una volta che Devin ha terminato?

​
Cosa è necessario dall’utente

Valuta tutto ciò che è necessario ma che è al di fuori del controllo di Devin. Ad esempio, se l’utente deve fornire un token o informazioni che non sono pubblicamente disponibili per Devin.

​
Altri suggerimenti e tattiche

  • Esegui 2 o più Devin in parallelo con lo stesso playbook per identificare rapidamente possibili errori.
  • Se Devin ha bisogno di aiuto, interagisci in chat per aiutarlo a progredire. Poi aggiorna il tuo playbook in modo che la volta successiva Devin riesca a completare il lavoro senza intervento.
Sii esplicito su qual è il deliverable e su come Devin deve comunicare che è completato (ad es. quali file allegare o quali link condividere, se necessario).
Esplora le diverse decisioni che Devin può prendere e guida Devin lungo il percorso più efficiente all’interno del playbook.
  • Possono fare la differenza tra un playbook funzionante e uno che non funziona.
  • Ad esempio, quanto segue può essere un ottimo dettaglio da includere perché alloy e tts-1 probabilmente non sono elementi che Devin sceglierebbe altrimenti, e questo guida Devin in una direzione con maggiore probabilità di successo!
3. Create request dict with model: "tts-1", voice: "alloy"

​
Esempio di playbook

Visualizza le sessioni di esempio che utilizzano il playbook qui e qui.