Skip to main content
Per una panoramica completa delle best practice, vedi anche Instructing Devin Effectively e Good vs. Bad Instructions.
Devin ha bisogno di indicazioni sulle tue preferenze e su come verificare se è sulla strada giusta. Se non gli fornisci queste indicazioni, Devin prenderà decisioni in autonomia. Ti consigliamo di seguire una struttura semplice nei tuoi prompt per assicurarti che Devin resti allineato e controlli il proprio lavoro:

Cosa

Descrivi l’attività che vuoi che Devin porti a termine.Esempio: Aggiorna il mio progetto da Java 7 a Java 8.

Come

Descrivi alcune indicazioni su cosa fare e cosa evitare per Devin durante l’esecuzione dell’attività (ad es. effettua il deploy usando Modal, ecc.)Esempio: Identifica e sostituisci le API Java 7 deprecate con le loro equivalenti in Java 8. Analizza la codebase per potenziali miglioramenti del linguaggio e delle API di Java 8.

Risultato

Descrivi i risultati o i comportamenti attesi che Devin dovrebbe verificare, così che sappia quando l’attività è completata.Esempio: Esegui la suite di test e verifica che tutti i test vengano superati correttamente. Compila il progetto usando la configurazione aggiornata a Java 8 e verifica che l’applicazione sia attiva e funzionante.

​
Scelta delle attività giuste

Quando decidi cosa delegare a Devin, cerca attività che abbiano:
  1. Criteri di successo chiari
    • Attività il cui successo può essere verificato automaticamente
    • Cicli di feedback integrati (test, compilazione, controlli di linting)
    • Misure oggettive della qualità
  2. Ambito appropriato
    • Confini ben definiti e requisiti chiari
    • Pattern chiari da seguire nel tuo codebase
    • Come regola generale, le attività che ti richiederebbero tre ore o meno sono perfette
  3. Elementi ripetitivi
    • Attività che richiedono modifiche simili applicate molte volte
    • Varianti che rendono difficile affidarsi solo a script
    • Esempi esistenti da seguire
  4. Esempi comuni
    • Aggiornamenti di versione su più pacchetti
    • Aggiunta di copertura dei test a moduli non testati
    • Conversione di file per usare nuovi pattern/standard
    • Implementazione di componenti UI standard

​
Suddividi le attività complesse in sotto-attività più semplici, distribuite su più sessioni

Devin ha maggiori probabilità di avere successo se i progetti complessi vengono suddivisi in sotto-attività chiare. Ad esempio, invece di chiedere a Devin di aggiornare il codice della tua applicazione, la test suite e la configurazione CI in un’unica sessione, potresti suddividere il lavoro in tre sessioni distinte. Puoi eseguirle in parallelo chiedendo a Devin di delegare a Devin gestiti. Per attività particolarmente complesse, ti consigliamo di lavorare con Devin in più sessioni distinte, poiché le prestazioni di Devin a volte possono degradarsi man mano che la sessione si allunga.

​
Indica a Devin come verificare i propri progressi

Devin offre i risultati migliori quando riceve passaggi di verifica chiari per validare il proprio lavoro. Questo aiuta a garantire che l’attività venga completata correttamente e consente a Devin di individuare potenziali problemi in anticipo. Ecco un elenco non esaustivo di alcuni modi per aiutare Devin a verificare il proprio lavoro:
  1. Specifica i requisiti di test
    • Chiedi a Devin di eseguire suite di test specifiche
    • Definisci quali test devono passare
    • Richiedi, se rilevante, metriche di copertura dei test
  2. Definisci checkpoint e sotto-attività chiari
    • Suddividi attività complesse in sotto-attività verificabili e avvia una sessione Devin per ciascuna sotto-attività
    • Definisci cosa significa successo per ciascuna sotto-attività e, facoltativamente, i checkpoint all’interno di ogni sotto-attività
    • Chiedi a Devin di fornire un resoconto dopo aver completato ciascun checkpoint / sotto-attività
  3. Indica a Devin come controllare il proprio lavoro Chiarisci come Devin può verificare di essere sulla strada giusta. Ad esempio:
    • Quando lavori con dataset: “Verifica che il dataset abbia almeno 500 righe e contenga le colonne X, Y, Z”
    • Quando modifichi API: “Conferma che l’endpoint restituisca il codice di stato 200 e includa tutti i campi richiesti”
    • Quando aggiorni la UI: “Controlla che il componente venga visualizzato senza errori in console e che corrisponda alle specifiche di design”
Quanto più sei specifico riguardo ai requisiti di validazione, tanto più con sicurezza Devin potrà procedere con l’attività senza interventi.

​
Sii chiaro e specifico

Fornisci istruzioni e requisiti chiari e dettagliati per Devin. Ad esempio, prova a:
  1. Specificare i passaggi fondamentali necessari per completare un’attività
  2. Indicare i repository, le librerie, i branch specifici, ecc. con cui vuoi che Devin lavori
Per Devin niente è “troppo ovvio”, ma farà del suo meglio per chiarire i dettagli e porre domande durante il processo.

​
Usa i playbook

Per attività ripetitive o complesse, consigliamo di usare e perfezionare i playbook. I playbook sono prompt facilmente riutilizzabili e condivisibili. Ad esempio, se vuoi che Devin gestisca errori ricorrenti nelle build CI, puoi creare un playbook che includa i passaggi generali che Devin dovrebbe seguire ogni volta per risolvere il problema, senza doverli inserire in ogni prompt.

​
Fornisci riferimenti o esempi

Quando possibile, includi link a documentazione o esempi rilevanti per l’attività. Se non fornisci alcuna risorsa, Devin potrebbe cercare la documentazione in modo autonomo.

​
Inizia subito!

Fai domande a Devin e dagli istruzioni mentre lavora, proprio come faresti con qualsiasi altro collega!