> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge

> Fai l'onboarding di Devin con Knowledge: condividi consigli, documentazione e istruzioni che Devin ricorda tra le sessioni, con ambito repo, organizzazione o enterprise.

<Warning>
  Knowledge è deprecato e verrà rimosso in un aggiornamento futuro. La Knowledge esistente viene migrata automaticamente alle [Skills nei Plugins](/it/product-guides/plugins): la migrazione è in fase di distribuzione graduale e non richiede alcuna azione da parte tua. Usa le Skills per le nuove istruzioni e il contesto che vuoi condividere con Devin. Per maggiori dettagli, consulta le [FAQ sulla migrazione](#knowledge-to-skills-migration-faq).
</Warning>

<h2 id="what-is-knowledge">
  Che cos'è Knowledge?
</h2>

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.

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-add-knowledge.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a0d91cc2095f798e31fb3e182812f63d" data-path="images/feature-add-knowledge.mp4" />

Usa la funzionalità Knowledge per condividere documentazione, suggerimenti, librerie interne personalizzate e altri materiali di cui Devin potrebbe avere bisogno.

<h2 id="how-do-i-create-knowledge">
  Come posso creare un elemento di Knowledge?
</h2>

Vai a [**Settings → Resources → Knowledge**](https://app.devin.ai/settings/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.

<h3 id="macros">
  Macro
</h3>

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.

<h3 id="enabling-and-disabling-knowledge">
  Abilitare e disabilitare Knowledge
</h3>

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.

<h2 id="knowledge-suggestions">
  Suggerimenti di Knowledge
</h2>

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.

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/feature-knowledge-suggestions.mp4?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=a09d259bd828f60086f982d8f0ddf5a4" data-path="images/feature-knowledge-suggestions.mp4" />

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.

<h2 id="what-belongs-in-knowledge">
  Cosa includere in Knowledge?
</h2>

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.

<h2 id="organizing-knowledge-with-folders">
  Organizzare Knowledge con le cartelle
</h2>

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.

Le cartelle sono particolarmente utili quando la tua organizzazione ha un gran numero di elementi di Knowledge distribuiti tra team, progetti o workflow.

<h2 id="tips-and-tricks">
  Suggerimenti e trucchi
</h2>

1. 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.
2. 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.
3. 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.
4. 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.

<h2 id="organization-and-enterprise-knowledge">
  Knowledge a livello di organizzazione ed enterprise
</h2>

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.

<Note>
  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.
</Note>

Gli elementi di Knowledge enterprise sono particolarmente utili per condividere standard di codifica aziendali, linee guida architetturali, procedure di distribuzione e altre informazioni di contesto che devono valere in modo uniforme per tutti i team e tutte le organizzazioni.

<h3 id="promoting-organization-knowledge-to-enterprise">
  Promuovere la Knowledge dell'organizzazione in Enterprise
</h3>

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.

<h2 id="pinning-knowledge-to-repos">
  Associare Knowledge ai repo
</h2>

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.

<h2 id="knowledge-to-skills-migration-faq">
  FAQ sulla migrazione da Knowledge a Skills
</h2>

Le note di Knowledge verranno dismesse a favore delle [Skills](/it/product-guides/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.**

<h3 id="how-a-note-maps-to-a-skill">
  Come una nota viene mappata a una skill
</h3>

| Nota di Knowledge | Skill | Dettagli |
| - | - | - |
| **Nome** | Nome e titolo della skill | |
| **Trigger** | Descrizione della skill | Copiato così com'è, preceduto dal nome della nota. Devin legge la descrizione per decidere quando caricare la skill, esattamente come avveniva con il trigger. |
| **Contenuto** | Corpo della skill | Copiato alla lettera, senza alcuna riscrittura. |
| **Livello** (enterprise, organizzazione o personale) | Stesso livello | Un plugin **Knowledge** per ogni livello, visibile alle stesse persone. |
| **Cartella** | Conservata nei metadati della skill | Mostrata nel plugin con la stessa struttura di cartelle. |
| **Repository bloccato** | Conservato nei metadati della skill | |

Ad esempio, questa nota:

| Campo | Valore |
| - | - |
| Nome | Deploying to staging |
| Trigger | when deploying or debugging the staging environment |
| Contenuto | Run `make deploy-staging`, then check… |
| Cartella | Infra/Deploys |

diventa questa skill:

```markdown SKILL.md theme={null}
---
name: deploying-to-staging
description: "Deploying to staging. Use when deploying or debugging the staging environment."
user-invocable: false
metadata:
  devin:
    from_knowledge: true
    knowledge_folder: "Infra/Deploys"
---

# Deploying to staging

Run `make deploy-staging`, then check…
```

<h3 id="faq">
  Domande frequenti
</h3>

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Dove trovo le skill migrate?">
    Nell'app Devin, in [**Customize → Plugins → Knowledge**](https://app.devin.ai/customize), raggruppate secondo le tue cartelle originali.
  </Accordion>

  <Accordion title="Dove sono archiviate le skill?">
    In Devin, proprio come le tue note. A differenza delle [skill di cui esegui il commit in un repository](/it/product-guides/skills) come file `SKILL.md`, le skill migrate risiedono in [plugin](/it/product-guides/plugins) gestiti da Devin, non nei tuoi repository. Nei tuoi repo non viene eseguito alcun commit e non devi aggiungere né gestire alcun file.
  </Accordion>

  <Accordion title="Come modifico una skill migrata?">
    Vai su [**Customize → Skills**](https://app.devin.ai/customize) 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.
  </Accordion>

  <Accordion title="Come devo aggiungere indicazioni d'ora in poi?">
    Scrivi delle [Skills](/it/product-guides/skills). Funzionano ovunque venga eseguito Devin: nella web app, nella CLI e in Devin Desktop.
  </Accordion>
</AccordionGroup>

<h3 id="for-api-users">
  Per gli utenti dell'API
</h3>

<AccordionGroup>
  <Accordion title="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`.
  </Accordion>

  <Accordion title="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`:

    | Endpoint | Funzione |
    | - | - |
    | `GET /bundles` | Elenca i tuoi plugin, ciascuno con il relativo `bundle_id` e `revision_token`. |
    | `GET /bundles/{bundle_id}/skills` | Elenca tutte le skill di un plugin, ciascuna con il relativo `SKILL.md` completo. Sostituisce l'elenco delle note. |
    | `GET` / `PUT` / `DELETE` `/bundles/{bundle_id}/skills/{skill_name}` | Legge, scrive o elimina una singola skill. `PUT` accetta il `SKILL.md` completo nel campo `content`. |

    Gli endpoint di elenco supportano la paginazione tramite `first` e `after`, come gli altri endpoint v3.
  </Accordion>

  <Accordion title="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`.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.