> ## Documentation Index > Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt > Use this file to discover all available pages before exploring further. # Analisi delle sessioni > Analizza le tue sessioni con Devin e ottieni feedback pratici per migliorare le interazioni future

## Che cos'è l'approfondimento sulla sessione?

L'approfondimento sulla sessione è una funzionalità di analisi che ti aiuta a capire cosa è successo nelle tue sessioni con Devin e fornisce raccomandazioni operative per migliorarle. Quando attivi un'analisi, l'approfondimento sulla sessione esamina la sessione per identificare schemi, problemi e opportunità per una collaborazione migliore. L'approfondimento sulla sessione è disponibile per tutte le sessioni di Devin completate senza costi aggiuntivi. Quando una sessione termina, Devin genera automaticamente una classificazione leggera (categoria, linguaggi e strumenti). Per le sessioni di grandi dimensioni (L o XL), al teardown viene generata automaticamente anche un'analisi completa. Per le sessioni più piccole, puoi attivare manualmente un'analisi completa tramite l'interfaccia utente o tramite l'[API](/it/api-reference/v3/sessions/post-organizations-session-insights-generate).

## Come accedere a Session Insights

### Passaggio 1: Completa una sessione

Avvia una sessione di Devin e lasciala arrivare al termine. Session Insights funziona al meglio con sessioni che hanno esiti chiari, indipendentemente dal fatto che siano state completate con successo o meno. Le sessioni troppo brevi (meno di un messaggio di Devin) non genereranno alcun insight. Al termine della sessione, cerca il pulsante **Session Insights** nella barra superiore della sessione.

### Passaggio 3: Genera o visualizza l'analisi

Fai clic sul pulsante per aprire la finestra modale Session Insights. Se non è ancora stata generata un'analisi, fai clic su **Generate Analysis** per avviare la generazione. La generazione richiede di solito circa un minuto. Se esiste già un'analisi, puoi fare clic su **Regenerate** per crearne una nuova. Finestra modale degli insight sulla sessione

Finestra modale degli insight sulla sessione

## Metriche di riepilogo della sessione

Nella parte superiore della finestra modale Session Insights, quattro metriche chiave offrono una rapida istantanea della sessione: Session Insight Cards

### Utilizzo di ACU

L'utilizzo di ACU (unità di calcolo dell'agente) riflette la quantità di capacità di calcolo che Devin ha consumato durante la sessione. Un utilizzo di ACU inferiore per una determinata attività in genere indica una sessione più efficiente. Usa questa metrica per confrontare attività simili e identificare le sessioni in cui Devin potrebbe aver utilizzato una quantità eccessiva di capacità di calcolo in tentativi ripetuti o in vicoli ciechi.

### Messaggi dell'utente

Il numero totale di messaggi che hai inviato durante la sessione. Un numero elevato di messaggi può indicare che Devin ha avuto bisogno di frequenti correzioni di rotta, suggerendo che il prompt iniziale avrebbe potuto essere più dettagliato. Idealmente, fornisci subito tutto il contesto importante per ridurre al minimo gli scambi.

### Dimensione della sessione

La dimensione della sessione è una classificazione composita (XS, S, M, L, XL) basata sia sull'utilizzo di ACU sia sul numero di messaggi dell'utente. Un utilizzo più elevato di ACU o un numero maggiore di messaggi dell'utente possono aumentare la dimensione della sessione. Le soglie per ciascuna categoria di dimensione sono: | Dimensione | Soglia ACU | Soglia dei messaggi dell'utente | | ---------- | ---------- | ------------------------------- | | **XS** | ≤ 2 ACU | ≤ 2 messaggi | | **S** | ≤ 5 ACU | ≤ 5 messaggi | | **M** | ≤ 10 ACU | ≤ 10 messaggi | | **L** | ≤ 20 ACU | ≤ 20 messaggi | | **XL** | > 20 ACU | > 20 messaggi | Per i clienti Enterprise, le soglie ACU vengono moltiplicate per 10 (ad esempio, XS ≤ 20 ACU, S ≤ 50, M ≤ 100, L ≤ 200, XL > 200). Le soglie dei messaggi dell'utente restano invariate. La dimensione complessiva della sessione è la **maggiore** tra la dimensione basata sugli ACU e quella basata sui messaggi. Le sessioni classificate come **L** o **XL** vengono contrassegnate come problematiche, il che significa che Devin probabilmente ha riscontrato problemi significativi oppure che l'ambito dell'attività era troppo ampio per una singola sessione. Valuta di suddividere le attività di ampia portata in sessioni più piccole e mirate. Per mantenere le sessioni contenute ed efficienti, fornisci tutte le informazioni importanti subito nel prompt iniziale.

