Abilità nella documentazione del progetto project-documentation
Scopri in che modo l’abilità nella documentazione dell’agente di modernizzazione dell’esperienza può aiutarti ad accelerare i passaggi di consegna dei progetti.
Accelerazione dei passaggi di consegna dei progetti project-handovers
L'agente di modernizzazione dell'esperienza può generare automaticamente guide alla documentazione del progetto per progetti AEM Edge Delivery Services che includono:
- Procedura dettagliata per il progetto - Spiegazione della configurazione, della struttura e delle convenzioni del progetto, generata senza sforzo manuale
- Organizzazione di moduli e componenti: documentazione chiara dell'organizzazione di blocchi, moduli e componenti e della loro relazione reciproca
- Guide per ruolo: documentazione mirata per autori, sviluppatori e amministratori, in modo che ogni membro del team ottenga esattamente ciò di cui ha bisogno
Questo semplifica i passaggi di gestione dei progetti per i progetti AEM Edge Delivery Services.
Prerequisiti prerequisites
Prima di utilizzare questa abilità, assicurati di quanto segue.
-
Il progetto deve essere estratto nell'area di lavoro nella console.
-
Devi disporre delle autorizzazioni di amministratore per il progetto per il quale stai creando la documentazione.
-
Le autorizzazioni dell’agente devono essere consentite nella console.
- Selezionare l'opzione Consenti a LLM di accedere a admin.hlx.page per conto dell'utente nelle impostazioni della console.
- Se questa opzione non è abilitata, l’agente genera la documentazione in base alla base di codice accessibile.
Creazione della documentazione del progetto creating-documentation
Una volta soddisfatti i prerequisiti, è sufficiente chiedere all’agente di creare la documentazione per il progetto.
-
Nella chat chiedi "Crea la documentazione di questo progetto".
-
Fornisci il nome dell’organizzazione del progetto, se l’agente lo richiede.
-
L’agente ti chiederà quale documentazione desideri creare. In genere, si selezionano Tutti.
-
Una volta create, le guide vengono inserite nell’area di lavoro. Selezionane una per visualizzare una descrizione e fai clic sul collegamento per scaricare il PDF completo.
Puoi salvare il PDF direttamente per fornirlo ai team o caricarlo come parte del resto del contenuto DA.
Risoluzione dei problemi troubleshooting
Di seguito sono riportati i messaggi di errore più comuni che si verificano quando si utilizza l’abilità di documentazione del progetto e le modalità per risolverli.
"Accesso negato" o "Non autorizzato" unauthorized
-
Causa: autorizzazioni amministratore o autorizzazioni agente mancanti non abilitate
-
Soluzione:
- Verifica di disporre dell’accesso come amministratore al progetto
- Selezionare l'opzione Consenti a LLM di accedere a admin.hlx.page per conto dell'utente nelle impostazioni della console.
"Progetto non trovato" not-found
-
Causa: archivio non estratto nell'area di lavoro
-
Soluzione:
- Estrai l’archivio del progetto
- Assicurati di trovarti nell’area di lavoro corretta
"Errore API di configurazione" api-error
-
Causa: impossibile accedere all'API del servizio di configurazione di Edge Delivery Services
-
Soluzione:
- Selezionare l'opzione Consenti a LLM di accedere a admin.hlx.page per conto dell'utente nelle impostazioni della console.
- Verifica la connessione di rete/VPN
- Conferma l’accesso come amministratore al progetto