Vai al contenuto principale

Nozioni di base su Knowledge

Knowledge è il modo migliore per condividere contesto a livello di codebase (anziché a livello di singolo task) che può aiutare Devin quando lavora nella tua codebase. Alcuni esempi di informazioni da inserire nella Knowledge di Devin includono pratiche di conformità del codice, flussi di deployment, convenzioni di naming per le PR, flussi di testing, modalità di interazione con strumenti proprietari e altro ancora. Alcune informazioni utili su Knowledge:
  • Devin genererà automaticamente la Knowledge del repo in base ai README esistenti, alla struttura dei file e ai contenuti dei repository collegati. Nota che, se non concedi a Devin l’accesso al repo, non genererà alcuna Knowledge associata.
  • La Knowledge viene richiamata in base al Trigger che imposti. Più specifico è il Trigger (ad es. a quale file, repo o tipo di task si applica la Knowledge), migliori saranno i risultati del recupero. Puoi trovare maggiori dettagli qui.
  • Devin ti dirà, all’interno di una sessione, quale Knowledge ha utilizzato; puoi vederlo sotto “Accessed Knowledge” nella chat della sessione.
  • Devin recupererà e aggiornerà automaticamente la Knowledge in base a file specializzati nella tua codebase, inclusi .rules, .mdc, .cursorrules e .windsurf. Nota che Devin non recupererà automaticamente file di tipo più generale come .md.

Best practice per l’onboarding della Knowledge

È utile dedicare un po’ di tempo inizialmente per mettere Devin al passo. Proprio come per una nuova assunzione, condividere il contesto rilevante sul codebase e sui flussi di lavoro seguiti dal team di ingegneria contribuirà in modo significativo a rendere Devin più efficace. Ecco alcuni passaggi consigliati da seguire quando configuri per la prima volta la Knowledge di Devin:
  1. Esamina tutta la Knowledge generata automaticamente e verifica che sia (a) completa e (b) accurata.
  2. Se vuoi che Devin recuperi la nota Knowledge ogni volta che lavora su una sessione, assicurati di fissarla (pin) su tutti i repository. In caso contrario, puoi fissarla a un singolo repo se le informazioni sono rilevanti solo in quel contesto. Se la Knowledge non è fissata, verrà utilizzata solo quando viene attivata, quindi assicurati che la tua Trigger Description sia chiara.
  3. Se non hai un file di documentazione centralizzato e dedicato nel tuo codebase, ti consigliamo vivamente di crearne uno con un’estensione di file specifica.
Visita la guida al prodotto Knowledge per maggiori dettagli.