### Categoria

Devin classifica automaticamente le sessioni in categorie di attività in base al lavoro svolto. La classificazione include anche metadati come gli **strumenti e i framework** utilizzati e i **linguaggi di programmazione** coinvolti. Le categorie di attività disponibili sono: * **Sviluppo di funzionalità** — sviluppo di nuove funzionalità, componenti o servizi, oppure implementazione di nuove capacità * **Correzione di bug** — analisi e risoluzione di bug, errori o comportamenti imprevisti * **Revisione del codice** — revisione, spiegazione o analisi del codice e dell'architettura esistenti * **Refactoring e ottimizzazione** — miglioramento della struttura, delle prestazioni o della leggibilità del codice senza modificarne il comportamento * **Generazione di test** — scrittura, correzione o miglioramento di test (unit, integrazione, e2e, QA) e dell'infrastruttura di test * **Migrazioni e aggiornamenti** — aggiornamento delle dipendenze, migrazione tra framework o versioni * **CI/CD e DevOps** — attività su pipeline CI/CD, distribuzione, monitoraggio, alerting e infrastruttura * **Sicurezza** — correzione di vulnerabilità di sicurezza, gestione dei CVE e miglioramento del profilo di sicurezza * **Dati e automazione** — analisi dei dati, pipeline, scripting, dashboard e attività di automazione * **Documentazione e contenuti** — scrittura o aggiornamento di documentazione, README, changelog, documentazione API e traduzioni * **Ricerca ed esplorazione** — valutazione della fattibilità, ricerca di soluzioni, progettazione dell'architettura, scrittura di RFC e prototipazione Questa classificazione ti aiuta a capire come Devin ha interpretato la tua attività e può evidenziare eventuali disallineamenti tra ciò che intendevi e ciò su cui Devin ha lavorato.

## Schede di analisi

La finestra modale Session Insights contiene tre schede, ognuna incentrata su un diverso aspetto dell'analisi.

### Cronologia dei problemi

La scheda Cronologia dei problemi contiene due sezioni: **Problemi rilevati** elenca i problemi che Devin ha incontrato durante la sessione. Ogni problema include: * Un'**etichetta** che descrive la categoria del problema * Una valutazione dell'**impatto** (alto, medio o basso) * Una **descrizione** che spiega cosa è andato storto I problemi sono raggruppati per etichetta e livello di impatto, semplificando l'individuazione di schemi ricorrenti. Tra le tipologie di problemi più comuni ci sono errori di build, problemi di configurazione dell'ambiente, assunzioni errate sulla codebase e ambiguità dell'ambito. **Timeline** fornisce una vista cronologica, codificata a colori, degli eventi chiave durante la sessione: | Color | Meaning | | ---------- | ------------------------ | | Red | Problema ad alto impatto | | Yellow | Problema a impatto medio | | White/Gray | Evento significativo | | Green | Valore fornito | Ogni evento nella timeline ha un titolo e una descrizione. Gli eventi collegati a problemi specifici sono visualizzati in grassetto. Usa la timeline per comprendere il flusso della sessione — dove Devin ha fatto progressi, dove ha incontrato ostacoli e come si è ripreso.

### Feedback operativo

La scheda Feedback operativo ti aiuta a migliorare le sessioni future in due modi: **Improved Prompt** mostra una versione riscritta del tuo prompt originale con miglioramenti mirati. Il prompt suggerito viene visualizzato con evidenziazione interattiva: passa il puntatore del mouse su una sezione sottolineata per vedere cosa è cambiato e perché. Un elenco numerato di **Modifiche apportate** sotto il prompt spiega ogni modifica: * Aggiungere contesto o vincoli che mancavano rispetto all’originale * Chiarire istruzioni ambigue * Includere criteri di successo o requisiti specifici * Portare in primo piano informazioni importanti di cui Devin aveva bisogno prima Fai clic su **Start new session** per avviare una nuova sessione di Devin precompilata con il prompt migliorato. **Action Items** elenca le modifiche di configurazione consigliate per migliorare le sessioni future. Si tratta di passaggi concreti che puoi eseguire nella tua [configurazione dell’ambiente](/it/onboard-devin/environment) o nella configurazione di [Knowledge](/it/product-guides/knowledge): * **Machine setup** — modifiche all’ambiente o agli strumenti (ad esempio installazione di dipendenze mancanti, configurazione degli accessi) * **Repo config** — modifiche a livello di repository (ad esempio aggiunta di script di build, aggiornamento dei file di configurazione) Fai clic su **Go to machine** per passare direttamente alla configurazione della tua macchina e applicare le modifiche suggerite.

### Utilizzo di Knowledge

La scheda Knowledge Usage mostra come i tuoi elementi di [Knowledge](/it/product-guides/knowledge) sono stati utilizzati durante la sessione: **Knowledge utile** elenca gli elementi di Knowledge che hanno aiutato Devin a completare correttamente l'attività, con una spiegazione di come è stato applicato ciascun elemento. **Knowledge fuorviante** elenca gli elementi di Knowledge che hanno sviato Devin o che contenevano informazioni obsolete o errate. Ogni voce spiega perché l'elemento di Knowledge è stato dannoso, aiutandoti a individuare quelli che richiedono un aggiornamento o la rimozione. Fai clic su qualsiasi elemento di Knowledge per accedervi direttamente e modificarlo. La revisione regolare di questa scheda ti aiuta a mantenere una base di conoscenza di alta qualità.

## Interpretazione degli schemi di Insight più comuni

### Utilizzo elevato di ACU con pochi messaggi utente

Di solito questo significa che Devin ha lavorato in modo autonomo ma ha avuto difficoltà con l'attività. Controlla la Issue Timeline per errori ricorrenti o tentativi ripetuti. Cause comuni: * Configurazione dell'ambiente incompleta (dipendenze, API key, credenziali di accesso) * Requisiti ambigui che hanno portato ad approcci per tentativi ed errori * Attività complesse che trarrebbero vantaggio dall'essere suddivise in sotto-attività **Cosa fare:** Esamina l'Improved Prompt per suggerimenti su come aggiungere contesto. Controlla gli Action Items per modifiche alla configurazione della macchina o del repo.

### Molti messaggi utente con basso consumo di ACU

Questo suggerisce frequenti interruzioni o correzioni di rotta. Devin ha usato poche risorse di calcolo ma ha avuto bisogno di una guida costante. Cause comuni: * Prompt iniziale poco dettagliato * Devin ha frainteso l'ambito o i requisiti dell'attività * L'attività richiedeva conoscenze specifiche di dominio non disponibili a Devin **Cosa fare:** Usa il Prompt migliorato come modello per attività simili future. Aggiungi i dettagli rilevanti al tuo [Knowledge](/it/product-guides/knowledge) in modo che Devin possa accedervi automaticamente.

### Knowledge fuorviante contrassegnata

Quando la scheda Knowledge Usage mostra elementi di Knowledge fuorvianti, questi elementi possono contenere istruzioni obsolete o indicazioni troppo generiche che vanno in conflitto con l'attuale codebase. Cause comuni: * Knowledge è stata scritta per una versione precedente della tua codebase * Knowledge è troppo generica e viene recuperata in contesti irrilevanti * Knowledge è in conflitto con altri elementi di Knowledge **Cosa fare:** Aggiorna o elimina gli elementi di Knowledge contrassegnati. Rendi le descrizioni dei trigger di Knowledge più specifiche per evitare recuperi irrilevanti.

### Sessione classificata nella categoria sbagliata

