Che cos’è Knowledge?
Proprio come per l’onboarding di un nuovo ingegnere, l’onboarding di Devin richiede un investimento iniziale nel trasferimento di conoscenze. Knowledge è una raccolta di suggerimenti, consigli e istruzioni che Devin può consultare in tutte le sessioni. Puoi continuare ad arricchire nel tempo il patrimonio di Knowledge di Devin e Devin richiamerà automaticamente le informazioni pertinenti quando necessario. Usa la funzionalità Knowledge per condividere documentazione, suggerimenti, librerie interne personalizzate e altri materiali di cui Devin potrebbe avere bisogno.Come posso creare un elemento di Knowledge?
Vai a Settings → Resources → Knowledge e fai clic su Crea Knowledge in alto a destra. La tua Trigger Description aiuterà Devin a richiamare la Knowledge pertinente nei momenti opportuni. Può essere una semplice frase o una breve descrizione. Devin recupererà un elemento di Knowledge quando il lavoro corrente è correlato ai trigger specificati e tutti gli elementi di Knowledge richiedono una Trigger Description. Il contenuto dovrebbe contenere alcune frasi con informazioni pertinenti.Macro
Puoi assegnare una macro a qualsiasi elemento di Knowledge: un identificatore breve che inizia con! (ad esempio !deploy-checklist). Le macro ti consentono di fare rapidamente riferimento a Knowledge nei prompt digitando il nome della macro. Le macro possono contenere solo lettere, numeri e trattini e devono essere univoche all’interno della tua organizzazione.
Abilitare e disabilitare Knowledge
Ogni elemento di Knowledge può essere abilitato o disabilitato singolarmente per utente. Disabilitare un elemento di Knowledge impedisce a Devin di recuperarlo nelle tue sessioni, senza eliminarlo dall’organizzazione. È utile quando un elemento di Knowledge è temporaneamente non pertinente al tuo lavoro, ma potrebbe essere utile ai compagni di team o in futuro.Suggerimenti di Knowledge
Devin suggerirà automaticamente elementi di Knowledge da memorizzare in base ai feedback che fornisci in chat. Modifica il Knowledge suggerito prima di salvarlo oppure ignora il Knowledge se non è utile. Puoi anche chiedere a Devin di rigenerare un suggerimento di Knowledge in base ai tuoi feedback. Questo può rendere più semplice iterare sui suggerimenti di Knowledge invece di modificarli manualmente. Devin può anche suggerire aggiornamenti agli elementi di Knowledge esistenti, oltre a proporre nuovi elementi di Knowledge.Cosa includere in Knowledge?
Consigliamo di includere gli aspetti dei tuoi prompt o playbook che ti ritrovi a ripetere regolarmente. Ad esempio: bug comuni e le relative soluzioni, pratiche di conformità del codice, workflow di deployment, workflow di testing, come interagire con strumenti proprietari, ecc.Organizzare Knowledge con le cartelle
Puoi organizzare gli elementi di Knowledge in cartelle per gestirli più facilmente. Le cartelle supportano:- Gerarchia annidata — Crea sottocartelle per costruire un albero di Knowledge strutturato.
- Abilitazione/disabilitazione in blocco — Attiva o disattiva un’intera cartella. Quando una cartella è disabilitata, tutti gli elementi di Knowledge al suo interno vengono disabilitati per la tua sessione.
- Spostamento degli elementi — Trascina gli elementi di Knowledge tra le cartelle oppure usa l’azione di spostamento per riorganizzarli.
- Organizzazione automatica — Seleziona più elementi di Knowledge e lascia che Devin li organizzi automaticamente in cartelle logiche.
Suggerimenti e trucchi
- Crea Knowledge specifiche mirate a un singolo workflow o a una singola azione. Devin leggerà l’intero contenuto della Knowledge, quindi assicurati che sia tutto pertinente e aggiornato!
- Suddividi la tua Knowledge in unità più piccole quando possibile. Devin è in grado di accedere a più “elementi” di Knowledge contemporaneamente.
- Prendi l’abitudine di aggiungere e aggiornare le Knowledge. Queste sono condivise all’interno della tua organizzazione e miglioreranno continuamente Devin per il tuo team nel tempo.
- Devin recupera la Knowledge quando pertinente, non tutta in una volta né solo all’inizio. Assicurati che la condizione di attivazione del recupero sia altamente pertinente rispetto ai contenuti.
- Usa le cartelle per raggruppare Knowledge correlate (ad esempio per progetto, team o workflow), così puoi abilitare o disabilitare rapidamente gruppi di Knowledge man mano che cambia il tuo focus.
Knowledge a livello di organizzazione ed enterprise
Knowledge può essere limitato all’ambito di una singola organizzazione oppure esteso all’intero enterprise. Ciò che viene mostrato nella pagina Knowledge dipende dall’organizzazione in cui ti trovi:- Organizzazioni non primarie — La pagina Knowledge presenta due tab:
- Organization (predefinito) — Elementi di Knowledge con ambito l’organizzazione corrente. Sono visibili a tutti i membri dell’organizzazione e rappresentano l’ambito predefinito per i nuovi elementi di Knowledge.
- Suggestions — Suggerimenti di knowledge generati dall’IA in base alle tue interazioni nelle sessioni.
- Organizzazione primaria — La pagina Knowledge mostra un’unica vista della knowledge enterprise, senza tab. La knowledge enterprise si applica a tutte le organizzazioni del tuo enterprise e gli amministratori Enterprise la creano e la gestiscono da qui.
Le organizzazioni non primarie non dispongono di un tab Enterprise. Se la tua organizzazione appartiene a un enterprise, usa il collegamento Looking for enterprise knowledge? nella pagina Knowledge per aprire la knowledge enterprise nell’organizzazione primaria del tuo enterprise.
Promuovere la Knowledge dell’organizzazione in Enterprise
Se un elemento di Knowledge a livello di organizzazione si rivela abbastanza utile da essere condiviso in tutta la tua Enterprise, puoi promuoverlo direttamente dall’editor di Knowledge. Apri l’elemento, quindi fai clic su Promuovi in Enterprise nella scheda Dettagli. L’elemento viene spostato dall’ambito dell’organizzazione all’ambito Enterprise e diventa disponibile per tutte le organizzazioni della tua Enterprise. La promozione richiede autorizzazioni per la gestione della Knowledge a livello Enterprise ed è disponibile solo per gli elementi di Knowledge creati dagli utenti nelle organizzazioni che appartengono a una Enterprise.Associare Knowledge ai repo
Puoi scegliere se applicare Knowledge a nessun repo, a uno specifico repo o a tutti i repo:- Associazione a nessun repo: Knowledge viene recuperata solo quando Devin la ritiene rilevante per il tuo contesto attuale.
- Associazione a uno specifico repo: Knowledge viene sempre utilizzata ogni volta che Devin lavora in quello specifico repo.
- Associazione a tutti i repo: Knowledge si applica automaticamente a ogni repo su cui Devin sta lavorando in qualsiasi sessione.
FAQ sulla migrazione da Knowledge a Skills
Le note di Knowledge verranno dismesse a favore delle Skills, il metodo standard per fornire a Devin istruzioni riutilizzabili. Devin sta già convertendo automaticamente le tue note in skill. Il giorno del passaggio non cambierà nulla per il tuo team e non dovrai intervenire in alcun modo.Come una nota viene mappata a una skill
Ad esempio, questa nota:
diventa questa skill:
SKILL.md
Domande frequenti
Devin si comporta in modo diverso?
Devin si comporta in modo diverso?
No. Le skill migrate vengono caricate in base alla loro descrizione, esattamente come le note venivano caricate in base al loro trigger.
Dove trovo le skill migrate?
Dove trovo le skill migrate?
Nell’app Devin, in Customize → Plugins → Knowledge, raggruppate secondo le tue cartelle originali.
Dove sono archiviate le skill?
Dove sono archiviate le skill?
In Devin, proprio come le tue note. A differenza delle skill di cui esegui il commit in un repository come file
SKILL.md, le skill migrate risiedono in plugin gestiti da Devin, non nei tuoi repository. Nei tuoi repo non viene eseguito alcun commit e non devi aggiungere né gestire alcun file.Come modifico una skill migrata?
Come modifico una skill migrata?
Vai su Customize → Skills e apri la skill per modificarla. Le skill dell’organizzazione possono essere modificate dagli amministratori dell’organizzazione e dai membri con l’autorizzazione Manage Knowledge; le skill enterprise, dagli amministratori Enterprise.
Come devo aggiungere indicazioni d'ora in poi?
Come devo aggiungere indicazioni d'ora in poi?
Scrivi delle Skills. Funzionano ovunque venga eseguito Devin: nella web app, nella CLI e in Devin Desktop.
Per gli utenti dell’API
Quali endpoint dell'API sono interessati?
Quali endpoint dell'API sono interessati?
Gli endpoint delle note di Knowledge
/v3/organizations/{org_id}/knowledge/notes[/{note_id}] e /v3/enterprise/knowledge/notes[/{note_id}], oltre ai corrispondenti endpoint /knowledge/folders.Cosa li sostituisce?
Cosa li sostituisce?
Per le note, gli endpoint delle skill (v3 beta), disponibili in
/v3beta1/organizations/{org_id}/managed-plugins e /v3beta1/enterprise/managed-plugins:Gli endpoint di elenco supportano la paginazione tramite
first e after, come gli altri endpoint v3.Come accedo a una nota migrata tramite l'API?
Come accedo a una nota migrata tramite l'API?
Le note migrate si trovano nel bundle
knowledge, identificate dal rispettivo slug. Puoi elencarle tutte con GET .../managed-plugins/bundles/knowledge/skills oppure recuperarne una con GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging.