Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub

Nota

Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Puoi utilizzare Amazon Q Developer in GitHub per semplificare lo sviluppo implementando automaticamente nuove funzionalità e correzioni di bug, trasferendo le attività dall’idea alla richiesta pull completata. Quando aggiungi l’etichetta di sviluppo della funzionalità a un problema o utilizzi il comando slash /q dev, Amazon Q Developer utilizza il problema, inclusi il titolo e la descrizione, nonché il codice del repository come contesto per generare nuove correzioni al codice e creare una richiesta pull. Nella richiesta pull, puoi fornire feedback e Amazon Q Developer esegue le iterazioni sul codice suggerito.

Puoi fare in modo che Amazon Q Developer esegua lo sviluppo di funzionalità un numero limitato di volte al mese. Puoi aumentare l'utilizzo gratuito in qualsiasi momento registrando l'installazione dell'app Amazon Q Developer con il tuo AWS account. Per ulteriori informazioni, consulta Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer.

Importante

L'app Amazon Q Developer tenta di creare automaticamente l'etichetta dell'agente di sviluppo Amazon Q nei GitHub repository a cui autorizzi l'accesso. Se l'etichetta non viene creata automaticamente o se viene eliminata involontariamente, puoi crearla manualmente. GitHub L'etichetta deve essere denominata agente di sviluppo Amazon Q per poter essere riconosciuta ed elaborata come etichetta Amazon Q Developer. Per ulteriori informazioni, consulta Creating a label nella documentazione di GitHub.

Per utilizzare Amazon Q Developer per lo sviluppo di funzionalità

1. Se necessario, accedi al tuo account GitHub utilizzando le credenziali GitHub.

2. Accedi alla tua GitHub organizzazione, quindi vai al repository in cui desideri implementare nuove funzionalità con Amazon Q Developer.

3. Scegli Problemi, quindi crea un nuovo problema o scegli un problema esistente. Per ulteriori informazioni, consulta Create an issue nella documentazione di GitHub.

   1. Per un nuovo problema, nel campo di immissione del testo Aggiungi un titolo, inserisci un titolo che fornisca un contesto ad Amazon Q Developer per lo sviluppo di funzionalità (esempio: “Crea un’app di riconoscimento delle immagini”). È inoltre necessario includere la descrizione del problema in quanto fornisce anche un contesto.

      Per un problema esistente, puoi modificare il titolo e la descrizione del problema per fornire un contesto ad Amazon Q Developer per lo sviluppo delle funzionalità. Per ulteriori informazioni, consulta Editing an issue nella documentazione GitHub.

4. Quando crei un problema o configuri un problema esistente, puoi applicare l’etichetta Amazon Q Developer per lo sviluppo di funzionalità o utilizzare il comando slash /q dev. Esegui una di queste operazioni:

   • Per applicare l’etichetta al problema, procedi in uno dei seguenti modi:

     • Scegli il menu a discesa Assegna ad Amazon Q fornito come estensione del browser, quindi scegli l’etichetta agente di sviluppo Amazon Q.

     • Nel menu a destra, scegli Etichette, quindi scegli l’etichetta agente di sviluppo Amazon Q.

   • Per utilizzare il comando slash /q dev in un commento:

     1. All’interno del problema, vai su Aggiungi un commento e nel campo di immissione del testo del commento, inserisci /q dev.

     2. Scegliere Comment (Commento).

5. Per un nuovo problema, scegli Crea problema per completare la creazione del problema con i dettagli necessari per consentire ad Amazon Q Developer di sviluppare le funzionalità. Se configuri un problema esistente, assicurati di salvare le modifiche. Per ulteriori informazioni, consulta Editing an issue nella documentazione GitHub.

   Quando Amazon Q Developer termina di generare modifiche al codice per lo sviluppo delle funzionalità, commenta il problema e apre una richiesta pull.

6. Vai al commento lasciato da Amazon Q Developer (esempio: “I finished generating the proposed code changes and opened a pull request: Resolve Create an image recognition app“), quindi scegli il link della richiesta pull.

   Puoi anche accedere alla scheda Richiesta pull e quindi scegliere la richiesta pull creata da Amazon Q Developer.

7. Scegli la scheda File modificati per visualizzare le modifiche al codice.

8. Se le modifiche al codice suggerite ti soddisfano, puoi unire la richiesta pull. Per ulteriori informazioni, consulta Merge a pull request.

Puoi anche esaminare la richiesta pull per lo sviluppo della funzionalità e iterare sulle modifiche al codice suggerite fornendo feedback ad Amazon Q Developer.

Per iterare sul codice di sviluppo delle funzionalità di Amazon Q Developer

1. Scegli la richiesta pull creata da Amazon Q Developer, quindi scegli la scheda File modificati per visualizzare le modifiche al codice.

2. Per la riga di codice per cui desideri lasciare un feedback e far eseguire l’iterazione ad Amazon Q Developer, scegli + per aggiungere un commento con feedback, quindi scegli Inizia una revisione.

   Dopo aver inviato la revisione, Amazon Q Developer inizia a esaminare il codice in base al tuo feedback. Quando Amazon Q Developer ha finito di rivedere il tuo feedback, inserisce le modifiche nella richiesta pull e ti aggiorna con un commento.

3. Scegli Termina la revisione, scegli il pulsante di opzione Richiedi modifiche, quindi scegli Invia revisione per far esaminare il tuo feedback.

4. Se le modifiche al codice aggiornate ti soddisfano, puoi unire la richiesta pull o iterare il codice con un nuovo feedback. Per ulteriori informazioni, consulta Merge a pull request.

Amazon Q Developer si integra con i flussi di lavoro GitHub Actions per creare un sistema di ciclo di feedback intelligente. Quando viene creata una richiesta pull, i flussi di lavoro configurati, come i test di unità, vengono eseguiti automaticamente. Se il flusso di lavoro non riesce, Amazon Q Developer analizza l’output e, in base ai risultati e alle informazioni sull’errore, esegue un’iterazione sulle modifiche al codice. Man mano che le modifiche al codice vengono inviate e i flussi di lavoro vengono eseguiti, Amazon Q Developer interpreta i risultati e utilizza queste informazioni per perfezionare il suo approccio. Questa modalità crea un ciclo di apprendimento continuo in cui ogni iterazione si basa sui tentativi precedenti e Amazon Q Developer è in grado di far evolvere le sue soluzioni.

L’efficacia di un ciclo di feedback dipende dalla disponibilità di test e flussi di lavoro ben definiti che forniscano un feedback significativo ad Amazon Q Developer affinché lo interpreti e agisca di conseguenza. Puoi configurare i flussi di lavoro utilizzando i file YAML di GitHub Actions nel tuo repository, consentendo processi di test e convalida personalizzati a cui Amazon Q Developer può rispondere. Per ulteriori informazioni, consulta Understanding GitHub Actions nella documentazione GitHub.