Se la categoria mostrata nel riepilogo non corrisponde a ciò che intendevi, probabilmente significa che Devin ha interpretato la tua richiesta in modo diverso. Cause comuni: * Il prompt era ambiguo rispetto all'obiettivo * La descrizione dell'attività era focalizzata su un aspetto, ma l'intento era diverso (ad es. descrivere un bug quando volevi una feature) **Cosa fare:** Confronta la categoria con il tuo intento. Usa l'Improved Prompt per vedere come l'analisi suggerisce di chiarire l'obiettivo dell'attività.

### La timeline mostra problemi ripetuti

Quando lo stesso tipo di problema compare più volte nella timeline, è probabile che Devin sia rimasto bloccato in un ciclo di tentativi. Cause comuni: * Un errore di build o di test persistente che Devin non è riuscito a risolvere * Un problema dell'ambiente (strumento mancante, versione errata, errore di permessi) * Una comprensione fondamentale errata dell'approccio necessario **Cosa fare:** Controlla gli Action Items per eventuali correzioni dell'ambiente. Valuta di aggiungere un elemento di [Knowledge](/it/product-guides/knowledge) che spieghi l'approccio corretto per questo tipo di attività.

## Buone pratiche

### Rivedi gli Insights dopo le sessioni complesse

Abituati a controllare gli Insights di sessione dopo le sessioni importanti o complesse. Gli schemi che identificherai ti aiuteranno a diventare più efficace nel tempo.

### Applica i Miglioramenti ai Prompt in Modo Iterativo

Usa i prompt migliorati suggeriti come punto di partenza per attività future simili. Con il tempo svilupperai una libreria di schemi di prompt efficaci. Salva i tuoi prompt migliori come [Playbooks](/it/product-guides/creating-playbooks) per flussi di lavoro ripetibili.

### Mantieni aggiornata la tua base di Knowledge

Rivedi regolarmente la scheda Knowledge Usage per mantenere accurati e pertinenti gli elementi in Knowledge. Rimuovi o aggiorna tempestivamente qualsiasi informazione fuorviante in Knowledge: anche un singolo elemento obsoleto può compromettere la qualità delle sessioni per tutto il tuo team.

### Risolvi i problemi ricorrenti tramite la configurazione della macchina

Se gli Action Items suggeriscono ripetutamente le stesse modifiche all'ambiente o alla configurazione, affrontale in modo proattivo. Configurare correttamente la [configurazione dell'ambiente](/it/onboard-devin/environment) evita problemi ripetuti in tutte le sessioni future. Session Insights può rivelare schemi che portano vantaggi all’intera organizzazione. Aggiungi le informazioni principali come [Knowledge](/it/product-guides/knowledge) così che i tuoi colleghi possano beneficiarne.

### Mantieni le sessioni mirate

Se le tue sessioni vengono costantemente classificate come L o XL, suddividi le attività più grandi in sessioni più piccole e mirate. Le sessioni più piccole tendono a produrre risultati migliori e facilitano l’analisi e l’iterazione.

## Risoluzione dei problemi

### Nessun insight disponibile

Se Session Insights non è disponibile per una sessione, potrebbe essere perché: * L'analisi non è stata ancora attivata — fai clic su **Generate Analysis** nella finestra modale Session Insights oppure usa l'[endpoint API per la generazione](/it/api-reference/v3/sessions/post-organizations-session-insights-generate) * La sessione è ancora in corso * La sessione era troppo breve per generare un'analisi significativa (meno di un messaggio di Devin) * Si è verificato un errore durante il processo di analisi — prova a fare clic su **Regenerate**

### L'analisi richiede troppo tempo

La generazione dell'analisi di solito si completa entro un minuto. Se è in corso da più di cinque minuti, il processo potrebbe essere andato in timeout. Chiudi e riapri la finestra modale Session Insights, quindi fai clic su **Regenerate**.

### Analizza con Devin

Il pulsante **Analizza con Devin** nella finestra modale Session Insights apre una nuova sessione di Devin preconfigurata per analizzare in profondità la sessione originale. Utilizzala per le sessioni in cui la sola analisi automatica non spiega completamente cosa è successo.