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.
R Data Science Tutorial
Playbook: R Data Science Tutorial

## Overview
Crea un tutorial di data science utilizzando un notebook R Markdown.

## What’s Needed From User
- Link a un dataset (file CSV in allegato o link Kaggle)
- Attività specifica per cui creare un tutorial di data science

## Procedure
1. Scarica il dataset fornito dall'utente.
-  Se necessario, scarica il dataset utilizzando la Kaggle CLI: non ti servono credenziali per farlo.
2. Crea un notebook R Markdown intitolato `data_science_tutorial.Rmd`.
3. Crea un file `tmp.Rmd` per scrivere e salvare il codice intermedio.
4. Crea 5 sezioni principali all'interno del file `data_science_tutorial.Rmd` e aggiungi il codice dal file `tmp.Rmd` contenente quanto segue:
- Statistiche del dataset. Genera un riepilogo statistico del dataset.
- EDA (Exploratory Data Analysis). Crea un grafico a barre e uno scatter plot per i dati forniti.
- Suddivisione train-test. Suddividi i dati con un rapporto 80:20. Salva i dati di training e di test.
- Addestramento del modello di machine learning. Salva il modello una volta addestrato.
- Inferenza con il modello salvato. Carica il modello salvato e valuta le sue prestazioni sul set di test utilizzando la metrica specificata dall'utente.
5. Una volta scritto il codice, aggiungi una breve spiegazione per ciascuna sezione.
6. Converti il notebook R Markdown in formato HTML.
7. Invia all'utente il notebook R Markdown finale, il file HTML, il modello salvato e i dati di test.

## Specifications
1. Invia all'utente il notebook R Markdown e il file HTML.
2. Invia all'utente il modello salvato e i dati di test.

## Advice and Pointers
1. Non reinstallare i pacchetti se sono già installati.
2. Non è necessario effettuare l'accesso a RStudio per completare questa attività.
3. Esegui l'intero notebook dopo aver aggiunto il codice per ciascuna sezione.

## Forbidden Actions
1. Non sovrascrivere il file `data_science_tutorial.Rmd`.