Creazione di un problema in CodeCatalyst

I team di sviluppo creano problemi per monitorare e gestire il proprio lavoro. Puoi creare problemi all'interno di un progetto in base alle tue esigenze. Ad esempio, potresti creare un problema per tenere traccia dell'aggiornamento di una variabile nel codice. Puoi assegnare problemi ad altri utenti del progetto, utilizzare etichette per monitorare il tuo lavoro e altro ancora.

Segui queste istruzioni per creare un problema in CodeCatalyst.

Per creare un problema

1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

2. Vai al progetto in cui desideri creare un problema.

3. Nella home page del progetto, scegli Crea problema. In alternativa, nel riquadro di navigazione, scegli Problemi.

4. Scegli Crea problema.

   Nota

   Puoi anche aggiungere problemi in linea quando usi una visualizzazione a griglia.

5. Inserisci un titolo per il problema.

6. (Facoltativo) Inserisci una descrizione. Puoi usare Markdown per aggiungere la formattazione.

7. (Facoltativo) Scegli uno stato, una priorità e una stima per il problema.

   Nota

   Se l'impostazione di stima del progetto è impostata su Nascondi stime, non sarà presente un campo Stima.

8. (Facoltativo) Aggiungi attività al problema. Le attività possono essere utilizzate per suddividere il lavoro di un problema in obiettivi più piccoli. Per aggiungere un'attività, scegli + Aggiungi attività. Quindi, inserisci il nome dell'attività nel campo di testo e premi invio. Dopo aver aggiunto le attività, puoi contrassegnarle come complete selezionando la casella di controllo o riordinarle scegliendo e trascinando l'attività dal lato sinistro della casella di controllo.

9. (Facoltativo) Aggiungi un'etichetta esistente o crea una nuova etichetta e aggiungila scegliendo + Aggiungi etichetta.

   1. Per aggiungere un'etichetta esistente, scegli l'etichetta dall'elenco. Puoi inserire un termine di ricerca nel campo per cercare tutte le etichette che contengono quel termine nel progetto.

   2. Per creare una nuova etichetta e aggiungerla, inserisci il nome dell'etichetta che desideri creare nel campo di ricerca e premi invio.

10. (Facoltativo) Aggiungi un assegnatario selezionando + Aggiungi un assegnatario. Puoi aggiungerti rapidamente come assegnatario selezionando + Aggiungimi.

    Suggerimento

    Puoi scegliere di assegnare un problema ad Amazon Q per fare in modo che Amazon Q provi a risolverlo. Per ulteriori informazioni, consulta Tutorial: Utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo. Questa funzionalità è disponibile solo nella regione Stati Uniti occidentali (Oregon).

    Questa funzionalità richiede che le funzionalità di intelligenza artificiale generativa siano abilitate per lo spazio. Per ulteriori informazioni, consulta Gestione delle funzionalità di intelligenza artificiale generativa.

11. (Facoltativo) Aggiungi un campo personalizzato esistente o crea un nuovo campo personalizzato. I problemi possono avere più campi personalizzati.

    1. Per aggiungere un campo personalizzato esistente, scegli il campo personalizzato dall'elenco. Puoi inserire un termine di ricerca nel campo per cercare tutti i campi personalizzati contenenti quel termine nel progetto.

    2. Per creare un nuovo campo personalizzato e aggiungerlo, inserisci il nome del campo personalizzato che desideri creare nel campo di ricerca e premi invio. Quindi scegli il tipo di campo personalizzato che desideri creare e imposta un valore.

12. Scegli Crea problema. Nell'angolo in basso a destra viene visualizzata una notifica: se il problema è stato creato correttamente, viene visualizzato un messaggio di conferma che indica che il problema è stato creato correttamente. Se il problema non è stato creato correttamente, viene visualizzato un messaggio di errore con il motivo dell'errore. Puoi quindi scegliere Riprova per modificare e riprova a creare il problema oppure scegliere Ignora per eliminare il problema. Entrambe le opzioni annulleranno la notifica.

    Nota

    Non è possibile collegare una pull request a un problema al momento della creazione. Tuttavia, puoi modificarla dopo averla creata per aggiungere link alle richieste pull.

Procedure consigliate per la creazione e l'utilizzo di problemi assegnati ad Amazon Q

