Correggi con AI

Quando una build termina con link non funzionanti o pagine prive di descrizione, Jamdesk può correggerne molte per te. Il pulsante Fix with AI legge gli avvisi della build, propone una modifica concreta per ciascuno e applica le correzioni che approvi al repository GitHub connesso, avviando una nuova build. Questa pagina è destinata a chi gestisce un sito Jamdesk e vuole eliminare gli avvisi della build senza modificare manualmente i file MDX.

Gli screenshot mostrano l'interfaccia in inglese.

Per una versione locale, basata sul terminale, della stessa funzione, consulta il comando jamdesk fix della CLI. Il flusso della dashboard esegue il commit per te; la CLI scrive nella tua copia di lavoro e lascia a te il commit.

Cosa corregge

Fix with AI funziona su tre tipi di avvisi della build:

• Link interni non funzionanti. Un frammento di link che punta a un'intestazione non più esistente nella pagina di destinazione, ad esempio un errore di battitura (#instalation → #installation), oppure una pagina tradotta la cui intestazione è stata rinominata.
• Descrizioni di pagina mancanti. Una pagina senza description nel frontmatter. Jamdesk scrive per te un breve riepilogo basato sul contenuto della pagina, che puoi rivedere.
• Titoli di pagina mancanti. Per una pagina senza titolo viene suggerito un titolo basato sul contenuto, che puoi rivedere.

Viene proposta una modifica solo quando la destinazione può essere determinata con sicurezza. Gli elementi ambigui non vengono modificati e sono elencati separatamente, così puoi correggerli manualmente.

Prerequisiti

• Un repository GitHub connesso per il progetto.
• Accesso in scrittura per la GitHub App di Jamdesk, così può eseguire il commit delle correzioni. Se manca l'accesso, la finestra modale mostra un link Grant access che ti porta su GitHub per aggiungerlo.
• Una build completata con avvisi relativi a link non funzionanti o descrizioni mancanti.

Trova il banner

Apri il progetto e scorri fino a Build History nella pagina Project Home. Quando l'ultima build contiene problemi correggibili, sopra l'elenco delle build compare un banner con il conteggio e un pulsante Fix with AI.

Il banner compare solo sull'ultima build completata. Le build meno recenti della cronologia non lo mostrano, perché le correzioni vengono sempre applicate allo stato attuale della documentazione.

Rivedi e applica le correzioni

1

Apri l'anteprima

Fai clic su Fix with AI. Si apre la finestra modale e l'agente AI esamina la documentazione per creare un piano di correzione. L'operazione richiede alcuni secondi.

2

Leggi ogni modifica proposta

Le correzioni sono raggruppate per tipo. Broken links mostra ogni ancora riscritta, Missing descriptions mostra il riepilogo suggerito per ciascuna pagina e Missing titles mostra il titolo proposto. Deseleziona la casella degli elementi che preferisci saltare questa volta oppure usa il pulsante di ignorazione per disattivare definitivamente un suggerimento. I problemi senza una soluzione chiara compaiono in Can't be fixed automatically e dovrai gestirli manualmente.

3

Applica

Fai clic su Apply fixes. Jamdesk esegue il commit delle modifiche selezionate nel branch connesso, usando il messaggio docs: apply AI-suggested fixes (via Jamdesk), e avvia una nuova build.

4

Conferma la nuova build

Controlla la nuova build in Build History. Quando viene pubblicata, gli avvisi corretti scompaiono. Gli elementi rimasti sono avvisi che Fix with AI non ha potuto risolvere oppure nuovi problemi introdotti dai contenuti più recenti.

Quando alcuni problemi non possono essere corretti

Se un avviso non ha una soluzione chiara, la finestra modale lo elenca sotto un'intestazione separata e non lo modifica. Cause comuni:

• Un link non funzionante la cui pagina o intestazione di destinazione non esiste da nessuna parte, quindi non c'è alcuna destinazione a cui puntare.
• Una voce di navigazione senza un file sorgente corrispondente.
• Una pagina per cui l'agente non ha potuto generare automaticamente una descrizione.

Questi problemi richiedono una modifica manuale. Apri la pagina nell'editor o nel tuo editor di codice, correggi il link o aggiungi la descrizione, quindi esegui il push per avviare una nuova build.

Ignora i suggerimenti

Alcuni avvisi non richiedono interventi: ad esempio un link interrotto intenzionalmente o una pagina segnaposto che non necessita di descrizione. Deselezionare una correzione la salta solo una volta. Ignorarla la rimuove dal conteggio finché non decidi diversamente.

Ogni riga nella finestra modale, correggibile o meno, dispone di un pulsante di ignorazione. Fai clic sul pulsante e l'elemento viene spostato in una sezione Ignored compressa in fondo. Dopo aver chiuso la finestra modale, il conteggio del banner nella pagina Project Home diminuisce di conseguenza e gli avvisi corrispondenti scompaiono da Build History, nella build corrente e in tutte quelle successive. Ignore all applica lo stesso comportamento a tutti gli elementi ancora elencati.

Come funzionano gli elementi ignorati:

• Condivisi e persistenti. Gli elementi ignorati si applicano all'intero progetto, quindi tutti i membri vedono lo stesso elenco, che viene mantenuto tra le build. Jamdesk abbina ogni avviso in base al contenuto anziché al numero di riga, quindi la modifica di altre parti della pagina non ripristina un elemento ignorato.
• Ripristino. Espandi la sezione Ignored e fai clic su Restore per un elemento. Se ignori tutti gli elementi di una build, il banner scompare e un piccolo link «N ignored recommendations» sotto Build History riapre la finestra modale.
• Gli avvisi modificati ricompaiono. Se il problema sottostante cambia, ad esempio se il link non funzionante ora punta altrove, non corrisponde più all'elemento ignorato e viene mostrato di nuovo come nuovo suggerimento.

Fix with AI e CLI a confronto

Entrambi gli strumenti correggono le ancore dei link non funzionanti. Differiscono per il luogo di esecuzione e per il modo in cui viene applicata la modifica.

Usa il flusso della dashboard per una correzione rapida senza uscire da Jamdesk. Usa la CLI quando vuoi prima avere le modifiche nella tua copia di lavoro, ad esempio per raggrupparle con altre modifiche.

Cosa fare ora?