Quando crei problemi, a volte alcuni persistono. Le cause di ciò possono essere complesse e variabili. A volte è perché non è chiaro chi debba lavorarci. Altre volte il problema richiede ricerche o competenze su una parte particolare del codice base e i migliori candidati per il lavoro sono impegnati con altre questioni. Spesso ci sono altri lavori urgenti da sbrigare prima. Alcune o tutte queste cause possono causare problemi irrisolti. CodeCatalyst include l'integrazione con un assistente AI generativo chiamato Amazon Q in grado di analizzare un problema in base al titolo e alla descrizione. Se assegni il problema ad Amazon Q, quest'ultima tenterà di creare una bozza di soluzione da valutare. Questo può aiutare te e il tuo team a concentrarti e ottimizzare il lavoro su questioni che richiedono la tua attenzione, mentre Amazon Q lavora a una soluzione per i problemi che non hai risorse per risolvere immediatamente.

Nota

Nota

Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi. Poiché le funzioni Scrivi descrizione per me, Crea un riepilogo dei contenuti, Consiglia attività, Usa Amazon Q per creare o aggiungere funzionalità a un progetto e Assegna problemi ad Amazon Q con Amazon Q Developer Agent per le funzionalità di sviluppo software sono basate su Amazon Bedrock, gli utenti possono sfruttare appieno i controlli implementati in Amazon Bedrock per rafforzare la sicurezza e l'uso responsabile dell'intelligenza artificiale (AI).

Amazon Q offre le migliori prestazioni su problemi semplici e diretti. Per ottenere i migliori risultati, usa un linguaggio semplice per spiegare chiaramente cosa vuoi fare. Di seguito sono riportate alcune best practice per aiutarti a creare problemi ottimizzati per Amazon Q su cui lavorare.

Importante

Le funzionalità di intelligenza artificiale generativa sono disponibili solo nella regione Stati Uniti occidentali (Oregon).

• Mantieni la semplicità. Amazon Q fa meglio con semplici modifiche e correzioni al codice, che possono essere spiegate nel titolo e nella descrizione del problema. Non assegnare problemi con titoli vaghi o descrizioni eccessivamente esagerate o contraddittorie.

• Sii specifico. Più informazioni puoi fornire sulle modifiche esatte necessarie per risolvere il problema, più è probabile che Amazon Q sia in grado di creare una soluzione che risolva il problema. Se possibile, includi dettagli specifici come il nome che APIs desideri modificare, i metodi che desideri aggiornare, i test che richiedono modifiche e qualsiasi altro dettaglio che ti viene in mente.

• Assicurati di avere tutti i dettagli inclusi nel titolo e nella descrizione del problema prima di assegnarlo ad Amazon Q. Non puoi modificare il titolo o la descrizione di un problema dopo averlo assegnato ad Amazon Q, quindi assicurati di disporre di tutte le informazioni necessarie per un problema prima di assegnarlo ad Amazon Q.

• Assegna solo i problemi che richiedono modifiche al codice in un unico repository di origine. Amazon Q può funzionare solo sul codice in un unico repository di origine in CodeCatalyst. I repository collegati non sono supportati. Assicurati che il problema richieda solo modifiche in un unico repository di origine prima di assegnarlo ad Amazon Q.

• Utilizza l'impostazione predefinita suggerita da Amazon Q per l'approvazione di ogni passaggio. Per impostazione predefinita, Amazon Q richiederà la tua approvazione per ogni passaggio necessario. Ciò ti consente di interagire con Amazon Q nei commenti non solo sul problema, ma anche su qualsiasi pull request creata. Ciò offre un'esperienza più interattiva con Amazon Q che ti aiuta a modificare il suo approccio e perfezionare il codice che crea per risolvere il problema.

  Nota

  Amazon Q non risponde ai singoli commenti nei problemi o nelle pull request, ma li esaminerà quando gli verrà chiesto di riconsiderare il suo approccio o di creare una revisione.

• Esamina sempre attentamente l'approccio suggerito da Amazon Q. Una volta approvato l'approccio, Amazon Q inizierà a generare codice basato su tale approccio. Assicurati che l'approccio sembri corretto e includa tutti i dettagli previsti prima di dire ad Amazon Q di procedere.

• Assicurati di consentire ad Amazon Q di lavorare sui flussi di lavoro solo se non disponi di flussi di lavoro esistenti che potrebbero implementarli prima che vengano esaminati. Il tuo progetto potrebbe avere flussi di lavoro configurati per avviare esecuzioni in base a eventi di pull request. In tal caso, qualsiasi richiesta pull creata da Amazon Q che includa la creazione o l'aggiornamento del flusso di lavoro YAML potrebbe avviare un'esecuzione dei flussi di lavoro inclusi nella richiesta pull. Come best practice, non scegliere di consentire ad Amazon Q di lavorare su file di workflow a meno che tu non sia sicuro che nel tuo progetto non ci siano flussi di lavoro che eseguano automaticamente tali flussi di lavoro prima di rivedere e approvare la pull request creata.

Per ulteriori informazioni, consulta Gestione delle funzionalità di Tutorial: Utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo intelligenza artificiale generativa.